List agent cards

List the authenticated agent’s cards: standard cards issued for it and purchase cards it issued. Filter with kind=PURCHASE for purchase cards only. Other cards of the customer are not listed. Requires the MANAGE_CARDS permission.

GET /agents/me/cards

List agent cards

cURL

curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/agents/me/cards \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "card": {
        "id": "Card:019542f5-b3e7-1d02-0000-000000000010",
        "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
        "status": "PENDING_KYC",
        "form": "VIRTUAL",
        "fundingSource": "InternalAccount:019542f5-b3e7-1d02-0000-000000000002",
        "createdAt": "2026-05-08T14:10:00Z",
        "updatedAt": "2026-05-08T14:11:00Z",
        "platformCardId": "card-emp-001",
        "statusReason": "DELEGATION_REQUIRED",
        "brand": "VISA",
        "pinStatus": "OK",
        "pinUnblockAvailableAt": "2026-10-15T15:00:00Z",
        "last4": "4242",
        "expMonth": 12,
        "expYear": 2029,
        "cardCapabilities": {
          "supportsVelocityLimits": true,
          "supports3dSecurePassword": false,
          "supportsPanReveal": true,
          "supportsDigitalWalletTokenization": true
        },
        "maxNetworkRiskScore": 700,
        "allowedMccs": [
          "5411"
        ],
        "blockedMccs": [
          "7995"
        ],
        "agentId": "Agent:019542f5-b3e7-1d02-0000-000000000042",
        "defaultMccBlocksLifted": false,
        "lockedMerchant": {
          "descriptor": "BLUE BOTTLE COFFEE SF",
          "mcc": "5814",
          "city": "San Francisco",
          "state": "CA",
          "country": "US"
        },
        "currency": "USD",
        "processorRef": "card_b81c2a4f",
        "issuerRef": "lead_card_7a1b9c3d"
      },
      "agentId": "Agent:019542f5-b3e7-1d02-0000-000000000042",
      "agentCardKind": "STANDARD",
      "effectiveBlockedMccs": [
        "7995",
        "6051"
      ],
      "actingFor": "member_8f2c1a",
      "purchase": {
        "amount": 4999,
        "spendLimit": 5749,
        "currency": "USD",
        "fundingSource": "InternalAccount:019542f5-b3e7-1d02-0000-000000000002",
        "increaseCardId": "Card:019542f5-b3e7-1d02-0000-000000000011",
        "previousAmount": 4999,
        "previousSpendLimit": 5749,
        "description": "Running shoes from example-store.com",
        "recurring": false,
        "expiresAt": "2026-10-26T15:30:00Z"
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "Card:019542f5-b3e7-1d02-0000-000000000010",
  "totalCount": 3
}

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.

Query Parameters

kind · enum<string>

Filter by card kind How an agent card is used and funded.

Kind	Description
STANDARD	A card issued for the agent, by the platform with POST /cards or by the agent with POST /agents/me/cards. The customer holds the card details and its spend comes from the customer's account; that spend counts against the agent's policy limits as the agent's sends do. The agent can read the card, tighten its merchant categories, and freeze it.
PURCHASE	A single-use virtual card the agent issued for one online purchase with POST /agents/me/cards. It is funded from the customer's Embedded Wallet, its spend counts against the agent's policy limits, and it closes after its first approved authorization or when it expires unused. A recurring purchase card (purchase.recurring) is instead locked to the first merchant that charges it, may be charged there again up to its monthly limit, and stays open until it is closed. The agent reads its number, expiry and CVV through POST /agents/me/cards/{cardId}/reveal.

Available options: STANDARD, PURCHASE

status · enum<string>

Filter by card status Lifecycle status of a card.

Status	Description
PENDING_KYC	The cardholder has not yet completed KYC. Cards in this status cannot transact.
PROCESSING	The card has been requested and is being provisioned with the issuer.
PENDING_AUTH	The issuer has provisioned the card, but its USDB Embedded Wallet funding source lacks an active delegated signing key. Complete POST /auth/delegated-keys before using the card.
ACTIVE	The card is live and can authorize transactions.
FROZEN	The card is temporarily disabled by the platform or by Grid. New authorizations are declined with cardDeclinedReason: CARD_NOT_ACTIVE. Existing settlements and refunds continue to reconcile. A card Grid froze for review, or one frozen as COMPROMISED, cannot be unfrozen by the platform.
CLOSED	The card is permanently closed. Terminal, irreversible status.

Available options: PENDING_KYC, PROCESSING, PENDING_AUTH, ACTIVE, FROZEN, CLOSED

limit · integer · default: 20

Maximum number of results to return (default 20, max 100)

Required range: 1 <= x <= 100

cursor · string

Cursor for pagination (returned from previous request)

Response

200

application/json

Successful operation

data · Agent Card · object[] · required

Cards that belong to the authenticated agent.

Show child attributes

hasMore · boolean · required

Indicates if more results are available beyond this page.

nextCursor · string

Cursor to retrieve the next page of results (only present if hasMore is true).

Example:

"Card:019542f5-b3e7-1d02-0000-000000000010"

totalCount · integer

Total number of cards matching the criteria (excluding pagination).

Example:

3