Countries

List the supported countries

GET /v1/countries

One entry per registered fiscalization provider. Croatia is the only one today.

curl -sS https://api.fiskhub.com/v1/countries \
  -H "Authorization: Bearer $FISKHUB_KEY"

[
  {
    "code": "HR",
    "capabilities": ["unattended_sale", "ordinary_receipt", "echo"],
    "fiscalization_deadline_days": 30
  }
]

Field	Notes
code	ISO 3166-1 alpha-2. Selects the provider a company files through — see country_code on the company.
capabilities	What the country’s provider supports.
fiscalization_deadline_days	How long after a sale it stops being fiscalizable. 30 in Croatia — the cliff behind hr.sale_older_than_30_days.

What happened to /countries/{code}/schemas

It was removed. It published each country’s device fields as JSON Schema so the dashboard could render a form from them — and the fields it described were serial_number, manufacturer, model, installed_at and note. None of them reach a fiscal message.

Meanwhile the device_config keys that do change a message — sale_type, payment_method, special_purpose, vat_registered, sequence_mark, operator_oib and the rest — were offered by no form at all, and the API never validated device_config against the published schema in the first place.

fiscalization_deadline_days was the only thing that endpoint published which a caller needs, so it moved onto GET /v1/countries above.

A device now carries exactly what the Tax Administration identifies it by: its premises code (OznPosPr) and its ISU number (OznNapUr). See Devices.