Agent Management12

Agent Operations13

API Tokens4

Cards6

Contact Verification4

Cross-Currency Transfers6

Customers9

Discoveries1

Documents5

Embedded Wallet Auth12

Exchange Rates1

External Accounts12

Internal Accounts5

Invitations4

KYC/KYB Verifications9

Platform Configuration2

Same-Currency Transfers2

Sandbox20

Stablecoins12

Strong Customer Authentication16

Transactions6

Webhooks

Webhooks13

Cards

List cards

Changed on Sep 15, 2026

Retrieve a paginated list of cards. Cards can be filtered by cardholder, bound funding-source internal account, status, and platform-specific card identifier. If no filters are provided, returns all cards visible to the caller.

get/cards

Request

Base URL: https://api.lightspark.com/grid/2025-10-13
URL: https://api.lightspark.com/grid/2025-10-13/cards
Auth: HTTP basic

Query parameters

customerIdstring

Filter by customer id.

accountIdstring

Filter by internal account id. Returns cards whose fundingSource is the given internal account id.

platformCardIdstring

Filter by platform-specific card identifier.

status'PENDING_KYC' | 'PROCESSING' | 'ACTIVE' | 'FROZEN' | 'CLOSED'

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.
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.

Filter by card status.

limitinteger

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

cursorstring

Cursor for pagination (returned from previous request)

sortOrder'asc' | 'desc'

Order to sort results in

Response

Successful operation

hasMoreboolean required

Indicates if more results are available beyond this page

nextCursorstring

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

totalCountinteger

Total number of cards matching the criteria (excluding pagination)

Example response

{
  "data": [
    {
      "id": "Card:019542f5-b3e7-1d02-0000-000000000010",
      "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
      "platformCardId": "card-emp-001",
      "last4": "4242",
      "expMonth": 12,
      "expYear": 2029,
      "fundingSource": "InternalAccount:019542f5-b3e7-1d02-0000-000000000002",
      "cardCapabilities": {
        "supportsSpendLimits": true,
        "supportsSpendLimitsAtIssuance": true,
        "supportsTransactionCountLimit": true,
        "supportsPanReveal": true,
        "supportsDigitalWalletTokenization": true
      },
      "maxSpendPerTransaction": 5000,
      "maxSpendPerDay": 25000,
      "maxTransactionsPerDay": 20,
      "currency": "USD",
      "processorRef": "card_b81c2a4f",
      "issuerRef": "lead_card_7a1b9c3d",
      "createdAt": "2026-05-08T14:10:00Z",
      "updatedAt": "2026-05-08T14:11:00Z"
    }
  ]
}

Changes

Sep 15, 20260bea6bdd0b0b Revision changes
- info
  added the required property /// to the response with the status
Sep 15, 20263966e5d38aad Revision changes
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- warning
  added the new INSUFFICIENT_FUNDS enum value to the response property for the response status
- warning
  added the new QUOTE_EXPIRED enum value to the response property for the response status
- warning
  added the new QUOTE_RATE_UNAVAILABLE enum value to the response property for the response status
- warning
  added the new STABLECOIN_AMOUNT_NOT_REPRESENTABLE enum value to the response property for the response status
- warning
  added the new STABLECOIN_BURN_SOURCE_NOT_SUPPORTED enum value to the response property for the response status
- warning
  added the new STABLECOIN_EXTERNAL_ACCOUNT_LINK_FAILED enum value to the response property for the response status
- warning
  added the new STABLECOIN_EXTERNAL_ACCOUNT_LINK_METHOD_REQUIRED enum value to the response property for the response status
- warning
  added the new STABLECOIN_EXTERNAL_ACCOUNT_NOT_LINKED enum value to the response property for the response status
- warning
  added the new STABLECOIN_EXTERNAL_ACCOUNT_NOT_SUPPORTED enum value to the response property for the response status
- warning
  added the new STABLECOIN_EXTERNAL_ACCOUNT_PROVIDER_LINK_FAILED enum value to the response property for the response status
- warning
  added the new STABLECOIN_EXTERNAL_ACCOUNT_PROVIDER_LINK_REQUIRED enum value to the response property for the response status
- warning
  added the new STABLECOIN_GRID_OPERATIONS_NOT_ENABLED enum value to the response property for the response status
- warning
  added the new STABLECOIN_NOT_PROVISIONED enum value to the response property for the response status
- warning
  added the new STABLECOIN_OPERATION_NOT_SUPPORTED enum value to the response property for the response status
- warning
  added the new STABLECOIN_PROVIDER_ERROR enum value to the response property for the response status
- warning
  added the new STABLECOIN_PROVIDER_SOURCE_NOT_LINKED enum value to the response property for the response status
- warning
  added the new STABLECOIN_VERIFICATION_FAILED enum value to the response property for the response status
- warning
  added the new UNRECOGNIZED_MANDATORY_COUNTERPARTY_DATA_KEY enum value to the response property for the response status
- info
  added the required property /// to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history (13 revisions)