---
title: "List agentic mandates"
method: GET
path: "/agentic-payments/mandates"
tags: ["Agent Tokens"]
---

# List agentic mandates

`GET /agentic-payments/mandates`

## Request

- Base URL: `https://api.natural.com`
- URL: `https://api.natural.com/agentic-payments/mandates`
- Auth: HTTP bearer

List the party's usable mandates for the calling agent, or all of the owner's mandates

## Query parameters

- `customerPartyId` string: Customer party to act for (pty_*). Omit to act as your own party. To act for another party, pass the ID of a party that has authorized you to act on its behalf.
- `limit` integer: Maximum results per page.
- `cursor` string: Cursor from the previous page.

## Headers

- `X-Instance-ID` string, nullable

## Response `200`

Successful Response

- object
  - `data` object[], required
    - `id` string, required
    - `paymentMethodId` string, required
    - `provider` 'basis_theory' | 'simulation', required
    - `agentId` string, nullable, required: The agent reading this mandate. Mandates belong to the card and every agent with access to the card spends under them; null when the card owner reads one.
    - `status` 'creating' | 'reconciliation_required' | 'requires_action' | 'active' | 'revoked' | 'error' | 'outcome_unknown' | 'expired', required
    - `amount` number, required
    - `available` number, required
    - `perPurchaseLimit` number, required
    - `currency` 'USD', required
    - `description` string, required
    - `expiresAt` string, date-time, required
    - `merchantScope` 'any', required
    - `errorCode` string, nullable, required
  - `meta` object, required
    - `pagination` object, required
      - `hasMore` boolean, required: Whether more results are available.
      - `nextCursor` string, nullable, required: Cursor for the next page, or null when there are no more results.

## Other responses

- `400`: Validation Error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found. Returned when the resource does not exist, or when it exists but is not accessible to your account. The two cases are intentionally indistinguishable, so that resource IDs cannot be enumerated by probing.
- `409`: Conflict
- `422`: Validation Error. The response contains one error object for each invalid request value.
- `428`: Precondition Required
- `429`: Too Many Requests
- `500`: Internal Server Error
- `501`: Not Implemented
- `502`: Bad Gateway
- `503`: Service Unavailable

## Changes

- **2026-10-07** `bbac797fe7f1`: 3 info
  - added the new optional `query` request parameter `cursor`
  - added the new optional `query` request parameter `limit`
  - added the required property `meta` to the response with the `200` status
- **2026-10-03** `3f14b9f458e4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/natural/apis/natural-api/changes/agentic-payments/mandates/get.md)

---

[API](https://skmtc.dev/natural/apis/natural-api.md) - [All operations](https://skmtc.dev/natural/apis/natural-api/llms.txt) - [OpenAPI document](https://skmtc.dev/natural/apis/natural-api/revisions/59c1208fa5dc?raw)