List Invoices

​

List your organization's invoices, newest first.

start and end are whole UTC dates (YYYY-MM-DD) and filter on the date the invoice was issued (created), not the billing period it covers. end is inclusive of that entire day.

Monetary fields are integers in the smallest currency unit (cents for USD), matching Stripe — divide by 100 before displaying.

Results are cursor-paginated: when has_more is true, pass next_cursor as starting_after.

Requires the billing_report permission. An API key carries the permissions of the user it belongs to.

Query Parameters
  • start
    Type: string · StartFormat: datenullable

    Only invoices issued on or after this UTC date (YYYY-MM-DD).

  • end
    Type: string · EndFormat: datenullable

    Only invoices issued on or before this UTC date (YYYY-MM-DD), inclusive of the whole day.

  • limit
    Type: integer · Limit
    min:  
    1
    max:  
    100

    Invoices per page (1-100).

  • starting_after
    Type: string · Starting Afternullable

    Invoice ID to page after — pass the previous response's next_cursor.

  • entity_id
    Type: string · Entity Idnullable

    Which of your organizations to read. Required only if you hold billing access to more than one.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/payments/invoices
curl https://ai.hatz.ai/v1/payments/invoices \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'

{
  "invoices": [
    {
      "id": "string",
      "number": "string",
      "status": "string",
      "created": "2026-08-13T20:17:31.133Z",
      "period_start": "2026-08-13T20:17:31.133Z",
      "period_end": "2026-08-13T20:17:31.133Z",
      "currency": "string",
      "total_cents": 1,
      "amount_due_cents": 1,
      "amount_paid_cents": 1,
      "hosted_invoice_url": "string",
      "invoice_pdf": "string"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

Successful Response