Invoices API

Read invoice data for your account.

Required scope: invoices:read

Invoices are generated automatically by Ciklek. You cannot create invoices via the API.

List Invoices

GET /v1/invoices

Query Parameters

| Param | Type | Description | |-------|------|-------------| | status | string | Filter: draft, sent, paid, overdue | | from | ISO date | Invoice date on or after | | to | ISO date | Invoice date on or before | | limit | integer | Default 25, max 100 | | after | string | Cursor for next page |

Response

{
  "data": [
    {
      "id": "inv_abc123",
      "invoice_number": "INV-2026-0041",
      "status": "sent",
      "total_cents": 19200,
      "tax_cents": 0,
      "due_date": "2026-04-08",
      "pdf_url": "https://cdn.ciklek.com/invoices/inv_abc123.pdf",
      "created_at": "2026-03-09T10:00:00Z"
    }
  ],
  "meta": { "total": 6, "next_cursor": null }
}

Get an Invoice

GET /v1/invoices/:id

Returns the full invoice including line items:

{
  "data": {
    "id": "inv_abc123",
    "invoice_number": "INV-2026-0041",
    "status": "sent",
    "total_cents": 19200,
    "line_items": [
      { "description": "Blade sharpening × 8", "amount_cents": 16000 },
      { "description": "Pickup & delivery", "amount_cents": 3200 }
    ],
    "due_date": "2026-04-08",
    "pdf_url": "https://cdn.ciklek.com/invoices/inv_abc123.pdf"
  }
}