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

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

```json
{
  "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](/docs/banking-balance).

## Card activity

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

```http
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

```json
{
  "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](/docs/cards-webhooks) instead of polling.