Skip to main content
GET
Get agent card

Authorizations

Authorization
string
header
required

Bearer token authentication for agent-scoped endpoints. The token is the accessToken returned when redeeming a device code via POST /agents/device-codes/redeem. Agent credentials are user-scoped: all requests are automatically bound to the agent's associated customer and subject to the agent's policy.

Path Parameters

cardId
string
required

Unique identifier of the card

Response

Successful operation

A card that belongs to the authenticated agent: the card itself and how the agent may use it.

card
object
required
agentId
string
required

The agent the card belongs to.

Example:

"Agent:019542f5-b3e7-1d02-0000-000000000042"

agentCardKind
enum<string>
required

How an agent card is used and funded.

Available options:
STANDARD
effectiveBlockedMccs
string[]
required

Every merchant category code the card declines: blockedMccs plus the categories Grid blocks for agent cards, unless the platform lifted those defaults (defaultMccBlocksLifted).

Pattern: ^[0-9]{4}$
Example: