Skip to navigation
API ReferenceInvoices

Retrieve an Invoice

Returns one Invoice and its current state. Invoices from the other mode or another Merchant are 404.

Authentication

AuthorizationBearer

Your secret key: sk_test_… in Test mode, sk_live_… in Live mode.

Path parameters

idintegerOptional
Invoice identifier.

Response

The Invoice.
idinteger
Invoice identifier.
numberstring or null

The Invoice number, such as INV-0007. Assigned when the Invoice is sent, so a draft has none; numbers are never reused.

statusenum

draft until sent and editable only from the dashboard. sent: the Customer can pay it. paid: paid in full. void: you voided it; it can no longer be paid.

Allowed values:
overdueboolean

A sent, unpaid Invoice past its due date (Pacific/Fiji). Derived, not a status; the Customer can still pay.

modeenum

test for an Invoice made with an sk_test_ key, live for an sk_live_ key.

Allowed values:
customerNamestring
Who you billed.
customerEmailstring or null
The Customer's email, if you gave one.
itemslist of objects
The line items, excluding tax.
taxLabelstring or null

Label of the tax line; null if none.

taxPercentdouble
0 when there is no tax line.
vatNumberstring or null
Your VAT number, if you gave one.
dueDatestring

YYYY-MM-DD, Pacific/Fiji.

subtotalinteger

Sum of the line items, in FJD cents (minor units).

taxinteger

The tax line, in FJD cents (minor units).

totalinteger

Amount due; under FJD 5,000.00, in FJD cents (minor units).

urlstring
The hosted page the Customer opens and pays on. Works once the Invoice is sent.
pdfUrlstring or null

Where to GET the PDF, with your secret key. Null on a draft.

createdAtinteger
Unix ms timestamp the draft was created.
sentAtinteger or null

Unix ms timestamp it was sent; null on a draft.

paidAtinteger or null

Unix ms timestamp it was paid; null until then.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error