API referenceInvoices
Retrieve an invoice by your reference
GET
The invoice you created under {source}/{external_ref}. 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
source*SourceMatch
^[a-z0-9][a-z0-9_-]{0,49}$external_ref*External RefMatch
^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,254}$AlphaCount-Version?stringThe API version to use. Default: the current one.
OK
application/json- response
amount_paid*Amount Paidcancelled_by*|nullcancels_invoice*|nullcontract_external_ref*|The contract that billed it, if any.
currency*Currencycustomer_external_ref*string|nulldue_date*|nulldunning_level*|Highest dunning level sent (0 = payment reminder).
external_ref*string|nullexternal_source*string|nullid*Idissue_date*|nullnumber*|Invoice number; null while a draft.
overdue*Overduepaid_at*|Paid in full, UTC.
sent_at*|First mail, UTC.
service_period*status*StatusValue in
"draft""issued""sent""partially_paid""paid""cancelled"total_gross*Total Grosstotal_net*Total Nettotal_tax*Total Taxtype*TypeA cancellation invoice (Stornorechnung) is type storno with negative amounts.
Value in
"invoice""storno"curl -X GET 'https://app.alphacount.ai/api/partner/v1/invoices/by-ref/string/string' \ -H 'Authorization: Bearer ab_...'Example Response
{ "amount_paid": "0.00", "cancelled_by": null, "cancels_invoice": null, "contract_external_ref": null, "currency": "EUR", "customer_external_ref": "org-17", "due_date": "2026-11-02", "dunning_level": null, "external_ref": "order-1", "external_source": "alphalearn", "id": "00000000-0000-4000-8000-000000000001", "issue_date": "2026-10-19", "number": "RE-2026-0001", "overdue": false, "paid_at": null, "sent_at": null, "service_period": { "end": "2026-10-31", "start": "2026-10-01" }, "status": "issued", "total_gross": "119.00", "total_net": "100.00", "total_tax": "19.00", "type": "invoice"}