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 once you set your own VAT as requester in dashboard Account details.
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 Finnish tax authority. A generic VAT validator that ignores country-specific quirks will accept malformed input and miss the country’s format rules, and fail to surface the local register number that accountants and auditors actually need.
The vatnode API normalises ALV input, runs the official VIES check, 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
More of them live in the EU VAT number directory, grouped by member state.
Validating Finland VAT Numbers – Code Examples
All three examples validate the same Finland VAT number FI01120389. 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 '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 FinlandVAT number, once you've set your VAT as requester in dashboard Account details, 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. It is returned once you set your own VAT as requester in dashboard Settings; otherwise it is null.
Finland VAT Rates
vatnode returns the current Finnish 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, checked daily and updated on any change.
| Rate type | Value |
|---|---|
| Standard | 25.5% |
| Reduced (1) | 10% |
| Reduced (2) | 13.5% |
VIES vs National Fallback for Finland
For Finland, 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.
Finland VAT API – FAQ
Is the Finland VAT number the same as the company registration number?
Almost. For a company, the Finnish ALV number is built from its Business ID. vatnode returns that number on its own in registryCode, in its national format, with its local name (Y-tunnus) in registryCodeName.
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 Finnish sole traders and small businesses?
Yes. If a Finnish 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.
Does vatnode handle VIES outages for Finland?
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 Finland — 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 Finland?
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 Finland.
More on Finland
- Finland VAT rates and historyCurrent standard and reduced rates, and every past change.
- Finland VAT number formatNumber structure, regex pattern and verified examples.
- Finland Reverse charge rulesWhen to zero-rate a cross-border B2B invoice, and what to write on it.
- Finland VIES uptimeAvailability of this country in the Commission database, sampled continuously.
VAT APIs for Other EU Countries
See Also
- vatnode Quickstart – API key in 60 seconds
- VAT validation reference – endpoint, parameters, error codes
- Finland VAT number format, rates, and verified examples
- Validate Finland VAT numbers from AI agents (Claude, Cursor) via MCP
Building an AI workflow? vatnode is also available to AI agents through the official MCP server — Claude, Cursor and ChatGPT can validate Finland VAT numbers and look up rates directly in chat.
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 qualified checks, EU-hosted by default.