Coinbase Mandates API

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.

GitHub OpenAPI
Business capability
Blockchain & Digital Assets AE-240

Operations 12

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v2/mandates Create a mandate · Create a mandate #
Ask an LLM
“How do I create a mandate that caps monthly debits?”
“Can I set an expiry date on a new mandate?”
Tell an agent
Create a {asset} mandate with policy {policy}.
Create a {asset} mandate that expires at {expiresAt}.
GET /v2/mandates List mandates · List mandates #
Ask an LLM
“Which mandates have I created that are still pending approval?”
“Can I filter mandates by the customer's wallet address and network?”
Tell an agent
List my mandates with status {status}.
Show mandates for the wallet address {address} on {network}.
GET /v2/mandates/{mandateId} Get a mandate · Get a mandate #
Ask an LLM
“What is the current status and policy of a mandate?”
“Which funding source is attached to a mandate?”
Tell an agent
Get mandate {mandateId}.
Show the status and policy of mandate {mandateId}.
POST /v2/mandates/{mandateId}/cancel Cancel a mandate · Cancel a mandate #
Ask an LLM
“How do I cancel a mandate before the customer approves it?”
“Can I record a reason when canceling a mandate?”
Tell an agent destructive · confirm first
Cancel mandate {mandateId}.
Cancel mandate {mandateId} because {reason}.
GET /v2/mandates/{mandateId}/revocations List a mandate's revocations · List mandate revocations #
Ask an LLM
“Has the customer revoked a mandate on-chain?”
“Which revocation attempts have been made on a mandate?”
Tell an agent
List revocations for mandate {mandateId}.
Show the latest {pageSize} revocations of mandate {mandateId}.
GET /v2/mandates/{mandateId}/revocations/{revocationId} Get a mandate revocation · Get a mandate revocation #
Ask an LLM
“What happened to a specific revocation of a mandate?”
“Did a particular mandate revocation succeed?”
Tell an agent
Get revocation {revocationId} of mandate {mandateId}.
Show the status of mandate revocation {revocationId} on {mandateId}.
POST /v2/mandates/{mandateId}/revocations/wallet Revoke a mandate with a wallet · Revoke a mandate with a wallet #
Ask an LLM
“How does a customer remove a mandate's spending allowance on-chain?”
“Can I pass a reason when revoking a mandate with a wallet?”
Tell an agent destructive · confirm first
Revoke mandate {mandateId} using revocation option {optionId} and payloads {signedPayloads}.
Revoke mandate {mandateId} with option {optionId}, payloads {signedPayloads} and reason {reason}.
GET /v2/mandates/{mandateId}/revocations/wallet/options Get payloads to revoke a mandate · Get wallet revocation options #
Ask an LLM
“What must a customer sign to remove a mandate's spending allowance?”
“Can I get revocation payloads for a mandate while its allowance is still live?”
Tell an agent
Get revocation payloads for mandate {mandateId}.
Show the customer the signing payloads needed to revoke {mandateId}.
GET /v2/mandates/{mandateId}/approvals List a mandate's approval attempts · List mandate approvals #
Ask an LLM
“Has the customer attached a funding source to a mandate?”
“Why is a mandate still pending approval?”
Tell an agent
List approval attempts for mandate {mandateId}.
Show the latest {pageSize} approvals of mandate {mandateId}.
GET /v2/mandates/{mandateId}/approvals/{approvalId} Get a mandate approval attempt · Get a mandate approval #
Ask an LLM
“Did a particular mandate approval succeed?”
“What error did a failed mandate approval return?”
Tell an agent
Get approval {approvalId} of mandate {mandateId}.
Show the status and transactions of mandate approval {approvalId} on {mandateId}.
POST /v2/mandates/{mandateId}/approvals/wallet Approve a mandate with a wallet · Approve a mandate with a wallet #
Ask an LLM
“How does a customer attach a wallet to a mandate?”
“Can I pass metadata when approving a mandate with a wallet?”
Tell an agent
Approve mandate {mandateId} using approval option {optionId} and payloads {signedPayloads}.
Approve mandate {mandateId} with option {optionId}, payloads {signedPayloads} and metadata {metadata}.
GET /v2/mandates/{mandateId}/approvals/wallet/options Get wallet approval options for a mandate · Get wallet approval options #
Ask an LLM
“Which wallet addresses can a customer use to approve a mandate?”
“Can I filter mandate approval options by asset?”
Tell an agent
Get approval options for mandate {mandateId} from addresses {addresses}.
Show {asset} approval options for mandate {mandateId} on {addresses} on {network}.

Documentation

Specifications

Schemas & Data

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/coinbase:coinbase-mandates-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

coinbase-mandates-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Coinbase Developer Platform Mandates API
  description: The Coinbase Developer Platform APIs - leading the world's transition onchain.
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  version: 2.0.0
  contact:
    name: Coinbase Developer Platform
    email: cdp@coinbase.com
    url: https://cdp.coinbase.com
servers:
- url: https://api.cdp.coinbase.com/platform
  description: The production server of the CDP APIs.
security:
- apiKeyAuth: []
tags:


# --- truncated at 32 KB (205 KB total) ---
# Full source: https://artifacts.apis.io/coinbase/openapi/coinbase-mandates-api-openapi.yml