# Finland YTJ Company Register API

> Finnish companies by name, business ID, industry or town: names, forms, addresses, status

- Vendor: `finlandytjcompanyregisterapi` · version 1.0 · category Business · tags ytj api, prh api, finland company api, finnish business id api, y-tunnus api, company register api, kyb api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/finlandytjcompanyregisterapi
- This document: https://apiclay.com/docs/finlandytjcompanyregisterapi.md
- OpenAPI 3.1: https://apiclay.com/api/finlandytjcompanyregisterapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `finlandytjcompanyregisterapi`
- Updated: 2026-11-18

## About

## Finland YTJ Company Register API

Search the Finnish Business Information System (YTJ, run by the Finnish Patent and Registration Office and the Tax Administration): every company's business ID (Y-tunnus), current and past names, company form, main line of business (TOL code), addresses, register entries and status.

Data comes from **prh.fi** (https://tietopalvelu.ytj.fi). Every route calls the source's own public JSON endpoint (found with the live-URL scan of https://tietopalvelu.ytj.fi) and returns it unchanged.

Typical flow: `/companies?name=` or `/companies?businessId=`.

### Routes

#### GET `/companies` - Search companies
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| name | query | string | no | Company name, e.g. `nokia`. |
| businessId | query | string | no | Business ID, e.g. `0112038-9`. |
| location | query | string | no | Town, e.g. `Helsinki`. |
| companyForm | query | string | no | e.g. `OY`, `OYJ`, `KY`. |
| mainBusinessLine | query | string | no | TOL 2008 code or text, e.g. `62010`. |
| postCode | query | string | no | Postal code. |
| registrationDateStart | query | string | no | yyyy-mm-dd. |
| registrationDateEnd | query | string | no | yyyy-mm-dd. |
| page | query | number | no | Page, from 1 (100 per page). |

Returns: `totalResults` and `companies[]` with `businessId.value`, `names[]`, `companyForms[]`, `mainBusinessLine` (code and descriptions), `addresses[]`, `registeredEntries[]`, `status`, `registrationDate`, `endDate`.

### License

Open data under CC BY 4.0 from the Finnish Patent and Registration Office (PRH).

### Caveats

- A broad name search returns up to 100 companies per page (about 200 KB).
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by prh.fi.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /companies — Search companies
- Gateway: `GET https://api.apiclay.com/v1/api/finlandytjcompanyregisterapi/companies`
- Public query params: `name` (string), `businessId` (string), `location` (string), `companyForm` (string), `mainBusinessLine` (string), `postCode` (string), `registrationDateStart` (string), `registrationDateEnd` (string), `page` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/finlandytjcompanyregisterapi/companies" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
