Croatia VAT API – Validate Croatia VAT Numbers in Real Time

REST JSON endpoint for verifying Porez na dodanu vrijednost (PDV) numbers against the official EU VIES register, with national registry fallback where available and a VIES consultation number once you set your own VAT as requester in dashboard Account details.

Get a free API key Croatia VAT number format

Why a Croatia-Aware VAT API

In Croatia, VAT is known as Porez na dodanu vrijednost (PDV) and the current standard rate is 25%. Every Croatia VAT number starts with the prefix HR and follows a fixed structure issued by the Croatian tax authority. A generic VAT validator that ignores country-specific quirks will accept malformed input and miss the country’s format rules.

The vatnode API normalises PDV input, runs the official VIES check, and returns a single JSON shape with the consultation number, company data where published, and the current Croatia VAT rates inline.

Croatia VAT Number Format

Structure

HR + 11 digits

Regex pattern

^HR\d{11}$

Real Croatia VAT numbers you can validate right now:

HR81793146560 — Hrvatski Telekom d.d.
HR27759560625 — INA d.d.
HR18928523252 — Podravka d.d.

More of them live in the EU VAT number directory, grouped by member state.

Validating Croatia VAT Numbers – Code Examples

All three examples validate the same Croatia VAT number HR81793146560. To receive a consultation number back, set your own VAT as requester once in dashboard Account details – then every call, including these, returns a consultation number automatically, with no extra parameters.

curl

curl 'https://api.vatnode.dev/v1/vat/HR81793146560' \
  -H "Authorization: Bearer YOUR_API_KEY"

Node.js (fetch)

const res = await fetch(
  'https://api.vatnode.dev/v1/vat/HR81793146560',
  { headers: { Authorization: `Bearer ${process.env.VATNODE_API_KEY}` } }
)
const data = await res.json()
console.log(data.valid, data.companyName, data.consultationNumber)

Python (httpx)

import os, httpx

r = httpx.get(
    "https://api.vatnode.dev/v1/vat/HR81793146560",
    headers={"Authorization": f"Bearer {os.environ['VATNODE_API_KEY']}"},
)
data = r.json()
print(data["valid"], data["companyName"], data["consultationNumber"])

What You Get Back

A successful response for a valid CroatiaVAT number, once you've set your VAT as requester in dashboard Account details, looks like this:

{
  "valid": true,
  "vatId": "HR81793146560",
  "countryCode": "HR",
  "countryName": "Croatia",
  "companyName": "Hrvatski Telekom d.d.",
  "consultationNumber": "WAPIAAAAXk7ZpY3o",
  "source": "VIES",
  "countryVat": {
    "currency": "EUR",
    "standardRate": 25,
    "reducedRates": [5,13],
    "superReducedRate": null,
    "parkingRate": null
  },
  "verifiedAt": "2026-05-19T08:14:22Z"
}

When the number is not registered, valid is false and company fields are null. The consultationNumber is the EU VIES requestIdentifier – the documented audit reference for reverse-charge ‘reasonable care’ evidence. It is returned once you set your own VAT as requester in dashboard Settings; otherwise it is null.

Croatia VAT Rates

vatnode returns the current Croatian PDV rates inline with every successful response. Today’s rates (standard 25%, reduced 5%, 13%) are sourced from the European Commission TEDB feed, checked daily and updated on any change.

Rate type	Value
Standard	25%
Reduced (1)	5%
Reduced (2)	13%

VIES vs National Fallback for Croatia

For Croatia, VIES is the sole authoritative source. vatnode does not run a national-registry fallback for this country today – when VIES is unavailable, the API surfaces a structured VIES_UNAVAILABLE error with retry guidance so you can degrade gracefully rather than silently accept unverified numbers.

Cached VIES responses (15-minute TTL on identical VAT IDs) absorb the majority of short outages transparently. For the full per-country fallback status, see the coverage matrix.

Croatia VAT API – FAQ

Is the Croatia VAT number the same as the company registration number?

The Croatian PDV number identifies the business for VAT. vatnode does not return a company register number for Croatia, so registryCode is null. The part after the HR prefix is the personal identification number (osobni identifikacijski broj), returned in taxId.

How fast is Croatia VAT validation through vatnode?

Cached responses return in single-digit milliseconds. Live VIES lookups for Croatia typically complete in under one second; a 15-minute Redis cache is applied to identical VAT IDs.

Does the API work for Croatian sole traders and small businesses?

Yes. If a Croatian sole trader or small business is registered for PDV and listed in VIES, vatnode validates the number and returns the same response shape as for corporate entities. The valid field is true regardless of legal form.

Does vatnode handle VIES outages for Croatia?

vatnode caches recent VIES responses and surfaces a clear VIES_UNAVAILABLE error code with structured retry guidance. vatnode does not use a national validity fallback for Croatia — only the VAT register itself can confirm a VAT registration, so during a VIES outage validation defers to the cached result or returns the error for safe handling.

What is the consultation number returned for checks in Croatia?

The consultationNumber is the VIES requestIdentifier — a reference returned by VIES that proves the check was performed against the official EU register on a specific date. It shows that you checked, not that the counterparty stayed valid afterwards, and it is returned once you set your own VAT as requester in dashboard Account details — including for Croatia.

VAT APIs for Other EU Countries

Start Validating Croatia VAT Numbers

100 validations per month on the free plan, no credit card required. REST JSON over HTTPS, VIES consultation number on qualified checks, EU-hosted by default.

Get a free API key Croatia VAT format reference Quickstart