nvNeuralVerge
Corporate registry

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.
Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

ApproachWhat it takesCostTrade-off
PRH / YTJ directlyOpen PRH / YTJ and read the recordUsually free, sometimes per-documentA different interface, language and data shape for every country you add
Collecting it yourselfBuild and host a crawler per register, then keep each one aliveInfrastructure and maintenanceRegisters change their pages without warning, and nobody is on the hook when yours breaks
NeuralVergeOne request, the same shape as every other source in the catalog$5 per 1,000, misses not billedCovers Finland — other countries are separate sources with the same request format
Response

What you get back

Every field in the example response below.

FieldTypeDescription
registration_numberstringBusiness ID.
namestringCompany name.
statusstringCompany status, for example Active.
addressstringStreet address on one line.
urlstringLink to the company on the register.
company_typestringLegal form, for example Public limited company.
incorporation_datestringRegistration date, YYYY-MM-DD.
activitystringMain line of business.
activity_codestringIndustry code of the main line of business.
business_id_datestringDate the Business ID was given.
termination_datenullEnd date. Null in the sample because the company is active.
street_addressstringStreet address.
postal_addressstringPostal address.
home_municipalitystringHome municipality.
languagestringCompany language.
websitestringCompany website.
eu_idstringEuropean unique identifier.
company_name_start_datestringDate the current name took effect.
previous_namesarrayEarlier names with value, start_date and end_date.
parallel_namesarrayParallel names with name and start_date.
auxiliary_namesarrayAuxiliary names with name and start_date.
phonenullPhone number. Null in the sample.
phone_registeredbooleanWhether a phone number is registered.
registrationsarrayRegister entries with register, status and start_date, for example Trade register and Tax Administration.
register_historyarrayRegister history entries. Empty in the sample.
prepayment_register_check_datesstringDates of prepayment register checks, as text.
tax_debtobjecttaxes_owed, filing_negligence and last_update. Text from the register, with last_update null in the sample.
business_id_historyarrayBusiness ID events with date, event, description and related_business_id.
detailsarrayDetail blocks with label, current values (value, start_date, source) and previous values.
requested_idstringThe Business ID that was requested.
Response

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
}
Integration

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"}'
Use cases

What teams use it for

Where this field shows up in an actual workflow.

Supplier and customer checks

Confirm status, legal form, registrations and tax debt status for a Finnish counterparty.

Match company names

Parallel, auxiliary and previous names help match a company that trades under several names.

Follow mergers

Business ID history records events such as a merger and points to the related Business ID.

Account enrichment

Add industry code, municipality and website to company records.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

Finland — entities on PRH / YTJ.

Freshness

Read at request time, so the answer reflects the register as it stands when you ask.

Handling

PRH / YTJ is a public register. Every response carries the source URL it was read from and a session id you can trace.

What it will not do
  • —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.
FAQ

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

Related sources

Try ytj company on your own data

One request format across every source in the catalog.

Get started