Skip to main content
GET
List invoices
Returns invoices for your tenant’s billing history. Each invoice includes the amount, currency, payment status, and links to download the PDF or receipt.

Query parameters

string
Filter invoices created on or after this date (ISO 8601, e.g. 2026-01-01).
string
Filter invoices created on or before this date (ISO 8601, e.g. 2026-06-30).

Export invoices

Enterprise tenants can export invoices as CSV or JSON for accounting and reconciliation. The export includes invoice number, status, issue and due dates, amounts, tax, currency, and PO references. If no date range is provided, the export defaults to the last 30 days.
string
Export format: csv or json. Defaults to csv.
string
Start of the date range (YYYY-MM-DD, e.g. 2026-01-01). Defaults to 30 days ago.
string
End of the date range (YYYY-MM-DD, e.g. 2026-06-30). Defaults to today.

Response

Returns an array of invoice objects.
string
Invoice identifier.
string
Human-readable invoice number.
string
Payment status: paid, open, void, or uncollectible.
integer
Total amount in the smallest currency unit (e.g., cents for USD).
integer
Amount due in the smallest currency unit.
string
ISO 4217 currency code (e.g., usd, ngn).
string
ISO 8601 timestamp when the invoice was created.
string
ISO 8601 timestamp when the invoice was finalized and sent.
string
ISO 8601 timestamp for the payment due date.
string
URL to download the full invoice PDF.
string
URL to view the payment receipt (available for paid invoices).

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Query Parameters

limit
integer
default:20

Maximum number of invoices to return

cursor
string

Pagination cursor

Response

Invoice list

items
object[]
cursor
string | null