v4

OpenAPI 3.1.02026-08-0255174167.5 KB

billing

List billing activity

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.

get/api/v1/billing/activity

Query parameters

filter'all' | 'usage' | 'payment-credits'

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

limitinteger

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

starting_afterstring date-time

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

Headers

Authorizationstring required

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

Response

One page of activity, newest-first.

hasMoreboolean

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