# Coinbase Mandates API **Canonical:** https://apis.io/apis/coinbase/coinbase-mandates-api/ **Provider:** Coinbase — https://apis.io/providers/coinbase/ **Base URL:** https://api.coinbase.com **Documentation:** https://www.coinbase.com/developer-platform/products/wallet-sdk Coinbase Mandates API is one of 52 APIs that [Coinbase](https://apis.io/providers/coinbase/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 12 JSON Schema definitions. Tagged areas include Mandates. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, and 12 JSON Schemas. A mandate is a durable, revocable standing authorization to debit a funding `source`. It lets a merchant debit the same source repeatedly without the customer present, which suits recurring payments and usage-based billing. A mandate does not move funds itself; a payment session authorizes against it via **Authorize a payment session with a mandate**, and capture, void, and refund then work as they do for any other session. For the full flow, spending limits, and integration options, see the [Recurring Payments guide](https://docs.cdp.coinbase.com/payments/payment-acceptance/recurring-payments). Access to the Mandates APIs requires enablement by Coinbase. **Who does what.** Approving a mandate and revoking its on-chain spending allowance are customer-initiated: the customer signs the payload, so **Approve a mandate with a wallet** and **Revoke a mandate with a wallet** are unauthenticated. Creating, canceling, and reading mandates are merchant actions authenticated with your API key. **Canceling vs. revoking.** These are independent. **Cancel a mandate** is an off-chain merchant action and does not touch the on-chain allowance (`canceledAt` is set). **Revoke a mandate with a wallet** removes the on-chain allowance (`revokedAt` is set). A `canceled` mandate can still have a live allowance until the customer revokes it. `status` records only the most recent transition; the timestamps are the durable record. ## Operations (12) | Method | Path | Summary | |---|---|---| | POST | `/v2/mandates` | Create a mandate | | GET | `/v2/mandates` | List mandates | | GET | `/v2/mandates/{mandateId}` | Get a mandate | | POST | `/v2/mandates/{mandateId}/cancel` | Cancel a mandate | | GET | `/v2/mandates/{mandateId}/revocations` | List mandate revocations | | GET | `/v2/mandates/{mandateId}/revocations/{revocationId}` | Get a mandate revocation | | POST | `/v2/mandates/{mandateId}/revocations/wallet` | Revoke a mandate with a wallet | | GET | `/v2/mandates/{mandateId}/revocations/wallet/options` | Get wallet revocation options | | GET | `/v2/mandates/{mandateId}/approvals` | List mandate approvals | | GET | `/v2/mandates/{mandateId}/approvals/{approvalId}` | Get a mandate approval | | POST | `/v2/mandates/{mandateId}/approvals/wallet` | Approve a mandate with a wallet | | GET | `/v2/mandates/{mandateId}/approvals/wallet/options` | Get wallet approval options | ## Machine-readable artifacts (21) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/openapi/coinbase-mandates-api-openapi.yml - **Documentation** — https://docs.cdp.coinbase.com/coinbase-app/advanced-trade-apis/rest-api - **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/asyncapi/coinbase-advanced-trade-asyncapi.yml - **Documentation** — https://docs.cdp.coinbase.com/exchange/docs/welcome - **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/asyncapi/coinbase-exchange-asyncapi.yml - **Documentation** — https://docs.cdp.coinbase.com/prime/docs/rest-requests - **Documentation** — https://docs.cdp.coinbase.com/onramp/docs/welcome - **Documentation** — https://commerce.coinbase.com/docs/api - **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/asyncapi/coinbase-commerce-webhooks-asyncapi.yml - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-conversion-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-currency-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-payment-method-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-transfer-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-transaction-summary-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-price-book-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-product-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-candle-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-trade-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-order-book-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-trade-2-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-profile-schema.json ## Other Coinbase APIs (12) - [Coinbase Wallet SDK](https://apis.io/apis/coinbase/wallet-sdk/) - [Coinbase Data API](https://apis.io/apis/coinbase/data-api/) - [Coinbase AgentKit](https://apis.io/apis/coinbase/agentkit/) - [Coinbase Accounts API](https://apis.io/apis/coinbase/coinbase-accounts-api/) - [Coinbase Activities API](https://apis.io/apis/coinbase/coinbase-activities-api/) - [Coinbase Address Book API](https://apis.io/apis/coinbase/coinbase-address-book-api/) - [Coinbase Allocations API](https://apis.io/apis/coinbase/coinbase-allocations-api/) - [Coinbase Assets API](https://apis.io/apis/coinbase/coinbase-assets-api/) - [Coinbase Balances API](https://apis.io/apis/coinbase/coinbase-balances-api/) - [Coinbase Buy API](https://apis.io/apis/coinbase/coinbase-buy-api/) - [Coinbase Charges API](https://apis.io/apis/coinbase/coinbase-charges-api/) - [Coinbase Checkouts API](https://apis.io/apis/coinbase/coinbase-checkouts-api/) ## Tags Mandates --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/coinbase/coinbase-mandates-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/coinbase/.