# Finland YTJ Business Register Search

> Finland YTJ Business Register Search is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Searches the Finnish YTJ/PRH open business register by company name and returns business ID, registration date, company form, and name history.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/b2b/finland-ytj-companies?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/finland-ytj-business-register-search-7dec8fe9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VBt06qySZ8ZWbHJwWHFjm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability finland-ytj-business-register-search-7dec8fe9
```

Example prompt: Can you look up 'Wärtsilä' in the Finnish business register and tell me its business ID, registration date, and current company form?

## When to prefer this

Choose this endpoint when you need to look up official Finnish company registration data (business ID, legal form, registration date) from the authoritative PRH/YTJ public register. Prefer this over generic web searches when you need structured, reliable Finnish company identifiers for B2B onboarding, contract filing, or due diligence. It covers all Finnish legal entities but does not include financial, credit, or ownership information.

## Known failure modes

- No results found if company name is too generic or misspelled
- Query string shorter than 2 or longer than 80 characters will fail validation
- Limit parameter outside 1–25 range may be rejected
- PRH upstream API unavailability may cause errors
- Returns partial name matches which may include unintended companies
- Status field is a code (e.g. '2') without inline label — agent must interpret separately

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A JSON object containing the search query, source URL, checked timestamp, total results count, and an array of matching companies each with: name, business ID, status code, company forms (e.g. Aktiebolag, Julkinen osakeyhtiö), registration date, and full name history with date ranges.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Company name, 2 to 80 characters"
      },
      "limit": {
       "type": "string",
       "description": "Rows to return, 1 to 25 (default 10)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "nokia",
  "source": "https://avoindata.prh.fi/opendata-ytj-api/v3/companies",
  "results": [
   {
    "name": "Fysios Mehiläinen Oy",
    "status": "2",
    "businessId": "0194099-3",
    "nameHistory": [
     {
      "name": "Fysios Mehiläinen Oy",
      "registeredFrom": "2024-07-16",
      "registeredUntil": "2026-04-30"
     },
     {
      "name": "Fysios Oy",
      "registeredFrom": "2017-12-31",
      "registeredUntil": "2024-07-16"
     }
    ],
    "companyForms": [
     "Aktiebolag"
    ],
    "registrationDate": "1978-06-09"
   },
   {
    "name": "Tikkurila Oyj",
    "status": "2",
    "businessId": "0197067-4",
    "nameHistory": [
     {
      "name": "Tikkurila Oyj",
      "registeredFrom": "2010-02-17",
      "registeredUntil": null
     },
     {
      "name": "Tikkurila Oy",
      "registeredFrom": "1985-12-31",
      "registeredUntil": "2010-02-16"
     }
    ],
    "companyForms": [
     "Aktiebolag",
     "Julkinen osakeyhtiö"
    ],
    "registrationDate": "1978-06-16"
   }
  ],
  "checkedAt": "2026-10-23T09:37:38.775Z",
  "totalResults": 991
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/finland-ytj-business-register-search-7dec8fe9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)