Invoices

List invoices

List your invoices, most recent first, filtered by status and paginated.

GET/api/invoicesinvoices:read

Query parameters

Property	Type	Description
status	enum	Filter by status: `pending`, `completed`, `expired`, or `canceled`.
page	integer	When present, returns offset pagination with totals. When absent, cursor pagination is used.
perPage	integer	Items per page, 5–100 (default 10).
cursor	string	Cursor for the next page, in cursor mode.

Advanced filters support status, reference, and created_at; sorters support id and created_at. Reconcile against your own order id with reference.

Response

A paginated envelope. With page, you get data plus meta totals; without it, cursor meta is returned instead.

bash

curl "https://api.coinfat.com/api/invoices?status=completed&page=1&perPage=20" \
  -H "Authorization: Bearer 42|nX9...secret"

200 OK

{
  "data": [
    {
      "ulid": "01JZ8Q5F2H7T9K1M3N5P7R9S1U",
      "status": "completed",
      "amount": { "amount": "49.99", "currency": "USD", "scale": 2 },
      "reference": "ORDER-10231",
      "created_at": "2026-07-07T14:00:00.000000Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "from": 1,
    "to": 1,
    "total": 1,
    "last_page": 1
  },
  "links": { "first": "...", "last": "...", "prev": null, "next": null }
}