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.eyJzdWIiOiIzOTEiLCJzY3AiOiJ1c2VyIiwiYXVkIjpudWxsLCJpYXQiOjE3NjA5NTA0NDEsImV4cCI6MTc2MzU0MjQ0MSwianRpIjoiOGUzMTdmZTItMzk0OC00YzY0LWI5YmQtY2FlNTM1MjVkMWM0In0.kHJ6cxlgcrREq2VVYXANBQOP9DKJuxiXX-MBl1La6Dg
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/"96b9372e401356a80595a59b579fb42f"
cache-control: max-age=0, private, must-revalidate
x-request-id: 500db27d-0f93-479a-8b9a-72cd80ba0585
x-runtime: 0.011879
content-length: 1921

Body

{
  "invoices": [
    {
      "id": 6,
      "company_name": "Rolfson LLC",
      "created_at": "2025-10-20T08:54:01.055Z",
      "currency": "GBP",
      "due_date": "2025-10-19",
      "from": "2025-09-01",
      "issued_date": "2025-10-20",
      "number": "02535469",
      "state": "overdue",
      "to": "2025-09-30",
      "total": "7633.0",
      "uuid": "c83757bd-6fce-4849-819d-6a32a98d425e",
      "vat_percentage": "20.0"
    },
    {
      "id": 5,
      "company_name": "Moore, Stiedemann and Nicolas",
      "created_at": "2025-10-20T08:54:01.042Z",
      "currency": "GBP",
      "due_date": "2025-10-19",
      "from": "2025-09-01",
      "issued_date": "2025-10-20",
      "number": "98456579",
      "state": "overdue",
      "to": "2025-09-30",
      "total": "5989.0",
      "uuid": "1704a1ff-b54f-43a0-803b-1ad0b435969a",
      "vat_percentage": "20.0"
    },
    {
      "id": 4,
      "company_name": "Hammes, Nikolaus and Cummerata",
      "created_at": "2025-10-20T08:54:01.030Z",
      "currency": "GBP",
      "due_date": "2025-10-19",
      "from": "2025-09-01",
      "issued_date": "2025-10-20",
      "number": "86936074",
      "state": "overdue",
      "to": "2025-09-30",
      "total": "9478.0",
      "uuid": "ea243197-74ab-47e0-bbfd-781d60006a67",
      "vat_percentage": "20.0"
    },
    {
      "id": 3,
      "company_name": "Metz LLC",
      "created_at": "2025-10-20T08:54:01.016Z",
      "currency": "GBP",
      "due_date": "2025-11-04",
      "from": "2025-09-01",
      "issued_date": "2025-10-20",
      "number": "03310651",
      "state": "pending",
      "to": "2025-09-30",
      "total": "9035.0",
      "uuid": "f7b4ae53-8baf-4b9d-96be-f3cf804143e3",
      "vat_percentage": "20.0"
    },
    {
      "id": 2,
      "company_name": "Macejkovic LLC",
      "created_at": "2025-10-20T08:54:01.003Z",
      "currency": "GBP",
      "due_date": "2025-11-04",
      "from": "2025-09-01",
      "issued_date": "2025-10-20",
      "number": "10310704",
      "state": "pending",
      "to": "2025-09-30",
      "total": "1579.0",
      "uuid": "f980ce35-7312-4efc-96de-959149d14498",
      "vat_percentage": "20.0"
    },
    {
      "id": 1,
      "company_name": "Wyman, Schultz and O'Conner",
      "created_at": "2025-10-20T08:54:00.986Z",
      "currency": "GBP",
      "due_date": "2025-11-04",
      "from": "2025-09-01",
      "issued_date": "2025-10-20",
      "number": "37729674",
      "state": "pending",
      "to": "2025-09-30",
      "total": "7449.0",
      "uuid": "859b145e-b75e-4a8c-9615-5a953b82231e",
      "vat_percentage": "20.0"
    }
  ]
}