List billing documents
Invoices and receipts. scope: platform (the default) lists what the agency paid Team Follow Up AI: subscription invoices and the agency’s own wallet top-up receipts. scope: sub_accounts lists what the agency’s sub-accounts paid it. These are always top-up receipts.
The platform list has a size limit. When the limit is reached, truncated is true and the list is not complete history.
Allowed customer roles: agency_admin. The agency is the one the credential belongs to; no parameter selects another.
Required API key scope: billing:read.
Authorizations
Send your API key as Authorization: Bearer YOUR_API_KEY.
Query Parameters
Start of the window. A UTC ISO 8601 timestamp is canonical; a plain YYYY-MM-DD date is accepted and read as that day at 00:00:00Z. A timestamp must carry Z or an explicit offset, since one without a zone would be read as server-local time and shift the window. An empty string clears the bound. Any other value is refused with 400. Billing windows are whole UTC days, so a timestamp selects the day it falls on. Omit both bounds to read every document.
End of the window, inclusive. Defaults to today. A UTC ISO 8601 timestamp is canonical; a plain YYYY-MM-DD date is accepted and covers that whole day, through 23:59:59.999Z. A timestamp must carry Z or an explicit offset, since one without a zone would be read as server-local time and shift the window. An empty string clears the bound. Any other value is refused with 400. Billing windows are whole UTC days, so a timestamp selects the day it falls on.
Whose payments to list.
platform, sub_accounts Only invoices or only receipts.
ALL, INVOICE, RECEIPT With scope=sub_accounts, only this sub-account's receipts. Refused with any other scope.
1Page number, from 1.
x >= 1Rows per page, at most 100.
1 <= x <= 100