> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reap.global/llms.txt
> Use this file to discover all available pages before exploring further.

# List mandates

> Lists the mandates of a single owner. `ownerId` is required, and a list is always scoped to exactly one owner.

Required scope: [AGENTIC\_READ](https://docs.reap.global/api-reference/scopes.md)


## OpenAPI

````yaml /api-reference/openapi.json get /agentic/mandates
openapi: 3.1.0
info:
  title: Reap API
  version: 1.0.0
  description: Reap platform API
servers:
  - url: https://sg.sandbox.api.reap.global
    description: Singapore sandbox
  - url: https://sg.prod.api.reap.global
    description: Singapore production
  - url: https://mx.sandbox.api.reap.global
    description: Mexico sandbox
  - url: https://mx.prod.api.reap.global
    description: Mexico production
  - url: https://sandbox.api.reap.global
    description: Singapore sandbox (alias)
  - url: https://prod.api.reap.global
    description: Singapore production (alias)
security:
  - bearerAuth: []
tags:
  - name: Accounts
  - name: Activities
  - name: Card Designs
  - name: Card Shipments
  - name: Card Transactions
  - name: Cards
  - name: Companies
  - name: Crypto Deposits
  - name: Crypto Withdrawals
  - name: Disputes
  - name: Fees
  - name: Fiat Deposits
  - name: Fraud Alerts
  - name: Policies
  - name: Simulation
  - name: Statements
  - name: Users
  - name: Virtual Asset Postings
  - name: Virtual Assets
  - name: Webhooks
  - name: Agentic
paths:
  /agentic/mandates:
    get:
      tags:
        - Agentic
      summary: List mandates
      description: >-
        Lists the mandates of a single owner. `ownerId` is required, and a list
        is always scoped to exactly one owner.
      operationId: listMandates_agentic
      parameters:
        - name: ownerType
          in: query
          required: false
          schema:
            default: CLIENT_REFERENCE
            type: string
            enum:
              - REAP_USER
              - CLIENT_REFERENCE
            example: REAP_USER
        - name: ownerId
          in: query
          required: true
          schema:
            type: string
            minLength: 1
        - name: enrollmentId
          in: query
          required: false
          schema:
            type: string
            format: uuid
        - name: status
          in: query
          required: false
          schema:
            description: >-
              Filter by mandate status (comma-separated). Defaults to `ACTIVE`;
              pass an explicit value to include other statuses.
            type: array
            items:
              type: string
              enum:
                - REQUIRES_ACTION
                - ACTIVE
                - PAUSED
                - CONSUMED
                - EXPIRED
                - FAILED
                - CANCELLED
                - REVOKED
              example: REQUIRES_ACTION
        - name: limit
          in: query
          required: false
          schema:
            default: 20
            description: Maximum number of mandates to return
            type: integer
            minimum: 1
            maximum: 100
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            minLength: 1
        - name: Reap-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2025-02-14'
            description: API version (YYYY-MM-DD)
            example: '2025-02-14'
        - name: Reap-Subproject-Id
          in: header
          required: false
          schema:
            description: >-
              Selects the subproject the request operates on; only accepted with
              a parent project credential.
            type: string
            format: uuid
      responses:
        '200':
          description: Response for status 200
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        status:
                          type: string
                          enum:
                            - REQUIRES_ACTION
                            - ACTIVE
                            - PAUSED
                            - CONSUMED
                            - EXPIRED
                            - FAILED
                            - CANCELLED
                            - REVOKED
                          example: REQUIRES_ACTION
                        enrollmentId:
                          type: string
                          format: uuid
                        owner:
                          type: object
                          properties:
                            type:
                              type: string
                              enum:
                                - REAP_USER
                                - CLIENT_REFERENCE
                              example: REAP_USER
                            id:
                              type: string
                              minLength: 1
                          required:
                            - type
                            - id
                        frequency:
                          type: string
                          enum:
                            - ONE_TIME
                            - WEEKLY
                            - MONTHLY
                            - YEARLY
                          example: ONE_TIME
                        amount:
                          type: object
                          properties:
                            amount:
                              type: number
                            currency:
                              type: string
                              minLength: 3
                              maxLength: 3
                          required:
                            - amount
                            - currency
                        merchant:
                          type: object
                          properties:
                            url:
                              type: string
                            name:
                              type: string
                            domain:
                              type: string
                            country:
                              type: string
                              minLength: 2
                              maxLength: 2
                          required:
                            - url
                            - name
                            - domain
                            - country
                        validUntil:
                          anyOf:
                            - type: string
                              format: date-time
                            - type: 'null'
                        usage:
                          type: object
                          properties:
                            spent:
                              type: number
                            pending:
                              type: number
                            remaining:
                              type:
                                - number
                                - 'null'
                            cycle:
                              anyOf:
                                - type: object
                                  properties:
                                    renewsAt:
                                      type: string
                                      format: date-time
                                  required:
                                    - renewsAt
                                - type: 'null'
                            unresolvedCheckoutId:
                              anyOf:
                                - type: string
                                  format: uuid
                                - type: 'null'
                          required:
                            - spent
                            - pending
                            - remaining
                            - cycle
                            - unresolvedCheckoutId
                        nextAction:
                          anyOf:
                            - type: object
                              properties:
                                type:
                                  type: string
                                  enum:
                                    - REDIRECT
                                  example: REDIRECT
                                url:
                                  type: string
                                  format: uri
                                expiresAt:
                                  type: string
                                  format: date-time
                              required:
                                - type
                                - url
                              title: Redirect
                            - type: 'null'
                        createdAt:
                          type: string
                          format: date-time
                        updatedAt:
                          type: string
                          format: date-time
                      required:
                        - id
                        - status
                        - enrollmentId
                        - owner
                        - frequency
                        - amount
                        - merchant
                        - validUntil
                        - usage
                        - nextAction
                        - createdAt
                        - updatedAt
                  nextCursor:
                    type:
                      - string
                      - 'null'
                required:
                  - items
                  - nextCursor
        '400':
          description: The request was rejected
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        const: AGENTIC_REQUEST_REJECTED
                      message:
                        type: string
                      detail:
                        type: 'null'
                    required:
                      - code
                      - message
                      - detail
                required:
                  - error
                title: AgenticRequestRejectedError
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        const: AGENTIC_RESOURCE_NOT_FOUND
                      message:
                        type: string
                      detail:
                        anyOf:
                          - type: object
                            additionalProperties: {}
                          - type: 'null'
                    required:
                      - code
                      - message
                      - detail
                required:
                  - error
                title: AgenticResourceNotFoundError
        '503':
          description: Agentic Payments is temporarily unavailable
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        const: AGENTIC_SERVICE_UNAVAILABLE
                      message:
                        type: string
                      detail:
                        anyOf:
                          - type: object
                            additionalProperties: {}
                          - type: 'null'
                    required:
                      - code
                      - message
                      - detail
                required:
                  - error
                title: AgenticServiceUnavailableError
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key as Bearer token

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.