Skip to content
Graft Docs

Invoices

Invoices issued against orders.

GET /api/v1/invoices

Section titled “GET /api/v1/invoices”

List invoices. Cursor-paginated: pass limit (default 25, max 100) and cursor from the previous response’s meta.cursor. Filter with orderId and status (draft, open, paid, void).

Auth: Bearer token

POST /api/v1/invoices

Section titled “POST /api/v1/invoices”

Issue an invoice against an order. kind is full, deposit or balance.

Auth: Bearer token

Request body

{
  "orderId": "000000000000000000000050",
  "kind": "deposit",
  "dueInDays": 14
}

GET /api/v1/invoices/:invoiceId

Section titled “GET /api/v1/invoices/:invoiceId”

One invoice.

Auth: Bearer token · Path parameters: invoiceId

PATCH /api/v1/invoices/:invoiceId

Section titled “PATCH /api/v1/invoices/:invoiceId”

Mark an invoice paid or void.

Auth: Bearer token · Path parameters: invoiceId

Request body

{
  "status": "paid"
}