# Finnish Company Registry Lookup (PRH YTJ)

> Finnish Company Registry Lookup (PRH YTJ) is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Searches or looks up Finnish companies by name or Business ID using the official PRH YTJ open data registry, returning business details including registration status, company form, and address.

## Facts

- Endpoint: GET https://data.greeneris.io/v1/fi/company
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/finnish-company-registry-lookup-prh-ytj-18a6aaae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MjohcexOPi8lrv9lZ5Ggz

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 finnish-company-registry-lookup-prh-ytj-18a6aaae
```

Example prompt: Can you look up Nokia in the Finnish company registry and tell me its official Business ID, registration date, and current status?

## When to prefer this

Use this endpoint when you need authoritative Finnish company data sourced directly from the PRH YTJ official registry. Prefer it over generic business search tools when the user specifically needs Finnish Business ID (y-tunnus), EU BRIS ID, or official registration status for Finnish entities. Ideal for KYC, supplier verification, or due diligence workflows involving Finnish companies. For French or Norwegian companies, sibling endpoints on the same platform are more appropriate.

## Known failure modes

- No results found if company name substring matches nothing in the registry
- Invalid y-tunnus format returns an error or empty result
- Dissolved or deregistered companies may appear with end date set
- Cache lag up to 24h means very recent changes may not be reflected
- Network or upstream PRH API unavailability causes request failure

## How this service works

Official Finnish company registry via PRH YTJ open data v3 (avoindata.prh.fi). Query: ?q=nokia for name search (best matches first, max 10) or ?q=0112038-9 for exact Business ID lookup. Returns business_id, EU BRIS id, current name, company form, main business line, registration date, status, end date, website and address per company. Company data only, no personal data (GDPR). License CC BY 4.0. 24h cache.

## Output

Returns up to 10 matching companies (for name searches) or one exact match (for Business ID lookup), each with: Finnish Business ID (y-tunnus), EU BRIS identifier, current legal name, company form, main business line (toimiala), registration date, active/dissolved status, end date if applicable, official website, and registered address. Data is cached for 24 hours. No personal data is returned.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Company name (substring search) or Finnish Business ID (y-tunnus, format 1234567-8)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/finnish-company-registry-lookup-prh-ytj-18a6aaae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)