# Finnish YTJ Company Lookup

> Finnish YTJ Company Lookup is a paid API for AI agents from agentdata-api.sander-van-aard.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Looks up Finnish company information from the official YTJ (PRH) business register by Business ID or name search

## Facts

- Endpoint: POST https://agentdata-api.sander-van-aard.workers.dev/fi/company
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/finnish-ytj-company-lookup-766a6617
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E8L1KT1TwEFq3dnVtfdNl

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-ytj-company-lookup-766a6617 -d '<json body>'
```

Example prompt: Can you look up the Finnish company with Business ID 0112038-9 in the YTJ register and tell me its official name, company form, registration status, and whether it's currently active or in any special situation like bankruptcy?

## When to prefer this

Use this endpoint when you need authoritative, official Finnish company data directly from the PRH/YTJ government register. Prefer this over generic web searches or third-party business data providers when you need legally reliable information about Finnish companies including their bankruptcy or liquidation status. Particularly useful for KYC, supplier verification, or contract due diligence involving Finnish entities.

## Known failure modes

- Business ID not found in YTJ register — returns empty or not-found response
- Name search returns 0 matches if no companies match the query
- Ambiguous name search may return up to 5 candidates requiring further disambiguation
- YTJ upstream service unavailable — upstream API error propagated
- Invalid Business ID format — validation error
- Payment not completed — 402 response requiring x402 payment

## How this service works

Official Finnish company check from the YTJ register (PRH open data). Look up by Business ID (exact) or search by name (up to 5 candidates). Returns the current official name, company form, main business line, registration/end dates, address, raw YTJ status codes and registered company situations such as bankruptcy or liquidation, with a direct YTJ link. Companies only.

## Output

Returns the current official company name, company form (e.g. OY, OYJ), main business line, registration and possible end dates, registered address, raw YTJ status codes, any special situations such as bankruptcy or liquidation, and a direct link to the YTJ profile page. For name searches, returns up to 5 candidate matches.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "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-ytj-company-lookup-766a6617/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdata-api.sander-van-aard.workers.dev](https://www.zero.xyz/host/agentdata-api.sander-van-aard.workers.dev/llms.txt)