Finance > Invoices

List invoices

GET invoices

Endpoint

GET /api/v1/finance/invoices

Parameters

Name Description In
by_state Filter by stats ["pending", "paid", "overdue"]
from_date Filter by date
to_date Filter by date
by_company Filter by company ID
by_number Search by number

Request

Route

GET /api/v1/finance/invoices

Headers

Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI0MDEiLCJzY3AiOiJ1c2VyIiwiYXVkIjpudWxsLCJpYXQiOjE3NjM2MjYzNzAsImV4cCI6MTc2NjIxODM3MCwianRpIjoiYTY5MTIzYTktYmM2Mi00NGUwLTgwNTAtOGM3ZjZjY2Y1YjA1In0.OsZHyAIJUFn2WsTXouSzT8S4BFsSeWPbZY0fXFFP5L0
Host: example.org
Cookie:

Query Parameters

{}=

Body

{
}

Response

Simulated Response

Status

200

Headers

x-frame-options: SAMEORIGIN
x-xss-protection: 0
x-content-type-options: nosniff
x-permitted-cross-domain-policies: none
referrer-policy: strict-origin-when-cross-origin
per-page: 20
total: 6
content-type: application/json; charset=utf-8
vary: Accept, Origin
etag: W/"a3c97658d4059edf5390a22e2533d733"
cache-control: max-age=0, private, must-revalidate
x-request-id: 0334976d-3050-45ad-ab20-c1d3fea1ad54
x-runtime: 0.022210
content-length: 1916

Body

{
  "invoices": [
    {
      "id": 6,
      "company_name": "Ullrich Group",
      "created_at": "2025-11-20T08:12:50.189Z",
      "currency": "GBP",
      "due_date": "2025-11-19",
      "from": "2025-10-01",
      "issued_date": "2025-11-20",
      "number": "55390712",
      "state": "overdue",
      "to": "2025-10-31",
      "total": "1519.0",
      "uuid": "fb4df93d-48fd-4e52-83e5-1494a46077a3",
      "vat_percentage": "20.0"
    },
    {
      "id": 5,
      "company_name": "Herzog, Schinner and Heaney",
      "created_at": "2025-11-20T08:12:50.177Z",
      "currency": "GBP",
      "due_date": "2025-11-19",
      "from": "2025-10-01",
      "issued_date": "2025-11-20",
      "number": "68752247",
      "state": "overdue",
      "to": "2025-10-31",
      "total": "5841.0",
      "uuid": "fae4042f-6e39-43db-91cd-3801146ef697",
      "vat_percentage": "20.0"
    },
    {
      "id": 4,
      "company_name": "Fisher LLC",
      "created_at": "2025-11-20T08:12:50.163Z",
      "currency": "GBP",
      "due_date": "2025-11-19",
      "from": "2025-10-01",
      "issued_date": "2025-11-20",
      "number": "28378344",
      "state": "overdue",
      "to": "2025-10-31",
      "total": "2089.0",
      "uuid": "a293489f-d5c8-42d8-a92f-edd1521be9ad",
      "vat_percentage": "20.0"
    },
    {
      "id": 3,
      "company_name": "Nitzsche, Turner and Roob",
      "created_at": "2025-11-20T08:12:50.150Z",
      "currency": "GBP",
      "due_date": "2025-12-05",
      "from": "2025-10-01",
      "issued_date": "2025-11-20",
      "number": "25517245",
      "state": "pending",
      "to": "2025-10-31",
      "total": "5503.0",
      "uuid": "dd01f4fd-d314-44c2-901d-91bdbae9d152",
      "vat_percentage": "20.0"
    },
    {
      "id": 2,
      "company_name": "Hauck, Herzog and Hamill",
      "created_at": "2025-11-20T08:12:50.137Z",
      "currency": "GBP",
      "due_date": "2025-12-05",
      "from": "2025-10-01",
      "issued_date": "2025-11-20",
      "number": "61767859",
      "state": "pending",
      "to": "2025-10-31",
      "total": "8404.0",
      "uuid": "278ff8e1-cfa7-4b9a-934e-eecac7936e2f",
      "vat_percentage": "20.0"
    },
    {
      "id": 1,
      "company_name": "Skiles-Shanahan",
      "created_at": "2025-11-20T08:12:50.123Z",
      "currency": "GBP",
      "due_date": "2025-12-05",
      "from": "2025-10-01",
      "issued_date": "2025-11-20",
      "number": "59250023",
      "state": "pending",
      "to": "2025-10-31",
      "total": "3374.0",
      "uuid": "a63fedb2-a988-4f00-b64d-daec611d4d02",
      "vat_percentage": "20.0"
    }
  ]
}