Invoices

List Invoices

GET /api/v1/invoices

Return invoices for the API key's organization and mode.

Query Parameters

Param	Type	Description
`limit`	number	Max results (1-100, default 10)
`starting_after`	string	Cursor for forward pagination
`status`	string	Filter: `open`, `paid`, `overdue`, `void`

Response

{
  "object": "list",
  "url": "/api/v1/invoices",
  "data": [
    {
      "object": "invoice",
      "id": 1,
      "invoice_number": "INV-2026-0001",
      "status": "ISSUED",
      "amount_cents": 35000,
      "late_fee_cents": 0,
      "total_cents": 35000,
      "due_date": "2026-07-31T00:00:00.000Z",
      "created_at": "2026-07-01T00:00:00.000Z"
    }
  ],
  "has_more": false
}

Retrieve Invoice

GET /api/v1/invoices/:id

Returns the invoice with line items.

Download Invoice PDF

GET /api/v1/invoices/:id/pdf

Returns the invoice as a PDF file.

Errors

Status	When
`404`	The invoice ID does not exist in the API key's organization or mode
`500`	Invoice PDF generation fails; retry the request

See Handle API Errors for the common error envelope and retry guidance.