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.eyJzdWIiOiIzOTEiLCJzY3AiOiJ1c2VyIiwiYXVkIjpudWxsLCJpYXQiOjE3NTMyNjYxNzksImV4cCI6MTc1NTg1ODE3OSwianRpIjoiMmEwZmI1NjUtOThjMi00ZTAzLThhNTEtOGQxYzIyZTg3NWJlIn0.sMdLloPwwGFTlNF3FGBWJl6SYrf7PUadq9H7enoaMNY
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/"186070a833f101ce8a5796dc19fa59cb"
cache-control: max-age=0, private, must-revalidate
x-request-id: 2d32f81b-930b-41a4-800b-2b89ffad56f9
x-runtime: 0.011555
content-length: 1663

Body

{
  "invoices": [
    {
      "id": 6,
      "company_name": "Stamm Inc",
      "created_at": "2025-07-23T10:22:59.221Z",
      "due_date": "2025-07-22",
      "from": "2025-06-01",
      "issued_date": "2025-07-23",
      "number": "64653514",
      "state": "overdue",
      "to": "2025-06-30",
      "total": "1415.0",
      "uuid": "43bb5a8c-9ebb-48fb-8318-326d33f932c0"
    },
    {
      "id": 5,
      "company_name": "Swaniawski, Emmerich and Howell",
      "created_at": "2025-07-23T10:22:59.205Z",
      "due_date": "2025-07-22",
      "from": "2025-06-01",
      "issued_date": "2025-07-23",
      "number": "47064896",
      "state": "overdue",
      "to": "2025-06-30",
      "total": "7736.0",
      "uuid": "87118ddc-fec0-477d-951a-d2f9e14397dd"
    },
    {
      "id": 4,
      "company_name": "Hodkiewicz-Toy",
      "created_at": "2025-07-23T10:22:59.189Z",
      "due_date": "2025-07-22",
      "from": "2025-06-01",
      "issued_date": "2025-07-23",
      "number": "97040467",
      "state": "overdue",
      "to": "2025-06-30",
      "total": "9019.0",
      "uuid": "4588c5dd-bbf4-4cc0-b8b8-31709276aa4a"
    },
    {
      "id": 3,
      "company_name": "Gerlach-Rempel",
      "created_at": "2025-07-23T10:22:59.172Z",
      "due_date": "2025-08-07",
      "from": "2025-06-01",
      "issued_date": "2025-07-23",
      "number": "80319198",
      "state": "pending",
      "to": "2025-06-30",
      "total": "9131.0",
      "uuid": "4f08569a-8aaa-42af-8f4d-f2c6db2c4738"
    },
    {
      "id": 2,
      "company_name": "Dickinson, Harvey and Ritchie",
      "created_at": "2025-07-23T10:22:59.155Z",
      "due_date": "2025-08-07",
      "from": "2025-06-01",
      "issued_date": "2025-07-23",
      "number": "71058245",
      "state": "pending",
      "to": "2025-06-30",
      "total": "8403.0",
      "uuid": "bbe6c282-b360-4303-b2f8-6741de0bab4d"
    },
    {
      "id": 1,
      "company_name": "Johns-Conn",
      "created_at": "2025-07-23T10:22:59.136Z",
      "due_date": "2025-08-07",
      "from": "2025-06-01",
      "issued_date": "2025-07-23",
      "number": "43848996",
      "state": "pending",
      "to": "2025-06-30",
      "total": "3366.0",
      "uuid": "0cdd6f25-8e84-474c-b05f-e05c8df9c20f"
    }
  ]
}