Retrieve an invoice

Beta

GET

/invoices/:invoice_id

GET

/invoices/:invoice_id

curl https://test.api.kota.io/invoices/inv_3b1333d87d9d4fd6ad83ba7f6b0e951a \
     -H "Authorization: Bearer <apiKey>"

{
  "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
}

Returns a single invoice by its id.

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

Authentication

AuthorizationBearer

Authorization header using the Bearer scheme

Path parameters

invoice_idstringRequiredformat: "inv_.+"

Response

idstringformat: "inv_.+"

Unique identifier for the invoice. Prefixed with inv_.

provider_idstringformat: "pr_.+"

The provider that issued the invoice. Prefixed with pr_.

employer_idslist of strings

The employers this invoice is linked to. Prefixed with er_.

invoice_datedate

The date the invoice was issued.

currencystring

ISO 4217 currency code.

total_grossdouble

Total gross amount of the invoice (net plus tax).

documentslist of objects

The original documents issued by the provider for this invoice, such as the invoice itself and its itemised detail.

objectstringOptionalRead-only

The object type. Always invoice.

invoice_numberstring or nullOptional

The provider's invoice reference, where the provider issues one.

total_taxdouble or nullOptional

Total tax on the invoice.

Errors

404

Not Found Error

Authentication

Path parameters

Headers

Response

Errors