Finland Company Registry (YTJ) API and MCP — Company Data by Business ID
Send a Finnish Business ID (Y-tunnus) or the link to the company on the register and this source returns the record: name, status, legal form, registration date, addresses, main line of business, registrations, tax debt status and Business ID history.
- You send
- A Finnish Business ID (Y-tunnus) or a link to the company on the register
- You get back
- Name, status, legal form, address, industry, names, registrations, tax debt status and Business ID history
- Coverage
- Finland — entities on PRH / YTJ.
- Price
- 5 pts — $5 per 1,000
- Charged only when the record resolves. A lookup that finds nothing is not billed.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| PRH / YTJ directly | Open PRH / YTJ and read the record | Usually free, sometimes per-document | A different interface, language and data shape for every country you add |
| Collecting it yourself | Build and host a crawler per register, then keep each one alive | Infrastructure and maintenance | Registers change their pages without warning, and nobody is on the hook when yours breaks |
| NeuralVerge | One request, the same shape as every other source in the catalog | $5 per 1,000, misses not billed | Covers Finland — other countries are separate sources with the same request format |
What you get back
Every field in the example response below.
| Field | Type | Description |
|---|---|---|
registration_number | string | Business ID. |
name | string | Company name. |
status | string | Company status, for example Active. |
address | string | Street address on one line. |
url | string | Link to the company on the register. |
company_type | string | Legal form, for example Public limited company. |
incorporation_date | string | Registration date, YYYY-MM-DD. |
activity | string | Main line of business. |
activity_code | string | Industry code of the main line of business. |
business_id_date | string | Date the Business ID was given. |
termination_date | null | End date. Null in the sample because the company is active. |
street_address | string | Street address. |
postal_address | string | Postal address. |
home_municipality | string | Home municipality. |
language | string | Company language. |
website | string | Company website. |
eu_id | string | European unique identifier. |
company_name_start_date | string | Date the current name took effect. |
previous_names | array | Earlier names with value, start_date and end_date. |
parallel_names | array | Parallel names with name and start_date. |
auxiliary_names | array | Auxiliary names with name and start_date. |
phone | null | Phone number. Null in the sample. |
phone_registered | boolean | Whether a phone number is registered. |
registrations | array | Register entries with register, status and start_date, for example Trade register and Tax Administration. |
register_history | array | Register history entries. Empty in the sample. |
prepayment_register_check_dates | string | Dates of prepayment register checks, as text. |
tax_debt | object | taxes_owed, filing_negligence and last_update. Text from the register, with last_update null in the sample. |
business_id_history | array | Business ID events with date, event, description and related_business_id. |
details | array | Detail blocks with label, current values (value, start_date, source) and previous values. |
requested_id | string | The Business ID that was requested. |
Example response
A real response, as returned.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "fi_company",
"company": "0112038-9",
"company_id": "0112038-9",
"human": "# Finland — PRH / YTJ — company\n\n- **Number:** 0112038-9\n- **Pages opened:** 1\n- **Proxy traffic:** 51.3 KB\n- **Name:** Nokia Oyj\n- **Status:** Active\n- **Type:** Public limited company\n- **Registered:** 1896-12-19\n- **Address:** Karakaari 7 02610 ESPOO",
"machine": {
"company": {
"registration_number": "0112038-9",
"name": "Nokia Oyj",
"status": "Active",
"address": "Karakaari 7 02610 ESPOO",
"url": "https://tietopalvelu.ytj.fi/en/yritys/0112038-9",
"company_type": "Public limited company",
"incorporation_date": "1896-12-19",
"activity": "Activities of head offices",
"activity_code": "70100",
"business_id_date": "1978-03-15",
"termination_date": null,
"street_address": "Karakaari 7 02610 ESPOO",
"postal_address": "P.O. Box 226 00045 NOKIA GROUP",
"home_municipality": "HELSINKI",
"language": "Finnish",
"website": "www.nokia.com",
"eu_id": "FIFPRO.0112038-9",
"company_name_start_date": "1997-09-01",
"previous_names": [
{
"value": "Oy Nokia Ab",
"start_date": "1966-06-10",
"end_date": "1997-08-31"
}
],
"parallel_names": [
{
"name": "Nokia Abp",
"start_date": "1997-09-01"
},
{
"name": "Nokia Corporation",
"start_date": "1997-09-01"
}
],
"auxiliary_names": [
{
"name": "Vertu",
"start_date": "2006-03-08"
},
{
"name": "TCC Nokia",
"start_date": "2004-11-12"
}
],
"phone": null,
"phone_registered": true,
"registrations": [
{
"register": "Trade register",
"status": "Registered",
"start_date": "1896-12-19"
},
{
"register": "Tax Administration",
"status": "Registered",
"start_date": "1978-03-15"
}
],
"register_history": [],
"prepayment_register_check_dates": "1 March, 1 June, 1 September and 1 December",
"tax_debt": {
"taxes_owed": "No record of tax debts.",
"filing_negligence": "No register entries that would indicate non-filing of the Return for Self-Assessed Taxes.",
"last_update": null
},
"business_id_history": [
{
"date": "1978-03-15",
"event": "ID given",
"description": null,
"related_business_id": null
},
{
"date": "1999-08-25",
"event": "Fusion",
"description": "Business 0732607-0 merged into 0112038-9 .",
"related_business_id": "0732607-0"
}
],
"details": [
{
"label": "Business ID",
"values": [
{
"value": "0112038-9",
"start_date": "1978-03-15",
"source": "Business Information System"
}
],
"previous": []
},
{
"label": "Company name",
"values": [
{
"value": "Nokia Oyj",
"start_date": "1997-09-01",
"source": "Finnish Patent and Registration Office"
}
],
"previous": [
{
"value": "Oy Nokia Ab",
"start_date": "1966-06-10",
"end_date": "1997-08-31"
}
]
}
],
"requested_id": "0112038-9"
},
"blocked": false,
"pages_opened": 1,
"proxy_traffic_bytes": 52535
},
"total_points": 5
}How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
One company per request. Pass the registration number or the link to the record on the register.
curl -X POST https://api.neuralverge.ai/functions/v1/run-fi-companies \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"company":"0112038-9"}'What teams use it for
Where this field shows up in an actual workflow.
Confirm status, legal form, registrations and tax debt status for a Finnish counterparty.
Parallel, auxiliary and previous names help match a company that trades under several names.
Business ID history records events such as a merger and points to the related Business ID.
Add industry code, municipality and website to company records.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Finland — entities on PRH / YTJ.
Read at request time, so the answer reflects the register as it stands when you ask.
PRH / YTJ is a public register. Every response carries the source URL it was read from and a session id you can trace.
- —Status, phone and some date fields can be null depending on what the register holds.
- —Tax debt fields are text from the register, not figures.
- —The record covers one company per request.
Questions, answered
Finland's company identifier, also called Y-tunnus, in the form 0112038-9. You can send it with the hyphen, as in the sample.
Related sources
Find Finnish companies by name and get their Business IDs.
One Norwegian company by organisation number, with roles, auditor and liens.
One Swedish company by organisation number, with status history and business names.
Company registers across Europe, the Americas and Asia-Pacific, plus global LEI lookup.
Try ytj company on your own data
One request format across every source in the catalog.