Skip to navigation
REST APIBilling

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 objectsOptional
hasMorebooleanOptional
True when more items exist older than the last one returned.

Errors

400
Bad Request Error
401
Unauthorized Error