Skip to main content
Endpoints

Invoices

Invoices where your org is the seller or buyer. role is relative to you.

List invoices

GET /api/v1/invoices?limit=50
{
  "data": [
    {
      "id": "inv_…",
      "number": "INV-295",
      "role": "buyer",
      "counterparty": { "org_id": "…", "name": "GB Distillers" },
      "status": "paid",
      "total_cents": 87000,
      "issued_at": "2026-05-12T00:00:00.000Z"
    }
  ],
  "has_more": false,
  "limit": 50
}

Retrieve one invoice

GET /api/v1/invoices/{id}

Returns the invoice plus line_items. Non-party or missing → 404.