---
title: "List Invoices"
method: GET
path: "/api/v1/invoices"
tags: ["invoicing"]
---

# List Invoices

`GET /api/v1/invoices`

## Request

- Base URL: `https://app.kaminari.ad`
- URL: `https://app.kaminari.ad/api/v1/invoices`
- Auth: HTTP bearer

List caller-org invoices with optional filters + pagination.

## Query parameters

- `type` 'proforma' | 'final': Kind of invoice. Drives numbering sequence prefix + workflow. * ``PROFORMA`` — the single document for every top-up (bank + crypto). Issued up front (status=ISSUED); on settlement it flips to PAID and the paid proforma IS the receipt. Carries no VAT line per the EU/Cyprus deposit-on-account rationale. Number prefix ``PF-``. * ``FINAL`` — end-of-period statement. For PREPAID orgs it is informational (status=PAID on issue). For POSTPAID orgs it is the bill and remains ISSUED until payment confirmation. Number prefix ``IN-``.
- `status` 'draft' | 'issued' | 'paid' | 'voided' | 'overdue': Lifecycle states of an :class:`Invoice`. Transitions: - ``DRAFT`` → ``ISSUED`` (on issuance; PDF render follows) - ``ISSUED`` → ``PAID`` (on admin payment confirmation or gateway webhook) - ``ISSUED`` → ``VOIDED`` (admin void with reason) - ``ISSUED`` → ``OVERDUE`` (scheduled: past due-date, still unpaid)
- `organization_id` string, uuid, nullable
- `page` integer
- `limit` integer

## Response `200`

Successful Response

- PaginatedResponseInvoiceResponse
  - `items` InvoiceResponse[], required
    - `id` string, uuid, required
    - `number` string, required
    - `organization_id` string, uuid, required
    - `type` string, required
    - `status` string, required
    - `total_micros` integer, required
    - `net_micros` integer, required
    - `vat_micros` integer, required
    - `vat_rate` string, required
    - `vat_reason` string, required
    - `currency` string, required
    - `period_start` string, date-time, nullable, required
    - `period_end` string, date-time, nullable, required
    - `issued_at` string, date-time, nullable, required
    - `paid_at` string, date-time, nullable, required
    - `voided_at` string, date-time, nullable, required
    - `has_pdf` boolean, required
    - `description` string, required
    - `payment_method` string, required
    - `created_at` string, date-time, required
  - `total` integer, required
  - `page` integer, required
  - `limit` integer, required
  - `pages` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kaminari/apis/kaminari-ad-api.md) · [All operations](https://skmtc.dev/kaminari/apis/kaminari-ad-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaminari/apis/kaminari-ad-api/revisions/013f86e2fd32?raw)