{"uid":"cap_U_8AM-xZsAXxrF3m8GKEu","slug":"finnish-company-registry-lookup-prh-ytj-a4581a45","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/fi?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_mF_DMqy7zZ5iCQ03B1qhr","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 contact details.","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, current status, registered address, and main business activity?","exampleUseCases":[{"title":"Verify Finnish supplier before onboarding","prompt":"Before we onboard this Finnish vendor, can you check if the company Kone Oyj is active and get its official registered address and business line from the Finnish PRH registry?"},{"title":"Due diligence on Finnish business partner","prompt":"I need to do a quick due diligence check — look up the Finnish company with Y-tunnus 0112038-9 and tell me its legal name, company form, when it was founded, and whether it's currently active."},{"title":"Find Finnish company contact details","prompt":"I'm trying to reach a Finnish company called Rovio Entertainment — can you search the Finnish business registry and get me their official address and website?"}],"resultDescription":"Returns a JSON object containing the ISO country code (FI), registry name (PRH/YTJ), the echoed query, a count of matched companies, and an array of company records each with: current legal name, normalized status (active/inactive/unknown), legal form, founding date, registered address (street, postal code, city, country code), business activities, and website URL.","failureModes":["No matching company found — returns count:0 and empty companies array with a note","Invalid or malformed Y-tunnus format — may return zero results or an error","Company name query with multiple matches — returns multiple records requiring disambiguation","Registry temporarily unavailable — upstream PRH/YTJ outage may cause request failure","Query string exceeds 200 character limit — validation error"],"whenToPreferThis":"Use this endpoint when you need authoritative, official company data for Finnish-registered entities specifically. It is preferred over generic web searches when legal accuracy matters — e.g. compliance checks, supplier onboarding, due diligence, or contract preparation. It shares a consistent schema with sibling endpoints for other countries (UK, Belgium, Czech Republic, Norway, France), making it ideal for multi-country workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:39:39.952Z","isFirstParty":false,"canonicalSlug":"finnish-company-registry-lookup-prh-ytj-a4581a45"}