List billing activity

View as Markdown
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