# Finnish Company Registry Lookup (PRH YTJ)

> Finnish Company Registry Lookup (PRH YTJ) is a paid API for AI agents from x402-datashop-production.up.railway.app, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-10).

Search the official Finnish business registry by company name or Business ID (y-tunnus) to retrieve structured company data including registration details, status, address, and business line.

## Facts

- Endpoint: GET https://x402-datashop-production.up.railway.app/v1/fi/company?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/finnish-company-registry-lookup-prh-ytj-46948a67
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YNYi7WLN1RFJIfwuqJASs

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-46948a67
```

Example prompt: Can you look up the Finnish business registry for a company called Nokia — I need their Business ID, company form, registration date, current status, and registered address?

## When to prefer this

Use this endpoint when you need authoritative, structured data from the official Finnish business registry (PRH YTJ). Prefer it over general web searches when you need verified Business IDs, company status, registration dates, legal form, or EU BRIS IDs for Finnish companies. Ideal for due diligence, KYC enrichment, compliance checks, or resolving Finnish entity identities. Not suitable for retrieving personal data about company officers.

## Known failure modes

- No results found if the company name or Business ID does not match any registered entity
- Incorrect Business ID format (must be format 1234567-8) may cause lookup failure
- Up to 24-hour data staleness due to caching — very recently registered or dissolved companies may not reflect current state
- Network or upstream PRH API unavailability may cause service errors
- Payment failure (insufficient USDC balance) blocks access with a 402 response

## 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 (best matches first for name searches, exact match for Business ID queries), each with: business_id, EU BRIS id, current name, company form, main business line, registration date, status, end date (if dissolved), website, and address. Data is sourced from PRH YTJ open data, cached for 24 hours, and contains no personal data (GDPR-compliant). Licensed under CC BY 4.0.

## 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-46948a67/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-datashop-production.up.railway.app](https://www.zero.xyz/host/x402-datashop-production.up.railway.app/llms.txt)