List invoices

Beta

GET

/invoices

GET

/invoices

curl -G https://test.api.kota.io/invoices \
     -H "Authorization: Bearer <apiKey>" \
     -d employer_id=er_3b1333d87d9d4fd6ad83ba7f6b0e951a \
     -d provider_id=pr_allianz

{
  "items": [
    {
      "id": "inv_ea4c9abd28cd496c98ecce467b6c46bc",
      "provider_id": "pr_allianz",
      "employer_ids": [
        "er_91716027ace2428dacaf1727263ab09c"
      ],
      "invoice_date": "2026-10-01",
      "currency": "EUR",
      "total_gross": 250,
      "documents": [
        {
          "type": "invoice_summary",
          "file_id": "file_b8237a41ba3646d3a8541a06b08876a0",
          "content_type": "application/pdf",
          "part_number": null,
          "part_count": null
        },
        {
          "type": "invoice_detail",
          "file_id": "file_df1f998fced441b98051adc6cb854c9e",
          "content_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
          "part_number": null,
          "part_count": null
        }
      ],
      "object": "invoice",
      "invoice_number": "INV-2026-0012",
      "total_tax": 10
    },
    {
      "id": "inv_aef848b9fdd840a8b9b8546da7c4f564",
      "provider_id": "pr_allianz",
      "employer_ids": [
        "er_91716027ace2428dacaf1727263ab09c"
      ],
      "invoice_date": "2026-09-01",
      "currency": "EUR",
      "total_gross": 250,
      "documents": [
        {
          "type": "invoice_summary",
          "file_id": "file_bc066ea797ee463c8437f7638f122d60",
          "content_type": "application/pdf",
          "part_number": null,
          "part_count": null
        }
      ],
      "object": "invoice",
      "invoice_number": "INV-2026-0011",
      "total_tax": 10
    }
  ],
  "page": 1,
  "page_size": 20,
  "total_count": 2,
  "has_next_page": false,
  "has_previous_page": false
}

Returns a list of invoices, most recent invoice date first.

Beta: available to selected customers. Contact your Kota account manager for access.

Authentication

AuthorizationBearer

Authorization header using the Bearer scheme

Query parameters

provider_idstringOptionalformat: "pr_.+"

Filter by provider. Prefixed with pr_.

employer_idstringOptionalformat: "er_.+"

Filter by employer. Prefixed with er_.

invoice_numberstringOptional

Filter by invoice number (case-insensitive, partial match).

from_datedateOptional

Only invoices dated on or after this date.

to_datedateOptional

Only invoices dated on or before this date.

pageintegerOptional

The page of results to return. Defaults to 1 if not provided.

page_sizeintegerOptional

The number of results to return per page. Defaults to 10 if not provided. Maximum value is 100.

Response

itemslist of objects

A paginated array containing the response elements

pageinteger

The current page of the results

page_sizeinteger

The number of results on this page. This can be different from the requested page size if the total number of results is less than the requested page size

total_countinteger

The total number of elements available in the response. This is the total number of elements available across all pages, not just the current page.

has_next_pagebooleanOptionalRead-only

Whether there are more pages available after this page

has_previous_pagebooleanOptionalRead-only

Whether there are more pages available before this page

Errors

400

Bad Request Error

Authentication

Headers

Query parameters

Response

Errors