API documentation

Invoices

GET/invoices

List account invoices

Same as the per-customer list, without a customerId. Each invoice includes the customer it belongs to. The access code remains limited to one account and mode.

Request
Build the URL with the parameters below and send the code in the Authorization header.
GEThttps://stripe-ix.betacode.tech/api/v1/invoices

Inputs and parameters

pagequeryinteger

Page to return. Values below 1 use the default.

Optional · Default: 1

page_sizequeryinteger

Number of records per page. The maximum is 50.

Optional · Default: 10

statusqueryenum

Stripe status: draft, open, paid, void or uncollectible.

Optional

ix_statusquerystring

InvoiceXpress document status, for example draft or settled.

Optional

date_fromquerydate

Inclusive start date in YYYY-MM-DD format.

Optional

date_toquerydate

Inclusive end date in YYYY-MM-DD format.

Optional

qquerystring

Free-text search across number, customer, email and other indexed fields.

Optional

Request example

curl "https://stripe-ix.betacode.tech/api/v1/invoices?page=1&page_size=20&status=paid" \
  -H "Authorization: Bearer ixp_test_YOUR_ACCESS_CODE" \
  -H "Accept: application/json"
Response
On success, this endpoint returns JSON with Content-Type application/json.

Output example

{
  "invoices": [
    {
      "id": "in_1Q2w3E4r",
      "number": "A-2026-0042",
      "customer_name": "Ana Silva",
      "customer_id": "cus_Q1w2E3r4",
      "company_name": "Acme, Lda.",
      "issued_at": "2026-08-18T10:30:00.000Z",
      "total_cents": 12300,
      "currency": "eur",
      "status": "paid",
      "ix_sync_state": "synced",
      "ix_status": "settled"
    }
  ],
  "page": 1,
  "page_size": 20,
  "total": 1,
  "total_pages": 1,
  "source": "mongo"
}

Behavior

  • The response uses the same invoice object as the per-customer list, including customer_id and customer_name.
  • Monetary values ending in _cents are integers in the currency's smallest unit.
  • A status other than draft, open, paid, void or uncollectible returns 400.

Integration notes

  • Scope is the Stripe account and mode of the access code. There is no account parameter.
  • PDF downloads still need the invoice customerId on the download endpoints.