List billing activity | Dial — Communication Stack for AI Agents

{
  "data": [
    {
      "type": "usage",
      "occurredAt": "2024-01-15T09:30:00Z",
      "amountCents": 1,
      "totalCents": 1,
      "fareName": "sms.tier_1.message",
      "number": "+14155550123",
      "billedQuantity": 1,
      "attribution": "wallet",
      "phoneNumberId": "pn_8f3a2b1c",
      "callId": null,
      "messageId": "msg_4d2f7e9a",
      "kind": null,
      "invoiceId": null,
      "reason": null
    },
    {
      "type": "credit",
      "occurredAt": "2024-01-14T16:45:00Z",
      "amountCents": 5000,
      "fareName": null,
      "number": null,
      "billedQuantity": null,
      "attribution": null,
      "phoneNumberId": null,
      "callId": null,
      "messageId": null,
      "kind": "card",
      "invoiceId": "in_1J2K3L4M5N6O7P",
      "reason": null
    },
    {
      "type": "payment",
      "occurredAt": "2024-01-10T12:00:00Z",
      "amountCents": 9999,
      "fareName": null,
      "number": null,
      "billedQuantity": null,
      "attribution": null,
      "phoneNumberId": null,
      "callId": null,
      "messageId": null,
      "kind": null,
      "invoiceId": "in_9Z8Y7X6W5V4U3T",
      "reason": "subscription_create"
    }
  ],
  "hasMore": true
}

The unified billing activity ledger — usage (calls, SMS, number ownership), wallet credits, and subscription payments — merged newest-first and cursor-paginated. Each item has a type that selects which fields are present. Pagination is Stripe-style: pass limit (max page size) and starting_after set to the occurredAt of the last item you received to fetch the next page (only items strictly older are returned). hasMore indicates whether further pages exist.

The unified billing activity ledger — usage (calls, SMS, number ownership), wallet credits, and subscription payments — merged newest-first and cursor-paginated. Each item has a `type` that selects which fields are present. Pagination is Stripe-style: pass `limit` (max page size) and `starting_after` set to the `occurredAt` of the last item you received to fetch the next page (only items strictly older are returned). `hasMore` indicates whether further pages exist.

Authentication

AuthorizationBearer

Your Dial API key, sent as Authorization: Bearer sk_live_...

Query parameters

filterenumOptionalDefaults to all

Scope the feed: all, usage only, or payment-credits (subscription payments + wallet credits).

Allowed values:

limitintegerOptional1-100Defaults to 50

Max items per page (clamped to 1–100).

starting_afterdatetimeOptional

Exclusive cursor — an exact ISO timestamp (the occurredAt of the last item from the previous page). Only items strictly older are returned.

Response

One page of activity, newest-first.

datalist of objects

hasMoreboolean

True when more items exist older than the last one returned.

Errors

400

Bad Request Error

401

Unauthorized Error

$	curl https://getdial.ai/api/v1/billing/activity \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"