API referenceInvoices
List invoices
GET
The invoices the API can see — those it created, those its contracts billed, and their cancellation invoices — most recently changed first. Use changed_since for a sync that fetches only what moved. Scope partner:invoices:read.
apiKey partner:invoices:readheader
AuthorizationBearer <ab_…>An API key from Integrations → Connect AI assistants (MCP) → New access, bound to exactly one company. Each operation names the scope the key must carry.
Scope: partner:invoices:read
customer_ref?|nullcontract_ref?|nullstatus?|nullchanged_since?|nulllimit?LimitRange
1 <= value <= 500Default
100offset?OffsetRange
0 <= valueDefault
0AlphaCount-Version?stringThe API version to use. Default: the current one.
OK
application/json- response
invoices*array<>limit*Limitoffset*Offsetcurl -X GET 'https://app.alphacount.ai/api/partner/v1/invoices' \ -H 'Authorization: Bearer ab_...'Example Response
{ "invoices": [ { "amount_paid": "0.00", "cancelled_by": null, "cancels_invoice": null, "contract_external_ref": "c-7", "currency": "EUR", "customer_external_ref": "school-7", "due_date": null, "dunning_level": null, "external_ref": null, "external_source": null, "id": "00000000-0000-4000-8000-000000000001", "issue_date": null, "number": null, "overdue": false, "paid_at": null, "sent_at": null, "service_period": { "end": "2026-02-28", "start": "2026-01-01" }, "status": "draft", "total_gross": "981.75", "total_net": "825.00", "total_tax": "156.75", "type": "invoice" }, { "amount_paid": "0.00", "cancelled_by": null, "cancels_invoice": null, "contract_external_ref": "c-7", "currency": "EUR", "customer_external_ref": "school-7", "due_date": null, "dunning_level": null, "external_ref": null, "external_source": null, "id": "00000000-0000-4000-8000-000000000002", "issue_date": null, "number": null, "overdue": false, "paid_at": null, "sent_at": null, "service_period": { "end": "2026-01-31", "start": "2026-01-01" }, "status": "draft", "total_gross": "505.75", "total_net": "425.00", "total_tax": "80.75", "type": "invoice" } ], "limit": 100, "offset": 0}