List Invoices

​

List your organization's finalized invoices, newest first.

Draft invoices are excluded: a draft is a bill Stripe is still assembling, so its amounts can still change and it may never be issued.

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. Page until has_more is false, not until a page comes back empty — drafts are removed after Stripe has counted them toward the page, so a page can hold fewer invoices than limit, or none, while has_more is still true.

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

Query Parameters

  • start
    Type: stringFormat: datenullable

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

  • end
    Type: stringFormat: datenullable

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

  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Invoices per page (1-100).

  • starting_after
    Type: stringnullable

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

  • entity_id
    Type: stringnullable

    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?limit=25' \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'

{
  "invoices": [
    {
      "id": "string",
      "number": "string",
      "status": "string",
      "created": "2026-09-24T21:16:45.032Z",
      "period_start": "2026-09-24T21:16:45.032Z",
      "period_end": "2026-09-24T21:16:45.032Z",
      "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