List agent cards

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.lightspark.com/grid/2025-10-13/agents/me/cards', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.lightspark.com/grid/2025-10-13/agents/me/cards")
  .get()
  .addHeader("Authorization", "Bearer <token>")
  .build()

val response = client.newCall(request).execute()

{
  "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",
        "maxSpendPerTransaction": 5000,
        "maxSpendPerDay": 25000,
        "maxTransactionsPerDay": 20,
        "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": {
          "supportsSpendLimits": true,
          "supportsSpendLimitsAtIssuance": true,
          "supportsTransactionCountLimit": true,
          "supports3dSecurePassword": false,
          "supportsPanReveal": true,
          "supportsDigitalWalletTokenization": true
        },
        "allowedMccs": [
          "5411"
        ],
        "blockedMccs": [
          "7995"
        ],
        "agentId": "Agent:019542f5-b3e7-1d02-0000-000000000042",
        "defaultMccBlocksLifted": false,
        "currency": "USD",
        "processorRef": "card_b81c2a4f",
        "issuerRef": "lead_card_7a1b9c3d"
      },
      "agentId": "Agent:019542f5-b3e7-1d02-0000-000000000042",
      "agentCardKind": "STANDARD",
      "effectiveBlockedMccs": [
        "7995",
        "6051"
      ],
      "spendLimit": {
        "amount": 2300,
        "duration": "TRANSACTION"
      },
      "reservedAmount": 2300,
      "expiresAt": "2026-10-10T15:30:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "Card:019542f5-b3e7-1d02-0000-000000000010",
  "totalCount": 3
}

{
  "code": "UNAUTHORIZED",
  "reason": "<string>",
  "details": {}
}

{
  "code": "FORBIDDEN",
  "reason": "<string>",
  "details": {}
}

{
  "code": "GRID_SWITCH_ERROR",
  "reason": "<string>",
  "details": {}
}

GET

agents

cards

List agent cards

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.lightspark.com/grid/2025-10-13/agents/me/cards', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.lightspark.com/grid/2025-10-13/agents/me/cards")
  .get()
  .addHeader("Authorization", "Bearer <token>")
  .build()

val response = client.newCall(request).execute()

{
  "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",
        "maxSpendPerTransaction": 5000,
        "maxSpendPerDay": 25000,
        "maxTransactionsPerDay": 20,
        "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": {
          "supportsSpendLimits": true,
          "supportsSpendLimitsAtIssuance": true,
          "supportsTransactionCountLimit": true,
          "supports3dSecurePassword": false,
          "supportsPanReveal": true,
          "supportsDigitalWalletTokenization": true
        },
        "allowedMccs": [
          "5411"
        ],
        "blockedMccs": [
          "7995"
        ],
        "agentId": "Agent:019542f5-b3e7-1d02-0000-000000000042",
        "defaultMccBlocksLifted": false,
        "currency": "USD",
        "processorRef": "card_b81c2a4f",
        "issuerRef": "lead_card_7a1b9c3d"
      },
      "agentId": "Agent:019542f5-b3e7-1d02-0000-000000000042",
      "agentCardKind": "STANDARD",
      "effectiveBlockedMccs": [
        "7995",
        "6051"
      ],
      "spendLimit": {
        "amount": 2300,
        "duration": "TRANSACTION"
      },
      "reservedAmount": 2300,
      "expiresAt": "2026-10-10T15:30:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "Card:019542f5-b3e7-1d02-0000-000000000010",
  "totalCount": 3
}

{
  "code": "UNAUTHORIZED",
  "reason": "<string>",
  "details": {}
}

{
  "code": "FORBIDDEN",
  "reason": "<string>",
  "details": {}
}

{
  "code": "GRID_SWITCH_ERROR",
  "reason": "<string>",
  "details": {}
}

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 the customer issued for the agent on the platform. The customer holds the card details and its spend is the customer's own; the agent can read it, tighten its limits, and freeze it.
`SINGLE_USE`	A purchase card the agent issued for one purchase. Its spend is reserved against the agent's policy at issuance and the card closes after its first authorization.
`MERCHANT_LOCKED`	A purchase card the agent issued for repeated purchases at one merchant, such as a subscription, capped by a monthly limit. Each authorization is checked against the agent's policy.

Available options:

STANDARD,

SINGLE_USE,

MERCHANT_LOCKED

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. New authorizations are declined with `cardDeclinedReason: CARD_NOT_ACTIVE`. Existing settlements and refunds continue to reconcile.
`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

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

Using the API

API documentation

List agent cards

Authorizations

Query Parameters

Response