{"uid":"cap_j57uLYAcarKJSNZia6HY1","slug":"finnish-company-registry-lookup-prh-ytj-95941d3c","name":"Finnish Company Registry Lookup (PRH/YTJ)","description":"Finnish company lookup in the official PRH/YTJ Business Information System by business ID (Y-tunnus) or company name. Returns legal name, status, company form, registration date, address, main business line and website in a schema shared across countries.","url":"https://companies.use.x402atlas.com/finnish-company-data?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":["query"],"properties":{"query":{"type":"string","maxLength":200,"description":"Company registration number (Finnish business ID, e.g. 0112038-9) or company name"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["country","registry","query","matched_by","count","companies"],"properties":{"note":{"type":"string","description":"Hint present only on the sample response (empty/omitted query) and on a zero-match response"},"count":{"type":"integer","description":"Number of entries in companies"},"query":{"type":"string","description":"Echoed query (trimmed)"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 code of the route's country"},"registry":{"type":"string","description":"Official registry the result comes from"},"companies":{"type":"array","items":{"type":"object","required":["name","registration_number","status","legal_form","founded","address","activities","website"],"properties":{"name":{"type":"string","description":"Current legal name"},"status":{"enum":["active","inactive","unknown"],"type":"string","description":"Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown"},"address":{"type":"object","required":["street","postal_code","city","country_code"],"properties":{"city":{"type":["string","null"],"description":"City or post town"},"street":{"type":["string","null"],"description":"Street and house number"},"postal_code":{"type":["string","null"],"description":"Postal code"},"country_code":{"type":["string","null"],"description":"ISO 3166-1 alpha-2 country code of the address"}},"description":"Registered (head-office) address; each part is null when the registry does not supply it"},"founded":{"type":["string","null"],"format":"date","description":"Founding / registration date (YYYY-MM-DD)"},"website":{"type":["string","null"],"description":"Company website as registered; may lack a URL scheme"},"activities":{"type":"array","items":{"type":"object","required":["code","description"],"properties":{"code":{"type":"string","description":"Registry activity code (NACE, NAF or SIC, as the registry publishes it)"},"description":{"type":["string","null"],"description":"Activity description; null when the registry supplies only the code"}}},"maxItems":5,"description":"Up to 5 registered activities, main activity first when the registry marks one; empty when none are published"},"legal_form":{"type":["string","null"],"description":"Legal form as the registry names it, or the registry's legal-form code when it publishes no name"},"registration_number":{"type":"string","description":"Canonical national registration number (BE enterprise number, FR SIREN, GB company number, NO organisasjonsnummer, FI business ID, CZ ICO)"}}},"maxItems":5,"description":"Matching companies; empty when nothing matched (still HTTP 200)"},"matched_by":{"enum":["number","name"],"type":"string","description":"number: the query was read as a registration number (exact lookup, 0 or 1 company); name: company-name search (up to 5 companies)"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MTCUYYpOKT9ar6G8fsRiG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up Finnish companies in the official PRH/YTJ Business Information System by business ID (Y-tunnus) or company name, returning standardized legal and registration data.","exampleAgentPrompt":"Can you look up the Finnish company with business ID 0112038-9 in the official PRH/YTJ registry and tell me its legal name, status, address, and main business activity?","exampleUseCases":[{"title":"KYC due diligence on Finnish supplier","prompt":"I need to onboard a new Finnish supplier — their Y-tunnus is 2181212-4. Can you pull their official registration details from the Finnish business registry, including their legal name, status, address, and what industry they operate in?"},{"title":"Verify Finnish company status before contract","prompt":"Before we sign this contract, can you check whether a Finnish company called 'Nokia Oyj' is currently active in the official PRH registry and confirm their registered address and legal form?"},{"title":"Enrich CRM with Finnish company data","prompt":"I have a list of Finnish companies I need to enrich — start with 'Kone Corporation'. Look them up in the Finnish YTJ registry and give me their business ID, founding date, registered address, and primary business activity."}],"resultDescription":"Returns a structured JSON object with: ISO country code (FI), registry name (PRH/YTJ), echoed query, match count, and an array of matched companies each containing legal name, registration number (Y-tunnus), normalized status (active/inactive/unknown), legal form, founding date, postal address (street, postal code, city, country code), main business activities, and website URL.","failureModes":["No match found for the given business ID or company name — returns empty companies array with count 0 and a note","Invalid or malformed Y-tunnus format may return zero results","Company name search may return multiple partial matches requiring disambiguation","Network or upstream PRH/YTJ registry downtime could result in service unavailability","Truncated or outdated registry data if PRH hasn't propagated recent changes"],"whenToPreferThis":"Use this endpoint when you need authoritative, structured data on Finnish legal entities specifically — it queries the official PRH/YTJ source rather than third-party aggregators. Prefer it over generic business search tools when you need Y-tunnus validation, official Finnish company status, or legally-sourced address and registration data for compliance, KYC, or contract verification workflows involving Finnish companies.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:39:02.442Z","isFirstParty":false,"canonicalSlug":"finnish-company-registry-lookup-prh-ytj-a4581a45"}