{"openapi":"3.1.0","info":{"title":"Company Registry Lookup","version":"1.0.0","description":"![x402 Atlas](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI0OCIgaGVpZ2h0PSI0OCIgdmlld0JveD0iMCAwIDQ4IDQ4IiBmaWxsPSJub25lIj48ZyBzdHJva2U9IiMxRTQwQUYiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCI+PHBhdGggZD0iTTI0IDdWMjhNMjQgMjhMOCA0Mk0yNCAyOEw0MCA0MiIgc3Ryb2tlLXdpZHRoPSIyLjEiLz48cGF0aCBkPSJNMjQgN0w4IDQyTTI0IDdMNDAgNDJNMTUgMjhIMzMiIHN0cm9rZS13aWR0aD0iMi43Ii8+PC9nPjxnIGZpbGw9IiMxRTQwQUYiPjxjaXJjbGUgY3g9IjgiIGN5PSI0MiIgcj0iMy4yIi8+PGNpcmNsZSBjeD0iNDAiIGN5PSI0MiIgcj0iMy4yIi8+PGNpcmNsZSBjeD0iMTUiIGN5PSIyOCIgcj0iMy4yIi8+PGNpcmNsZSBjeD0iMzMiIGN5PSIyOCIgcj0iMy4yIi8+PGNpcmNsZSBjeD0iMjQiIGN5PSIyOCIgcj0iMi45Ii8+PC9nPjxjaXJjbGUgY3g9IjI0IiBjeT0iNyIgcj0iNC4yIiBmaWxsPSIjMTRCOEE2Ii8+PC9zdmc+)\n\n**Company Registry Lookup** is an independently documented x402 Atlas bridge at https://companies.use.x402atlas.com.\nThis document describes only this bridge; it does not aggregate routes, schemas,\nor content from any other bridge.\n\n## How payment works\n\nPaid operations use the [x402 payment protocol](https://x402.org) and settle in\nUSDC. Atlas supports deployments on Base, Polygon, and Arbitrum, plus configured\nSolana networks. This bridge currently advertises Arbitrum One (`eip155:42161`), Base (`eip155:8453`), Polygon (`eip155:137`), Solana mainnet (`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`).\n\n1. Send the HTTP request without a payment signature.\n2. Read the `402 Payment Required` response. Its `accepts` entries are the\n   authoritative network, asset, amount, and recipient options for that call.\n3. Select an option, sign it with an x402-compatible wallet or SDK, and repeat\n   the request with the `PAYMENT-SIGNATURE` header. The successful response is\n   returned after verification and settlement.\n\nTypeScript clients can automate the challenge, signing, and retry flow with\n[`x402-fetch`](https://www.npmjs.com/package/x402-fetch) or\n[`x402-axios`](https://www.npmjs.com/package/x402-axios). Fund a dedicated\nwallet only with the working USDC balance it needs and keep that key separate\nfrom treasury accounts.\n\n## Pricing\n\nAtlas route prices start at $0.005 per successful call. This bridge's fallback\nprice is $0.005; operations below state their exact configured price in\n`x-x402` and `x-payment-info`. The live `402` challenge remains authoritative.\n\n## Worked payment example\n\nRequest one documented operation without a signature to inspect its live terms:\n\n```bash\ncurl -i 'https://companies.use.x402atlas.com/belgian-company-data?query=0417.497.106'\n# HTTP/1.1 402 Payment Required\n# Read accepts[].network, asset, amount, and payTo from this response.\n```\n\nSign one accepted option and repeat the identical request with the\n`PAYMENT-SIGNATURE` header. Do not invent or cache payment terms; read them from\nthe current challenge.\n\n## Use this API\n\n- Interactive reference: https://companies.use.x402atlas.com/docs\n- OpenAPI 3.1 specification: https://companies.use.x402atlas.com/openapi.json\n- Agent-readable route corpus: https://companies.use.x402atlas.com/llms.txt\n- Endpoint index: https://companies.use.x402atlas.com/index.json\n\nUse the operation schemas and examples below to construct requests. Copy the\nserver URL, path, method, parameters, and request body from the operation you\nwant to call. Path and query examples are concrete and can be used directly.\n\n## Atlas response metadata\n\nSuccessful JSON responses include an additive top-level `_atlas` block, kept\nseparate from the bridge's data fields. `_atlas.docs` links this bridge's\n`/llms.txt` corpus. `_atlas.related` suggests adjacent APIs, each with a callable\n`url`, its own `docs` link, and a short `summary`. Suppress this block by sending\n`X-Atlas-Meta: none` or by adding `?_atlas=0` to the request.\n\n## Errors and compatibility\n\nValidation failures use HTTP `400`. Paid operations may return `402` before\ndispatch. Upstream and internal failures use the documented `5xx` responses.\nClients should rely on documented fields and tolerate additive response fields,\nincluding `_atlas` unless they explicitly opt out.\n\n## Protocol reference\n\n- x402 protocol and SDKs: https://x402.org","x-guidance":"Use the operation schemas and examples to construct requests. Paid operations return an HTTP 402 challenge with the authoritative payment terms."},"servers":[{"url":"https://companies.use.x402atlas.com"}],"tags":[{"name":"Company Registry Lookup"}],"paths":{"/belgian-company-data":{"get":{"description":"Company lookup in KBO/BCE Crossroads Bank for Enterprises, the official company registry of the route's country (BE), for KYB and counterparty checks. `query` is the only parameter and takes either a registration number or a company name. Belgian enterprise number: 10 digits, e.g. `0417.497.106`, `0417497106` or `BE0417497106` (a legacy 9-digit number is left-padded with a zero). A registration number is an exact lookup returning zero or one company (`matched_by: \"number\"`; a German register number without its court can match up to 5, since HRB/HRA numbers repeat across courts); anything else is a company-name search returning up to 5 companies (`matched_by: \"name\"`). Returns the legal name, status, legal form, start date, registered address, up to 5 NACE activities (newest NACE version only, main activities first) and website. The Belgian data is refreshed daily from the register. Every country route of this service returns the same schema: `country`, `registry`, `query`, `matched_by`, `count` and `companies[]` with `name`, `registration_number`, normalized `status` (`active`, `inactive` or `unknown`), `legal_form`, `founded`, `address`, `activities` and `website`; a field the registry does not supply is `null`. No match returns 200 with `count: 0`, an empty `companies` list and a `note`. An omitted `query` returns the declared sample with a `note` and does not query the registry. A `query` longer than 200 characters is rejected with 400 before any payment is taken. Registry failures return 502 and a deadline 504; neither is charged.\n\n**Price:** $0.05 per call.","operationId":"companies_GET_belgian_company_data","parameters":[{"name":"query","in":"query","required":true,"description":"Company registration number (Belgian enterprise number, e.g. 0417.497.106) or company name","schema":{"description":"Company registration number (Belgian enterprise number, e.g. 0417.497.106) or company name","maxLength":200,"type":"string"},"example":"0417.497.106"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"companies":{"description":"Matching companies; empty when nothing matched (still HTTP 200)","items":{"properties":{"activities":{"description":"Up to 5 registered activities, main activity first when the registry marks one; empty when none are published","items":{"properties":{"code":{"description":"Registry activity code (NACE, NAF or SIC, as the registry publishes it)","type":"string"},"description":{"description":"Activity description; null when the registry supplies only the code","type":["string","null"]}},"required":["code","description"],"type":"object"},"maxItems":5,"type":"array"},"address":{"description":"Registered (head-office) address; each part is null when the registry does not supply it","properties":{"city":{"description":"City or post town","type":["string","null"]},"country_code":{"description":"ISO 3166-1 alpha-2 country code of the address","type":["string","null"]},"postal_code":{"description":"Postal code","type":["string","null"]},"street":{"description":"Street and house number","type":["string","null"]}},"required":["street","postal_code","city","country_code"],"type":"object"},"founded":{"description":"Founding / registration date (YYYY-MM-DD)","format":"date","type":["string","null"]},"legal_form":{"description":"Legal form as the registry names it, or the registry's legal-form code when it publishes no name","type":["string","null"]},"name":{"description":"Current legal name","type":"string"},"registration_number":{"description":"Canonical national registration number (BE enterprise number, FR SIREN, GB company number, NO organisasjonsnummer, FI business ID, CZ ICO, SK ICO, DE register type and number)","type":"string"},"status":{"description":"Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown","enum":["active","inactive","unknown"],"type":"string"},"website":{"description":"Company website as registered; may lack a URL scheme","type":["string","null"]}},"required":["name","registration_number","status","legal_form","founded","address","activities","website"],"type":"object"},"maxItems":5,"type":"array"},"count":{"description":"Number of entries in companies","type":"integer"},"country":{"description":"ISO 3166-1 alpha-2 code of the route's country","type":"string"},"matched_by":{"description":"number: the query was read as a registration number (exact lookup, 0 or 1 company; a German number without its court can match up to 5); name: company-name search (up to 5 companies)","enum":["number","name"],"type":"string"},"note":{"description":"Hint present only on the sample response (empty/omitted query) and on a zero-match response","type":"string"},"query":{"description":"Echoed query (trimmed)","type":"string"},"registry":{"description":"Official registry the result comes from","type":"string"}},"required":["country","registry","query","matched_by","count","companies"],"type":"object"},"example":{"country":"BE","registry":"KBO/BCE Crossroads Bank for Enterprises","query":"0417.497.106","matched_by":"number","count":1,"companies":[{"name":"Anheuser-Busch InBev","registration_number":"0417497106","status":"active","legal_form":"Société anonyme","founded":"1977-08-02","address":{"street":"Grand-Place 1","postal_code":"1000","city":"Bruxelles","country_code":"BE"},"activities":[{"code":"70100","description":"Activités des sièges sociaux"}],"website":null}]}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"The company registry was unavailable, rate limited or returned an unusable response; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"The registry lookup exceeded its deadline; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Belgian company lookup in the official KBO/BCE Crossroads Bank for Enterprises (Daily data) by enterprise number (0417.497.106 or BE0417497106) or company name. Returns legal name, status, legal form, start date, registered address, NACE activities and website in a schema shared across countries.","tags":["Company Registry Lookup"],"x-payment-info":{"price":{"amount":"0.05","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.05","service_name":"Company Registry Lookup"}}},"/czech-company-data":{"get":{"description":"Company lookup in ARES (Czech Administrative Register of Economic Subjects), the official company registry of the route's country (CZ), for KYB and counterparty checks. `query` is the only parameter and takes either a registration number or a company name. Czech ICO: 8 digits, e.g. `00177041` or `CZ00177041`; an all-digit query of up to 8 digits is always read as an ICO and left-padded with zeros. A registration number is an exact lookup returning zero or one company (`matched_by: \"number\"`; a German register number without its court can match up to 5, since HRB/HRA numbers repeat across courts); anything else is a company-name search returning up to 5 companies (`matched_by: \"name\"`). Returns the legal name, status (inactive once the subject has a termination date), legal form as the ARES legal-form code, founding date, registered seat address and up to 5 CZ-NACE activity codes without descriptions. `website` is always `null`. The registry refuses a name that matches more than 1000 subjects; that returns `count: 0` with a `note` asking for a more specific name. Every country route of this service returns the same schema: `country`, `registry`, `query`, `matched_by`, `count` and `companies[]` with `name`, `registration_number`, normalized `status` (`active`, `inactive` or `unknown`), `legal_form`, `founded`, `address`, `activities` and `website`; a field the registry does not supply is `null`. No match returns 200 with `count: 0`, an empty `companies` list and a `note`. An omitted `query` returns the declared sample with a `note` and does not query the registry. A `query` longer than 200 characters is rejected with 400 before any payment is taken. Registry failures return 502 and a deadline 504; neither is charged.\n\n**Price:** $0.05 per call.","operationId":"companies_GET_czech_company_data","parameters":[{"name":"query","in":"query","required":true,"description":"Company registration number (Czech ICO, e.g. 00177041) or company name","schema":{"description":"Company registration number (Czech ICO, e.g. 00177041) or company name","maxLength":200,"type":"string"},"example":"00177041"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"companies":{"description":"Matching companies; empty when nothing matched (still HTTP 200)","items":{"properties":{"activities":{"description":"Up to 5 registered activities, main activity first when the registry marks one; empty when none are published","items":{"properties":{"code":{"description":"Registry activity code (NACE, NAF or SIC, as the registry publishes it)","type":"string"},"description":{"description":"Activity description; null when the registry supplies only the code","type":["string","null"]}},"required":["code","description"],"type":"object"},"maxItems":5,"type":"array"},"address":{"description":"Registered (head-office) address; each part is null when the registry does not supply it","properties":{"city":{"description":"City or post town","type":["string","null"]},"country_code":{"description":"ISO 3166-1 alpha-2 country code of the address","type":["string","null"]},"postal_code":{"description":"Postal code","type":["string","null"]},"street":{"description":"Street and house number","type":["string","null"]}},"required":["street","postal_code","city","country_code"],"type":"object"},"founded":{"description":"Founding / registration date (YYYY-MM-DD)","format":"date","type":["string","null"]},"legal_form":{"description":"Legal form as the registry names it, or the registry's legal-form code when it publishes no name","type":["string","null"]},"name":{"description":"Current legal name","type":"string"},"registration_number":{"description":"Canonical national registration number (BE enterprise number, FR SIREN, GB company number, NO organisasjonsnummer, FI business ID, CZ ICO, SK ICO, DE register type and number)","type":"string"},"status":{"description":"Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown","enum":["active","inactive","unknown"],"type":"string"},"website":{"description":"Company website as registered; may lack a URL scheme","type":["string","null"]}},"required":["name","registration_number","status","legal_form","founded","address","activities","website"],"type":"object"},"maxItems":5,"type":"array"},"count":{"description":"Number of entries in companies","type":"integer"},"country":{"description":"ISO 3166-1 alpha-2 code of the route's country","type":"string"},"matched_by":{"description":"number: the query was read as a registration number (exact lookup, 0 or 1 company; a German number without its court can match up to 5); name: company-name search (up to 5 companies)","enum":["number","name"],"type":"string"},"note":{"description":"Hint present only on the sample response (empty/omitted query) and on a zero-match response","type":"string"},"query":{"description":"Echoed query (trimmed)","type":"string"},"registry":{"description":"Official registry the result comes from","type":"string"}},"required":["country","registry","query","matched_by","count","companies"],"type":"object"},"example":{"country":"CZ","registry":"ARES (Czech Administrative Register of Economic Subjects)","query":"00177041","matched_by":"number","count":1,"companies":[{"name":"Škoda Auto a.s.","registration_number":"00177041","status":"active","legal_form":"121","founded":"1990-11-20","address":{"street":"tř. Václava Klementa 869","postal_code":"29301","city":"Mladá Boleslav","country_code":"CZ"},"activities":[{"code":"29100","description":null},{"code":"45200","description":null},{"code":"471","description":null},{"code":"47740","description":null},{"code":"69200","description":null}],"website":null}]}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"The company registry was unavailable, rate limited or returned an unusable response; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"The registry lookup exceeded its deadline; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Czech company lookup in the official ARES register by ICO (company ID) or company name. Returns legal name, status, legal form code, founding date, registered seat address and CZ-NACE activity codes in a schema shared across countries.","tags":["Company Registry Lookup"],"x-payment-info":{"price":{"amount":"0.05","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.05","service_name":"Company Registry Lookup"}}},"/finnish-company-data":{"get":{"description":"Company lookup in PRH / YTJ Finnish Business Information System, the official company registry of the route's country (FI), for KYB and counterparty checks. `query` is the only parameter and takes either a registration number or a company name. Finnish business ID (Y-tunnus): 7 digits, a hyphen and a check digit, e.g. `0112038-9`, `01120389` or `FI01120389`. A registration number is an exact lookup returning zero or one company (`matched_by: \"number\"`; a German register number without its court can match up to 5, since HRB/HRA numbers repeat across courts); anything else is a company-name search returning up to 5 companies (`matched_by: \"name\"`). Returns the legal name, status, company form, registration date, street address, main business line and website, with English descriptions where the registry has them. The Finnish registry does not rank a name search by relevance: the first 5 matches come in registry order and include dissolved companies and auxiliary-name matches, so prefer the business ID for an exact hit. Every country route of this service returns the same schema: `country`, `registry`, `query`, `matched_by`, `count` and `companies[]` with `name`, `registration_number`, normalized `status` (`active`, `inactive` or `unknown`), `legal_form`, `founded`, `address`, `activities` and `website`; a field the registry does not supply is `null`. No match returns 200 with `count: 0`, an empty `companies` list and a `note`. An omitted `query` returns the declared sample with a `note` and does not query the registry. A `query` longer than 200 characters is rejected with 400 before any payment is taken. Registry failures return 502 and a deadline 504; neither is charged.\n\n**Price:** $0.05 per call.","operationId":"companies_GET_finnish_company_data","parameters":[{"name":"query","in":"query","required":true,"description":"Company registration number (Finnish business ID, e.g. 0112038-9) or company name","schema":{"description":"Company registration number (Finnish business ID, e.g. 0112038-9) or company name","maxLength":200,"type":"string"},"example":"0112038-9"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"companies":{"description":"Matching companies; empty when nothing matched (still HTTP 200)","items":{"properties":{"activities":{"description":"Up to 5 registered activities, main activity first when the registry marks one; empty when none are published","items":{"properties":{"code":{"description":"Registry activity code (NACE, NAF or SIC, as the registry publishes it)","type":"string"},"description":{"description":"Activity description; null when the registry supplies only the code","type":["string","null"]}},"required":["code","description"],"type":"object"},"maxItems":5,"type":"array"},"address":{"description":"Registered (head-office) address; each part is null when the registry does not supply it","properties":{"city":{"description":"City or post town","type":["string","null"]},"country_code":{"description":"ISO 3166-1 alpha-2 country code of the address","type":["string","null"]},"postal_code":{"description":"Postal code","type":["string","null"]},"street":{"description":"Street and house number","type":["string","null"]}},"required":["street","postal_code","city","country_code"],"type":"object"},"founded":{"description":"Founding / registration date (YYYY-MM-DD)","format":"date","type":["string","null"]},"legal_form":{"description":"Legal form as the registry names it, or the registry's legal-form code when it publishes no name","type":["string","null"]},"name":{"description":"Current legal name","type":"string"},"registration_number":{"description":"Canonical national registration number (BE enterprise number, FR SIREN, GB company number, NO organisasjonsnummer, FI business ID, CZ ICO, SK ICO, DE register type and number)","type":"string"},"status":{"description":"Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown","enum":["active","inactive","unknown"],"type":"string"},"website":{"description":"Company website as registered; may lack a URL scheme","type":["string","null"]}},"required":["name","registration_number","status","legal_form","founded","address","activities","website"],"type":"object"},"maxItems":5,"type":"array"},"count":{"description":"Number of entries in companies","type":"integer"},"country":{"description":"ISO 3166-1 alpha-2 code of the route's country","type":"string"},"matched_by":{"description":"number: the query was read as a registration number (exact lookup, 0 or 1 company; a German number without its court can match up to 5); name: company-name search (up to 5 companies)","enum":["number","name"],"type":"string"},"note":{"description":"Hint present only on the sample response (empty/omitted query) and on a zero-match response","type":"string"},"query":{"description":"Echoed query (trimmed)","type":"string"},"registry":{"description":"Official registry the result comes from","type":"string"}},"required":["country","registry","query","matched_by","count","companies"],"type":"object"},"example":{"country":"FI","registry":"PRH / YTJ Finnish Business Information System","query":"0112038-9","matched_by":"number","count":1,"companies":[{"name":"Nokia Oyj","registration_number":"0112038-9","status":"active","legal_form":"Public limited company","founded":"1896-12-19","address":{"street":"Karakaari 7","postal_code":"02610","city":"ESPOO","country_code":"FI"},"activities":[{"code":"70100","description":"Activities of head offices"}],"website":"www.nokia.com"}]}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"The company registry was unavailable, rate limited or returned an unusable response; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"The registry lookup exceeded its deadline; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"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.","tags":["Company Registry Lookup"],"x-payment-info":{"price":{"amount":"0.05","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.05","service_name":"Company Registry Lookup"}}},"/french-company-data":{"get":{"description":"Company lookup in SIRENE / Annuaire des Entreprises, the official company registry of the route's country (FR), for KYB and counterparty checks. `query` is the only parameter and takes either a registration number or a company name. French SIREN (9 digits, e.g. `552032534`) or SIRET (14 digits, resolved to its SIREN); a company name needs at least 3 characters. A registration number is an exact lookup returning zero or one company (`matched_by: \"number\"`; a German register number without its court can match up to 5, since HRB/HRA numbers repeat across courts); anything else is a company-name search returning up to 5 companies (`matched_by: \"name\"`). Returns the legal name, status (active or ceased), legal form as the INSEE legal-category code, creation date, head-office address and the main NAF activity code. The French register publishes no activity description and no website, so those are `null`. Every country route of this service returns the same schema: `country`, `registry`, `query`, `matched_by`, `count` and `companies[]` with `name`, `registration_number`, normalized `status` (`active`, `inactive` or `unknown`), `legal_form`, `founded`, `address`, `activities` and `website`; a field the registry does not supply is `null`. No match returns 200 with `count: 0`, an empty `companies` list and a `note`. An omitted `query` returns the declared sample with a `note` and does not query the registry. A `query` longer than 200 characters is rejected with 400 before any payment is taken. Registry failures return 502 and a deadline 504; neither is charged.\n\n**Price:** $0.05 per call.","operationId":"companies_GET_french_company_data","parameters":[{"name":"query","in":"query","required":true,"description":"Company registration number (French SIREN or SIRET, e.g. 552032534) or company name","schema":{"description":"Company registration number (French SIREN or SIRET, e.g. 552032534) or company name","maxLength":200,"minLength":3,"type":"string"},"example":"552032534"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"companies":{"description":"Matching companies; empty when nothing matched (still HTTP 200)","items":{"properties":{"activities":{"description":"Up to 5 registered activities, main activity first when the registry marks one; empty when none are published","items":{"properties":{"code":{"description":"Registry activity code (NACE, NAF or SIC, as the registry publishes it)","type":"string"},"description":{"description":"Activity description; null when the registry supplies only the code","type":["string","null"]}},"required":["code","description"],"type":"object"},"maxItems":5,"type":"array"},"address":{"description":"Registered (head-office) address; each part is null when the registry does not supply it","properties":{"city":{"description":"City or post town","type":["string","null"]},"country_code":{"description":"ISO 3166-1 alpha-2 country code of the address","type":["string","null"]},"postal_code":{"description":"Postal code","type":["string","null"]},"street":{"description":"Street and house number","type":["string","null"]}},"required":["street","postal_code","city","country_code"],"type":"object"},"founded":{"description":"Founding / registration date (YYYY-MM-DD)","format":"date","type":["string","null"]},"legal_form":{"description":"Legal form as the registry names it, or the registry's legal-form code when it publishes no name","type":["string","null"]},"name":{"description":"Current legal name","type":"string"},"registration_number":{"description":"Canonical national registration number (BE enterprise number, FR SIREN, GB company number, NO organisasjonsnummer, FI business ID, CZ ICO, SK ICO, DE register type and number)","type":"string"},"status":{"description":"Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown","enum":["active","inactive","unknown"],"type":"string"},"website":{"description":"Company website as registered; may lack a URL scheme","type":["string","null"]}},"required":["name","registration_number","status","legal_form","founded","address","activities","website"],"type":"object"},"maxItems":5,"type":"array"},"count":{"description":"Number of entries in companies","type":"integer"},"country":{"description":"ISO 3166-1 alpha-2 code of the route's country","type":"string"},"matched_by":{"description":"number: the query was read as a registration number (exact lookup, 0 or 1 company; a German number without its court can match up to 5); name: company-name search (up to 5 companies)","enum":["number","name"],"type":"string"},"note":{"description":"Hint present only on the sample response (empty/omitted query) and on a zero-match response","type":"string"},"query":{"description":"Echoed query (trimmed)","type":"string"},"registry":{"description":"Official registry the result comes from","type":"string"}},"required":["country","registry","query","matched_by","count","companies"],"type":"object"},"example":{"country":"FR","registry":"SIRENE / Annuaire des Entreprises","query":"552032534","matched_by":"number","count":1,"companies":[{"name":"DANONE","registration_number":"552032534","status":"active","legal_form":"5599","founded":"1955-01-01","address":{"street":"59 RUE LA FAYETTE","postal_code":"75009","city":"PARIS","country_code":"FR"},"activities":[{"code":"70.10Z","description":null}],"website":null}]}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"The company registry was unavailable, rate limited or returned an unusable response; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"The registry lookup exceeded its deadline; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"French company lookup in the official SIRENE register (Annuaire des Entreprises) by SIREN, SIRET or company name. Returns legal name, active/ceased status, legal form, creation date, head-office address and NAF activity code in a schema shared across countries.","tags":["Company Registry Lookup"],"x-payment-info":{"price":{"amount":"0.05","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.05","service_name":"Company Registry Lookup"}}},"/german-company-data":{"get":{"description":"Company lookup in Handelsregister (German Commercial Register), the official company registry of the route's country (DE), for KYB and counterparty checks. `query` is the only parameter and takes either a registration number or a company name. German register number: the register type (HRA, HRB, GnR, PR or VR) and number, e.g. `HRB 12300`, or bare digits. Register numbers repeat across register courts, so add the court or city after a typed number (`HRB 12300 Berlin`) to pin one company; without it a number can match several companies (up to 5). A registration number is an exact lookup returning zero or one company (`matched_by: \"number\"`; a German register number without its court can match up to 5, since HRB/HRA numbers repeat across courts); anything else is a company-name search returning up to 5 companies (`matched_by: \"name\"`). Returns the legal name, status (active or inactive only), legal form as its usual German abbreviation (GmbH, AG, UG (haftungsbeschränkt), e.V., ...), the register number as `\u003ctype\u003e \u003cnumber\u003e` and the registered address. The register court is not a field of the shared schema. `founded` is `null`, `activities` is empty and `website` is `null` on this route. A name search matches current and former names and returns up to 5 companies. Every country route of this service returns the same schema: `country`, `registry`, `query`, `matched_by`, `count` and `companies[]` with `name`, `registration_number`, normalized `status` (`active`, `inactive` or `unknown`), `legal_form`, `founded`, `address`, `activities` and `website`; a field the registry does not supply is `null`. No match returns 200 with `count: 0`, an empty `companies` list and a `note`. An omitted `query` returns the declared sample with a `note` and does not query the registry. A `query` longer than 200 characters is rejected with 400 before any payment is taken. Registry failures return 502 and a deadline 504; neither is charged.\n\n**Price:** $0.21 per call.","operationId":"companies_GET_german_company_data","parameters":[{"name":"query","in":"query","required":true,"description":"Company registration number (German register type and number with its register court or city, e.g. HRB 12300 Berlin) or company name","schema":{"description":"Company registration number (German register type and number with its register court or city, e.g. HRB 12300 Berlin) or company name","maxLength":200,"type":"string"},"example":"HRB 12300 Berlin"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"companies":{"description":"Matching companies; empty when nothing matched (still HTTP 200)","items":{"properties":{"activities":{"description":"Up to 5 registered activities, main activity first when the registry marks one; empty when none are published","items":{"properties":{"code":{"description":"Registry activity code (NACE, NAF or SIC, as the registry publishes it)","type":"string"},"description":{"description":"Activity description; null when the registry supplies only the code","type":["string","null"]}},"required":["code","description"],"type":"object"},"maxItems":5,"type":"array"},"address":{"description":"Registered (head-office) address; each part is null when the registry does not supply it","properties":{"city":{"description":"City or post town","type":["string","null"]},"country_code":{"description":"ISO 3166-1 alpha-2 country code of the address","type":["string","null"]},"postal_code":{"description":"Postal code","type":["string","null"]},"street":{"description":"Street and house number","type":["string","null"]}},"required":["street","postal_code","city","country_code"],"type":"object"},"founded":{"description":"Founding / registration date (YYYY-MM-DD)","format":"date","type":["string","null"]},"legal_form":{"description":"Legal form as the registry names it, or the registry's legal-form code when it publishes no name","type":["string","null"]},"name":{"description":"Current legal name","type":"string"},"registration_number":{"description":"Canonical national registration number (BE enterprise number, FR SIREN, GB company number, NO organisasjonsnummer, FI business ID, CZ ICO, SK ICO, DE register type and number)","type":"string"},"status":{"description":"Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown","enum":["active","inactive","unknown"],"type":"string"},"website":{"description":"Company website as registered; may lack a URL scheme","type":["string","null"]}},"required":["name","registration_number","status","legal_form","founded","address","activities","website"],"type":"object"},"maxItems":5,"type":"array"},"count":{"description":"Number of entries in companies","type":"integer"},"country":{"description":"ISO 3166-1 alpha-2 code of the route's country","type":"string"},"matched_by":{"description":"number: the query was read as a registration number (exact lookup, 0 or 1 company; a German number without its court can match up to 5); name: company-name search (up to 5 companies)","enum":["number","name"],"type":"string"},"note":{"description":"Hint present only on the sample response (empty/omitted query) and on a zero-match response","type":"string"},"query":{"description":"Echoed query (trimmed)","type":"string"},"registry":{"description":"Official registry the result comes from","type":"string"}},"required":["country","registry","query","matched_by","count","companies"],"type":"object"},"example":{"country":"DE","registry":"Handelsregister (German Commercial Register)","query":"HRB 12300 Berlin","matched_by":"number","count":1,"companies":[{"name":"Siemens Aktiengesellschaft","registration_number":"HRB 12300","status":"active","legal_form":"AG","founded":null,"address":{"street":"Nonnendammallee 101","postal_code":"13629","city":"Berlin","country_code":"DE"},"activities":[],"website":null}]}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"The company registry was unavailable, rate limited or returned an unusable response; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"The registry lookup exceeded its deadline; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"German company lookup in the official Handelsregister (commercial register) by HRB or HRA number or company name. Returns legal name, status, legal form, register number and registered address in a schema shared across countries.","tags":["Company Registry Lookup"],"x-payment-info":{"price":{"amount":"0.21","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.21","service_name":"Company Registry Lookup"}}},"/norwegian-company-data":{"get":{"description":"Company lookup in Bronnoysund Register Centre (Enhetsregisteret), the official company registry of the route's country (NO), for KYB and counterparty checks. `query` is the only parameter and takes either a registration number or a company name. Norwegian organisasjonsnummer: 9 digits, e.g. `923609016`, `923 609 016` or `NO923609016MVA`. A registration number is an exact lookup returning zero or one company (`matched_by: \"number\"`; a German register number without its court can match up to 5, since HRB/HRA numbers repeat across courts); anything else is a company-name search returning up to 5 companies (`matched_by: \"name\"`). Returns the legal name, status (inactive when bankrupt, being wound up or deleted), organisation form, founding date, business address, up to 3 industry codes with descriptions and the website. Every country route of this service returns the same schema: `country`, `registry`, `query`, `matched_by`, `count` and `companies[]` with `name`, `registration_number`, normalized `status` (`active`, `inactive` or `unknown`), `legal_form`, `founded`, `address`, `activities` and `website`; a field the registry does not supply is `null`. No match returns 200 with `count: 0`, an empty `companies` list and a `note`. An omitted `query` returns the declared sample with a `note` and does not query the registry. A `query` longer than 200 characters is rejected with 400 before any payment is taken. Registry failures return 502 and a deadline 504; neither is charged.\n\n**Price:** $0.05 per call.","operationId":"companies_GET_norwegian_company_data","parameters":[{"name":"query","in":"query","required":true,"description":"Company registration number (Norwegian organisasjonsnummer, e.g. 923609016) or company name","schema":{"description":"Company registration number (Norwegian organisasjonsnummer, e.g. 923609016) or company name","maxLength":200,"type":"string"},"example":"923609016"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"companies":{"description":"Matching companies; empty when nothing matched (still HTTP 200)","items":{"properties":{"activities":{"description":"Up to 5 registered activities, main activity first when the registry marks one; empty when none are published","items":{"properties":{"code":{"description":"Registry activity code (NACE, NAF or SIC, as the registry publishes it)","type":"string"},"description":{"description":"Activity description; null when the registry supplies only the code","type":["string","null"]}},"required":["code","description"],"type":"object"},"maxItems":5,"type":"array"},"address":{"description":"Registered (head-office) address; each part is null when the registry does not supply it","properties":{"city":{"description":"City or post town","type":["string","null"]},"country_code":{"description":"ISO 3166-1 alpha-2 country code of the address","type":["string","null"]},"postal_code":{"description":"Postal code","type":["string","null"]},"street":{"description":"Street and house number","type":["string","null"]}},"required":["street","postal_code","city","country_code"],"type":"object"},"founded":{"description":"Founding / registration date (YYYY-MM-DD)","format":"date","type":["string","null"]},"legal_form":{"description":"Legal form as the registry names it, or the registry's legal-form code when it publishes no name","type":["string","null"]},"name":{"description":"Current legal name","type":"string"},"registration_number":{"description":"Canonical national registration number (BE enterprise number, FR SIREN, GB company number, NO organisasjonsnummer, FI business ID, CZ ICO, SK ICO, DE register type and number)","type":"string"},"status":{"description":"Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown","enum":["active","inactive","unknown"],"type":"string"},"website":{"description":"Company website as registered; may lack a URL scheme","type":["string","null"]}},"required":["name","registration_number","status","legal_form","founded","address","activities","website"],"type":"object"},"maxItems":5,"type":"array"},"count":{"description":"Number of entries in companies","type":"integer"},"country":{"description":"ISO 3166-1 alpha-2 code of the route's country","type":"string"},"matched_by":{"description":"number: the query was read as a registration number (exact lookup, 0 or 1 company; a German number without its court can match up to 5); name: company-name search (up to 5 companies)","enum":["number","name"],"type":"string"},"note":{"description":"Hint present only on the sample response (empty/omitted query) and on a zero-match response","type":"string"},"query":{"description":"Echoed query (trimmed)","type":"string"},"registry":{"description":"Official registry the result comes from","type":"string"}},"required":["country","registry","query","matched_by","count","companies"],"type":"object"},"example":{"country":"NO","registry":"Bronnoysund Register Centre (Enhetsregisteret)","query":"923609016","matched_by":"number","count":1,"companies":[{"name":"EQUINOR ASA","registration_number":"923609016","status":"active","legal_form":"Allmennaksjeselskap","founded":"1972-09-18","address":{"street":"Forusbeen 50","postal_code":"4035","city":"STAVANGER","country_code":"NO"},"activities":[{"code":"06.100","description":"Utvinning av råolje"},{"code":"06.200","description":"Utvinning av naturgass"},{"code":"19.200","description":"Produksjon av raffinerte petroleumsprodukter og fossile brenselsprodukter"}],"website":"www.equinor.com"}]}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"The company registry was unavailable, rate limited or returned an unusable response; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"The registry lookup exceeded its deadline; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Norwegian company lookup in the official Bronnoysund Register Centre (Enhetsregisteret, Brreg) by organisasjonsnummer or company name. Returns legal name, status, organisation form, founding date, business address, industry codes and website in a schema shared across countries.","tags":["Company Registry Lookup"],"x-payment-info":{"price":{"amount":"0.05","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.05","service_name":"Company Registry Lookup"}}},"/slovak-company-data":{"get":{"description":"Company lookup in RPO Register of Legal Entities (Statistical Office of the Slovak Republic), the official company registry of the route's country (SK), for KYB and counterparty checks. `query` is the only parameter and takes either a registration number or a company name. Slovak ICO: 8 digits, e.g. `31322832` or `SK31322832`; an all-digit query of up to 8 digits is always read as an ICO and left-padded with zeros. A registration number is an exact lookup returning zero or one company (`matched_by: \"number\"`; a German register number without its court can match up to 5, since HRB/HRA numbers repeat across courts); anything else is a company-name search returning up to 5 companies (`matched_by: \"name\"`). Returns the legal name, status (inactive once the entity has a termination date), legal form, founding date, registered address and the SK NACE main activity (at most one entry, with its Slovak description). `website` is always `null`. A name search matches current and former names and is not relevance-ranked: the first 5 matches come in registry order and include terminated entities, so prefer the ICO for an exact hit. The registry answers slowly at times (an exact ICO lookup has taken over two minutes); the route waits up to 180 seconds before answering `504`, so allow a client timeout of at least three minutes. Every country route of this service returns the same schema: `country`, `registry`, `query`, `matched_by`, `count` and `companies[]` with `name`, `registration_number`, normalized `status` (`active`, `inactive` or `unknown`), `legal_form`, `founded`, `address`, `activities` and `website`; a field the registry does not supply is `null`. No match returns 200 with `count: 0`, an empty `companies` list and a `note`. An omitted `query` returns the declared sample with a `note` and does not query the registry. A `query` longer than 200 characters is rejected with 400 before any payment is taken. Registry failures return 502 and a deadline 504; neither is charged.\n\n**Price:** $0.05 per call.","operationId":"companies_GET_slovak_company_data","parameters":[{"name":"query","in":"query","required":true,"description":"Company registration number (Slovak ICO, e.g. 31322832) or company name","schema":{"description":"Company registration number (Slovak ICO, e.g. 31322832) or company name","maxLength":200,"type":"string"},"example":"31322832"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"companies":{"description":"Matching companies; empty when nothing matched (still HTTP 200)","items":{"properties":{"activities":{"description":"Up to 5 registered activities, main activity first when the registry marks one; empty when none are published","items":{"properties":{"code":{"description":"Registry activity code (NACE, NAF or SIC, as the registry publishes it)","type":"string"},"description":{"description":"Activity description; null when the registry supplies only the code","type":["string","null"]}},"required":["code","description"],"type":"object"},"maxItems":5,"type":"array"},"address":{"description":"Registered (head-office) address; each part is null when the registry does not supply it","properties":{"city":{"description":"City or post town","type":["string","null"]},"country_code":{"description":"ISO 3166-1 alpha-2 country code of the address","type":["string","null"]},"postal_code":{"description":"Postal code","type":["string","null"]},"street":{"description":"Street and house number","type":["string","null"]}},"required":["street","postal_code","city","country_code"],"type":"object"},"founded":{"description":"Founding / registration date (YYYY-MM-DD)","format":"date","type":["string","null"]},"legal_form":{"description":"Legal form as the registry names it, or the registry's legal-form code when it publishes no name","type":["string","null"]},"name":{"description":"Current legal name","type":"string"},"registration_number":{"description":"Canonical national registration number (BE enterprise number, FR SIREN, GB company number, NO organisasjonsnummer, FI business ID, CZ ICO, SK ICO, DE register type and number)","type":"string"},"status":{"description":"Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown","enum":["active","inactive","unknown"],"type":"string"},"website":{"description":"Company website as registered; may lack a URL scheme","type":["string","null"]}},"required":["name","registration_number","status","legal_form","founded","address","activities","website"],"type":"object"},"maxItems":5,"type":"array"},"count":{"description":"Number of entries in companies","type":"integer"},"country":{"description":"ISO 3166-1 alpha-2 code of the route's country","type":"string"},"matched_by":{"description":"number: the query was read as a registration number (exact lookup, 0 or 1 company; a German number without its court can match up to 5); name: company-name search (up to 5 companies)","enum":["number","name"],"type":"string"},"note":{"description":"Hint present only on the sample response (empty/omitted query) and on a zero-match response","type":"string"},"query":{"description":"Echoed query (trimmed)","type":"string"},"registry":{"description":"Official registry the result comes from","type":"string"}},"required":["country","registry","query","matched_by","count","companies"],"type":"object"},"example":{"country":"SK","registry":"RPO Register of Legal Entities (Statistical Office of the Slovak Republic)","query":"31322832","matched_by":"number","count":1,"companies":[{"name":"SLOVNAFT, a.s.","registration_number":"31322832","status":"active","legal_form":"Akciová spoločnosť","founded":"1992-05-01","address":{"street":"Vlčie hrdlo 1","postal_code":"82412","city":"Bratislava","country_code":"SK"},"activities":[{"code":"1920","description":"Výroba rafinovaných ropných produktov a produktov z fosílnych palív"}],"website":null}]}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"The company registry was unavailable, rate limited or returned an unusable response; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"The registry lookup exceeded its deadline; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Slovak company lookup in the official RPO register (Register of Legal Entities, Statistical Office of the Slovak Republic) by ICO or company name. Returns legal name, status, legal form, founding date, registered address and SK NACE main activity in a schema shared across countries.","tags":["Company Registry Lookup"],"x-payment-info":{"price":{"amount":"0.05","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.05","service_name":"Company Registry Lookup"}}},"/uk-company-data":{"get":{"description":"Company lookup in Companies House, the official company registry of the route's country (GB), for KYB and counterparty checks. `query` is the only parameter and takes either a registration number or a company name. UK company number: 8 characters, e.g. `00445790` or `SC123456`; an all-digit query of up to 8 digits is always read as a company number and left-padded with zeros. A registration number is an exact lookup returning zero or one company (`matched_by: \"number\"`; a German register number without its court can match up to 5, since HRB/HRA numbers repeat across courts); anything else is a company-name search returning up to 5 companies (`matched_by: \"name\"`). Returns the legal name, company status, company type, incorporation date and registered office address. SIC codes (without descriptions) come with a company-number lookup only; a name search returns an empty `activities` list. `website` is always `null`. Every country route of this service returns the same schema: `country`, `registry`, `query`, `matched_by`, `count` and `companies[]` with `name`, `registration_number`, normalized `status` (`active`, `inactive` or `unknown`), `legal_form`, `founded`, `address`, `activities` and `website`; a field the registry does not supply is `null`. No match returns 200 with `count: 0`, an empty `companies` list and a `note`. An omitted `query` returns the declared sample with a `note` and does not query the registry. A `query` longer than 200 characters is rejected with 400 before any payment is taken. Registry failures return 502 and a deadline 504; neither is charged.\n\n**Price:** $0.05 per call.","operationId":"companies_GET_uk_company_data","parameters":[{"name":"query","in":"query","required":true,"description":"Company registration number (UK company number, e.g. 00445790) or company name","schema":{"description":"Company registration number (UK company number, e.g. 00445790) or company name","maxLength":200,"type":"string"},"example":"00445790"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"companies":{"description":"Matching companies; empty when nothing matched (still HTTP 200)","items":{"properties":{"activities":{"description":"Up to 5 registered activities, main activity first when the registry marks one; empty when none are published","items":{"properties":{"code":{"description":"Registry activity code (NACE, NAF or SIC, as the registry publishes it)","type":"string"},"description":{"description":"Activity description; null when the registry supplies only the code","type":["string","null"]}},"required":["code","description"],"type":"object"},"maxItems":5,"type":"array"},"address":{"description":"Registered (head-office) address; each part is null when the registry does not supply it","properties":{"city":{"description":"City or post town","type":["string","null"]},"country_code":{"description":"ISO 3166-1 alpha-2 country code of the address","type":["string","null"]},"postal_code":{"description":"Postal code","type":["string","null"]},"street":{"description":"Street and house number","type":["string","null"]}},"required":["street","postal_code","city","country_code"],"type":"object"},"founded":{"description":"Founding / registration date (YYYY-MM-DD)","format":"date","type":["string","null"]},"legal_form":{"description":"Legal form as the registry names it, or the registry's legal-form code when it publishes no name","type":["string","null"]},"name":{"description":"Current legal name","type":"string"},"registration_number":{"description":"Canonical national registration number (BE enterprise number, FR SIREN, GB company number, NO organisasjonsnummer, FI business ID, CZ ICO, SK ICO, DE register type and number)","type":"string"},"status":{"description":"Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown","enum":["active","inactive","unknown"],"type":"string"},"website":{"description":"Company website as registered; may lack a URL scheme","type":["string","null"]}},"required":["name","registration_number","status","legal_form","founded","address","activities","website"],"type":"object"},"maxItems":5,"type":"array"},"count":{"description":"Number of entries in companies","type":"integer"},"country":{"description":"ISO 3166-1 alpha-2 code of the route's country","type":"string"},"matched_by":{"description":"number: the query was read as a registration number (exact lookup, 0 or 1 company; a German number without its court can match up to 5); name: company-name search (up to 5 companies)","enum":["number","name"],"type":"string"},"note":{"description":"Hint present only on the sample response (empty/omitted query) and on a zero-match response","type":"string"},"query":{"description":"Echoed query (trimmed)","type":"string"},"registry":{"description":"Official registry the result comes from","type":"string"}},"required":["country","registry","query","matched_by","count","companies"],"type":"object"},"example":{"country":"GB","registry":"Companies House","query":"00445790","matched_by":"number","count":1,"companies":[{"name":"TESCO PLC","registration_number":"00445790","status":"active","legal_form":"Public limited company","founded":"1947-11-27","address":{"street":"Tesco House, Shire Park, Kestrel Way","postal_code":"AL7 1GA","city":"Welwyn Garden City","country_code":"GB"},"activities":[{"code":"47110","description":null}],"website":null}]}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"The company registry was unavailable, rate limited or returned an unusable response; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"The registry lookup exceeded its deadline; the payment is not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"UK company lookup in the official Companies House register by company number or company name. Returns legal name, company status, company type, incorporation date, registered office address and SIC codes in a schema shared across countries.","tags":["Company Registry Lookup"],"x-payment-info":{"price":{"amount":"0.05","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.05","service_name":"Company Registry Lookup"}}}},"components":{"schemas":{"Error":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"}},"required":["error"],"type":"object"},"PaymentRequired":{"description":"x402 payment-required envelope. The exact shape comes from the x402 SDK and includes per-network accepted payment options. See https://x402.org for the canonical schema.","type":"object"}},"securitySchemes":{"x402Payment":{"description":"Pay the route via x402 (https://x402.org). The 402 response carries the payment challenge; resubmit with a PAYMENT-SIGNATURE header.","scheme":"x402","type":"http"}}}}