Finland VAT API — Validate Finland VAT Numbers in Real Time
REST JSON endpoint for verifying Arvonlisävero (ALV) numbers against the official EU VIES register, with national registry fallback where available and a VIES consultation number on every successful check.
Why a Finland-aware VAT API
In Finland, VAT is known as Arvonlisävero (ALV) and the current standard rate is 25.5%. Every Finland VAT number starts with the prefix FI and follows a fixed structure issued by the Finland tax authority. A generic VAT validator that ignores country-specific quirks will accept malformed input, miss the country's format rules, and fail to surface the local registry identifier that accountants and auditors actually need.
The vatnode API normalises ALV input, runs the official VIES check, falls back to the Finland national company registry when VIES is unavailable, and returns a single JSON shape with the consultation number, company data where published, and the current Finland VAT rates inline.
Finland VAT number format
FI + 8 digits^FI\d{8}$Real Finland VAT numbers you can validate right now:
- FI01120389 — Nokia Oyj
- FI19274001 — KONE Oyj
- FI26466749 — Wolt Oy
Validating Finland VAT numbers — code examples
All three examples validate the same Finland VAT number FI01120389.
curl https://api.vatnode.dev/v1/vat/FI01120389 \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch(
'https://api.vatnode.dev/v1/vat/FI01120389',
{ headers: { Authorization: `Bearer ${process.env.VATNODE_API_KEY}` } }
)
const data = await res.json()
console.log(data.valid, data.companyName, data.consultationNumber)import os, httpx
r = httpx.get(
"https://api.vatnode.dev/v1/vat/FI01120389",
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 Finland VAT number looks like this:
{
"valid": true,
"vatId": "FI01120389",
"countryCode": "FI",
"countryName": "Finland",
"companyName": "Nokia Oyj",
"consultationNumber": "WAPIAAAAXk7ZpY3o",
"source": "VIES",
"countryVat": {
"currency": "EUR",
"standardRate": 25.5,
"reducedRates": [10,13.5],
"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.
Finland VAT rates
vatnode returns the current Finland ALV rates inline with every successful response. Today's rates (standard 25.5%, reduced 10%, 13.5%) are sourced from the European Commission TEDB feed and refreshed daily.
| Rate type | Value |
|---|---|
| Standard | 25.5% |
| Reduced (1) | 10% |
| Reduced (2) | 13.5% |
VIES vs national fallback for Finland
VIES is the primary data source for Finland validation — it is the authoritative EU register and the only source that produces a consultation number. When VIES returns a transient error (timeout, MS_UNAVAILABLE, SERVICE_UNAVAILABLE), vatnode automatically queries the Finland national company registry as a fallback so your checkout or invoicing pipeline keeps working.
The response includes a source field that tells you which system answered — VIES for the EU register, or the Finland national-registry source code when the fallback ran.
Finland is one of the EU countries where vatnode keeps validating during EU VIES outages via a direct national registry adapter. See coverage matrix for the full list.
Finland VAT API — FAQ
Is the Finland VAT number the same as the company registration number?
No. The Finland ALV number is issued by the tax authority for VAT purposes; the national registry identifier is a separate ID issued by the company registry. vatnode returns both fields (registryCode + registryCodeName) for Finland when the data is available.
How fast is Finland VAT validation through vatnode?
Cached responses return in single-digit milliseconds. Live VIES lookups for Finland typically complete in under one second; a 15-minute Redis cache is applied to identical VAT IDs.
Does the API work for Finland sole traders and small businesses?
Yes. If a Finland sole trader or small business is registered for ALV 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.
What happens if EU VIES is down for Finland?
vatnode falls back to the Finland national registry adapter when VIES returns a transient error (timeout, MS_UNAVAILABLE). Validation keeps working from the national source; the response includes a source field so you can tell which system answered.
What is the consultation number returned for Finland checks?
The consultationNumber is the VIES requestIdentifier — a unique reference issued by the EU VIES service that proves the check was performed against the official EU register on a specific date. It is the EU's documented mechanism for "reasonable care" evidence under the reverse-charge rules and is returned on every successful VIES validation, including Finland.
See also
Start validating Finland VAT numbers
100 validations per month on the free plan, no credit card required. REST JSON over HTTPS, VIES consultation number on every check, Finland national registry fallback, EU-hosted by default.