How do I look up a Finnish company by Y-tunnus from an API?

Call GET /companies/search with company_number=0112038-9 and country=FI. The hyphen is optional, and a number whose check digit does not match is refused with a 400 validation error instead of returning an empty list.

Can I look up a Finnish company by its VAT number?

Yes. Pass vat=FI01120389 with country=FI. The Finnish VAT number is FI followed by the eight digits of the Y-tunnus without the hyphen, and it resolves to the same company as the Y-tunnus.

Does the Finnish record include officers or company events?

No. Finland is company-level: legal name, legal form, status, registered address, activity code and dates. There are no officers, no corporate-event stream and no monitoring. Corporate insolvency notices are linked by business ID.

Does it cover Finnish sole traders?

No. Sole traders are not part of the Finnish company records, so a lookup of one returns nothing even though the business exists.

How much does the Finland company data API cost?

Finland is included in every tier at no upcharge. Free is a 14-day trial with 1,000 API calls per month and no credit card; subscribing keeps the same key working. Paid tiers run from EUR 9.99 to EUR 99.99 a month, monthly or annual.

Finland company data API: look up and validate a Y-tunnus

A customer types a Y-tunnus, a Finnish VAT number or the first letters of a name; your form fills in the legal name, legal form, status and registered address from the Finnish Trade Register. One key and one response shape, the same as Spain, France, the UK, Ireland, Poland and Norway.

Company records from the Finnish Trade Register: legal name, legal form, status, registered address, activity code and dates; no officers, no corporate-event stream, no monitoring. Corporate insolvency notices are linked by business ID.

What the Finnish record gives your product

Exact match on the Y-tunnus: company_number=0112038-9 with country=FI. The hyphen is optional and the check digit is verified server-side.
The VAT number as an alias: vat=FI01120389 reaches the same company.
Autocomplete by name: a normalised, partial match ranked by a match score, one call per keystroke.
The fields a form needs: legal name, legal form, status, registered address and postal code, city, activity code and the registration date.
The linked insolvency notices: include=insolvency on the company returns the corporate notices filed under that business ID.

Validate before you call

A Y-tunnus carries a modulus-11 check digit (weights 7, 9, 10, 5, 8, 4, 2 over the seven digits before the hyphen), so a mistyped number can be rejected in your own code before it costs a call. The free identifier validator and a ten-line JavaScript function on the full page do exactly that.

What Finland does not carry

No officers or board members, no corporate-event stream, no monitoring watchlists, no financial statements and no beneficial owners. Sole traders are not part of the Finnish records.

Pricing

Free — 14-day trial. 1,000 API calls per month, 10 requests/minute, no credit card. Subscribing keeps the same key working. Then Starter at €9.99/month, Professional at €29.99/month and Scale at €99.99/month, monthly or annual.

Read the full page · Try the free Y-tunnus lookup · Get a free API key

What the Finnish record gives your product

Field	What it holds for Finland
`company_number`	The Y-tunnus, written with the hyphen: `0112038-9`.
`company_name`	The registered name.
`legal_form`	The register’s form code, such as OY, OYJ, KY, AOY, with the full Finnish name in `legal_form_full`.
`status`	The register’s status, including the bankruptcy, liquidation and restructuring situations it flags. Canonical readings, `status_canonical` and `stage`, sit beside it where the value is recognised.
`address`, `postal_code`, `city`	The street address (or a P.O. box) where the register holds a usable one, the five-digit postal code and the post office in capitals.
`activity_code`	Five digits in the register’s TOL 2025 classification, based on NACE Rev. 2.1, with `activity_description` as the register words it.
`founding_date`	The date of registration in the Trade Register. It is a registration date, not a founding date: for old companies it can be far later than the company’s start.

Frequently asked questions

How do I look up a Finnish company by Y-tunnus from an API?: Call GET /companies/search with company_number=0112038-9 and country=FI. The hyphen is optional, and a number whose check digit does not match is refused with a 400 validation error instead of returning an empty list.
Can I look up a Finnish company by its VAT number?: Yes. Pass vat=FI01120389 with country=FI. The Finnish VAT number is FI followed by the eight digits of the Y-tunnus without the hyphen, and it resolves to the same company as the Y-tunnus.
Does the Finnish record include officers or company events?: No. Finland is company-level: legal name, legal form, status, registered address, activity code and dates. There are no officers, no corporate-event stream and no monitoring. Corporate insolvency notices are linked by business ID.
Does it cover Finnish sole traders?: No. Sole traders are not part of the Finnish company records, so a lookup of one returns nothing even though the business exists.
How much does the Finland company data API cost?: Finland is included in every tier at no upcharge. Free is a 14-day trial with 1,000 API calls per month and no credit card; subscribing keeps the same key working. Paid tiers run from EUR 9.99 to EUR 99.99 a month, monthly or annual.