{"uid":"cap_VBt06qySZ8ZWbHJwWHFjm","slug":"finland-ytj-business-register-search-7dec8fe9","name":"Finland YTJ Business Register Search","description":"Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.","url":"https://api.companyrecords-api.workers.dev/api/b2b/finland-ytj-companies?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":["q"],"properties":{"q":{"type":"string","description":"Company name, 2 to 80 characters"},"limit":{"type":"string","description":"Rows to return, 1 to 25 (default 10)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"query":"nokia","source":"https://avoindata.prh.fi/opendata-ytj-api/v3/companies","results":[{"name":"Fysios Mehiläinen Oy","status":"2","businessId":"0194099-3","nameHistory":[{"name":"Fysios Mehiläinen Oy","registeredFrom":"2024-07-16","registeredUntil":"2026-04-30"},{"name":"Fysios Oy","registeredFrom":"2017-12-31","registeredUntil":"2024-07-16"}],"companyForms":["Aktiebolag"],"registrationDate":"1978-06-09"},{"name":"Tikkurila Oyj","status":"2","businessId":"0197067-4","nameHistory":[{"name":"Tikkurila Oyj","registeredFrom":"2010-02-17","registeredUntil":null},{"name":"Tikkurila Oy","registeredFrom":"1985-12-31","registeredUntil":"2010-02-16"}],"companyForms":["Aktiebolag","Julkinen osakeyhtiö"],"registrationDate":"1978-06-16"}],"checkedAt":"2026-10-23T09:37:38.775Z","totalResults":991}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FG_6jlZUCl0kKX7HJCaMv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches the Finnish YTJ/PRH open business register by company name and returns business ID, registration date, company form, and name history.","exampleAgentPrompt":"Can you look up 'Wärtsilä' in the Finnish business register and tell me its business ID, registration date, and current company form?","exampleUseCases":[{"title":"Verify Finnish supplier before onboarding","prompt":"I need to verify that our Finnish supplier 'Metso Outotec' is a legitimately registered company — can you find their business ID and registration date from the Finnish YTJ register?"},{"title":"Due diligence on Finnish acquisition target","prompt":"We're looking at a company called 'Valio' in Finland — can you pull up their business ID, company form, and any historical name changes from the Finnish business register?"},{"title":"Find company details for contract filing","prompt":"I need the official business ID and registration details for a Finnish company called 'Kesko' so I can fill in our B2B contract — can you search the YTJ register for them?"}],"resultDescription":"A JSON object containing the search query, source URL, checked timestamp, total results count, and an array of matching companies each with: name, business ID, status code, company forms (e.g. Aktiebolag, Julkinen osakeyhtiö), registration date, and full name history with date ranges.","failureModes":["No results found if company name is too generic or misspelled","Query string shorter than 2 or longer than 80 characters will fail validation","Limit parameter outside 1–25 range may be rejected","PRH upstream API unavailability may cause errors","Returns partial name matches which may include unintended companies","Status field is a code (e.g. '2') without inline label — agent must interpret separately"],"whenToPreferThis":"Choose this endpoint when you need to look up official Finnish company registration data (business ID, legal form, registration date) from the authoritative PRH/YTJ public register. Prefer this over generic web searches when you need structured, reliable Finnish company identifiers for B2B onboarding, contract filing, or due diligence. It covers all Finnish legal entities but does not include financial, credit, or ownership information.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T12:45:34.582Z","isFirstParty":false,"canonicalSlug":"finland-ytj-business-register-search-7dec8fe9"}