Balance & Activity

Read your card-program balance and stream the last 30 days of card transactions.

Card balance

Returns the USD balance available to your cards.

GET /v1/cards/balance
x-api-key: dlfy_live_...

{
  "balance": {
    "currency": "USDC",
    "available": "1000.00",
    "pending": "250.00",
    "asOf": "2026-04-08T12:00:00.000Z"
  }
}

available is the amount currently available to spend on cards.
pending is card-program funding that has not yet settled into spending power.
This is the card-program balance only. Your bank wallet balances are not exposed here — see Banking → Balance.

Card activity

Returns a paginated feed of your organization’s card activity from the last 30 days.

GET /v1/activity?type=cards
x-api-key: dlfy_live_...

Query parameters

Parameter	Default	Description
`type`	—	Required. Must be `cards` in v1.
`limit`	`100`	Page size, capped at `100`.
`offset`	`0`	Number of records to skip.

Response

{
  "type": "cards",
  "window": "30d",
  "activity": [
    {
      "id": "ctxn_123",
      "cardId": "126b6996-9c99-4732-9a58-3d8721e30bc8",
      "cardLast4": "4242",
      "occurredAt": "2026-04-08T12:00:00.000Z",
      "settledAt": null,
      "description": "Northstar Media",
      "merchant": {
        "name": "Northstar Media",
        "city": "Sao Paulo",
        "country": "BR",
        "category": "Advertising",
        "enrichedName": "Northstar Media",
        "enrichedCategory": "Advertising"
      },
      "amount": "-42.50",
      "currency": "USD",
      "direction": "debit",
      "category": "purchase",
      "status": "pending",
      "declinedReason": null,
      "disputeStatus": null
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "hasMore": false
  }
}

Notes

Page forward by requesting the next page with offset += limit while pagination.hasMore is true.
Purchase rows normally include cardId, cardLast4, and merchant data.
Non-purchase rows (such as funding a card’s balance) can have cardId, cardLast4, and every merchant.* field set to null.
For real-time updates, subscribe to card webhooks instead of polling.