API documentation
Invoices
GET
/invoicesList 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.
GET
https://stripe-ix.betacode.tech/api/v1/invoicesInputs and parameters
pagequeryintegerPage to return. Values below 1 use the default.
Optional · Default: 1
page_sizequeryintegerNumber of records per page. The maximum is 50.
Optional · Default: 10
statusqueryenumStripe status: draft, open, paid, void or uncollectible.
Optional
ix_statusquerystringInvoiceXpress document status, for example draft or settled.
Optional
date_fromquerydateInclusive start date in YYYY-MM-DD format.
Optional
date_toquerydateInclusive end date in YYYY-MM-DD format.
Optional
qquerystringFree-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.