Search companies
Changed onSearch company records in every live registry country (ES, FR, GB, IE, PL, NO, FI, SE, BE, DK, HR, EE, SK, CH, LV, CY, RO, LT, CA, AU, JP, IL, BR, CO, SG, TW, CZ, DE, US; choose one with country) by name, by company_number (the national registry identifier), by vat, by abn (AU) or business_number (CA), or by NIF (ES) and SIREN/SIRET (FR). A malformed identifier (nif, siren, siret, nip, regon, oib, company_number, vat; a Spanish NIF must also pass its control character) or a limit that is not an integer from 1 to 100 is a 400 validation_error with an X-Error-Code header, in every country. Returns richer company metadata than /search: legal form, region, activity code and, where the registry publishes it, registered capital (Denmark publishes none).
Request
- Base URL: https://api.prometiam.com/functions/v1/risk-api
- URL: https://api.prometiam.com/functions/v1/risk-api/companies/search
- Auth: HTTP bearer
Query parameters
Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) and Poland (PL) are company-level (no directors/UBO yet), with register-change events from 14 Oct 2026 and monitoring; Norway (NO) includes companies and officers, register-change events (none before 14 Oct 2026) and monitoring, the register e-mail as a contact (never for ENK, ANNA or PERS), and includes sole proprietorships (ENK) as Brønnøysund publishes them; France (FR) likewise includes sole proprietorships (EI), and a company that opted out of publication (INSEE non-diffusible) is served with company_name: null. Finland (FI) is company-level: company records from the Finnish Trade Register, with corporate insolvency notices linked by business ID; no officers; register-change events and monitoring are available. Sweden (SE) is company-level: company records from Bolagsverket, the Swedish Companies Registration Office, with corporate insolvency notices linked by organisationsnummer; no officers or registry-compliance signal; register-change events and monitoring are available. Croatia (HR) is company-level: company records from the Sudski registar, the Croatian court register, with corporate insolvency notices linked by MBS; no officers or registry-compliance signal; register-change events (including share capital) and monitoring are available. Belgium (BE) is company-level: company records from the Crossroads Bank for Enterprises (KBO/BCE); no officers, registry-compliance signal or insolvency notices (a bankruptcy shows in the company status and in the register-change events); register-change events and monitoring are available, and enterprises of natural persons are never served. Denmark (DK) is company-level: company records from the Danish Central Business Register (CVR), with corporate insolvency notices linked by CVR number; no officers, registry-compliance signal or share capital; register-change events and monitoring are available, and sole proprietorships and estates are never served. Estonia (EE) is company-level: company records from the Estonian e-Business Register (RIK); no officers or registry-compliance signal; bankruptcy declarations from the register are served as insolvency notices, linked by registry code (no court, case number or trustee; liquidation and bankruptcy also show in the company status); activity codes are EMTAK 2008 or 2025 per company; register-change events and monitoring are available, the VAT number (KMKR) is searchable with vat, and sole traders (FIE) are never served. Slovakia (SK) is company-level: company records from the Slovak Register of Legal Entities (RPO); no officers, registry-compliance signal, VAT number or insolvency notices (bankruptcy and restructuring show in the company status); activity codes are SK NACE Rev. 2.1; register-change events and monitoring are available, a vat search is refused, and only commercial legal persons are served (no associations, foundations or other non-commercial entities, and never sole traders or other natural persons). Romania (RO) is company-level: company records from the National Trade Register Office (ONRC) with CAEN activity codes, the J registration number and EUID; the VAT number is RO plus the CUI, built by rule; no officers, registry-compliance signal, share capital or insolvency notices; register-change events and monitoring are available, and natural persons and sole traders (PF, PFA, II, IF, AF) are never served. Updated monthly. Cyprus (CY) is company-level: company records from the Department of the Registrar of Companies and Intellectual Property (DRCOR) of the Republic of Cyprus; no officers, registry-compliance signal, activity code, share capital, VAT number or insolvency notices; register-change events and monitoring are available, a vat search is refused, and only companies and overseas companies are served (trade names and partnerships are never served). Latvia (LV) is company-level: company records from the Register of Enterprises of the Republic of Latvia (Uzņēmumu reģistrs), with the VAT number from the State Revenue Service list of VAT payers; no officers, registry-compliance signal or activity code; insolvency and legal protection proceedings from the Insolvency Register are served as insolvency notices, linked by registration number; register-change events and monitoring are available, the registration number with its LV prefix is searchable with vat, and individual merchants and other natural persons are never served. Switzerland (CH) is company-level: company records from Zefix, the Swiss central business name index, with corporate insolvency notices (SHAB) linked by UID where the notice names it; no officers, registry-compliance signal or activity code; register-change events and monitoring are available, the UID with its MWST, TVA or IVA suffix is searchable with vat, and only legal entities and branches are served (sole proprietorships and other natural persons are never served). The United States (US) is served as company records from the business registers of New York, Colorado, Connecticut, Pennsylvania and Florida (state open data and public records), plus SEC filers (EDGAR) and LEI holders (GLEIF) from every state, Delaware included; it is not a nationwide register of every US company. Each record is one state registration, domestic or foreign (a Delaware company registered in New York is a New York record with its state of formation in registry_details), numbered NY-4424185, CO-20091096973, DE-10684990, CIK-0000320193 or LEI-…; status is active, suspended, strike-off pending, dissolved, withdrawn, revoked, merged or inactive, New York and Pennsylvania publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign), and the SEC gives no legal status (unknown). Updated weekly. No officers or registry-compliance signal; register-change events (dated by the weekly read) and monitoring; US insolvency notices are on /insolvency/search?country=US and are not linked to the company records; there is no VAT number (a vat search is refused; SEC filers carry their EIN in identifiers); sole proprietorships are never served. US sources: New York Department of State, Colorado Secretary of State, Connecticut Secretary of the State, Pennsylvania Department of State (open data), Florida Department of State, Division of Corporations (public records), SEC EDGAR, GLEIF (CC0). Lithuania (LT) is company-level: Company records from the Register of Legal Entities (JAR): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day. Company status includes liquidation, bankruptcy and restructuring; there are no insolvency notices. Activity codes follow NACE Rev. 2.1 (EVRK 2.1, class level; the 6-digit code is in registry_details). Share capital is held for UAB and AB only. VAT numbers come from the State Tax Inspectorate (VMI) list. Sole proprietorships, partnerships (KUB, TUB), branches, state enterprises and non-commercial bodies are never served. Credit: Contains data from the Register of Legal Entities (JAR), Registrų centras, the State Data Agency (Statistics Lithuania) and the State Tax Inspectorate (VMI), CC BY 4.0. Adapted by Prometiam. Canada (CA) is company-level: Company records from Corporations Canada (Innovation, Science and Economic Development Canada): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day. Federal corporations only (Canada Business Corporations Act, Canada Cooperatives Act and the repealed Canada Corporations Act Part I and Cooperative Associations Act); provincial and territorial corporations, not-for-profit corporations and boards of trade are not in the register. There is no insolvency, liquidation or bankruptcy status (that is the Office of the Superintendent of Bankruptcy and the courts), no activity code, share capital or VAT number. The Business Number is searchable with business_number=, and a corporation's other names are in registry_details. Credit: Contains information licensed under the Open Government Licence – Canada (Corporations Canada, Innovation, Science and Economic Development Canada). Adapted by Prometiam. Australia (AU) is company-level: Company records from the Australian Securities and Investments Commission (ASIC) and the Australian Business Register (ABR): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated weekly. Proprietary, public and foreign companies (ACN and ARBN) only; associations, cooperatives, other bodies, individuals and sole traders are never served. The register gives the state and the postcode, not a street address. ASIC does not separate liquidation from administration, so external administration shows as in_administration and there is no in_liquidation status; there are no insolvency notices. No activity code or share capital. The VAT number is the ABN when the ABN is active and registered for GST; an ABN is searchable with abn= and a GST-registered one with vat=. Data are licensed CC BY 3.0 AU (no sublicensing): the credit and licence link travel with every answer. Credit: Contains data from the Australian Securities and Investments Commission (ASIC) Company Dataset and the Australian Business Register (ABN Bulk Extract), licensed CC BY 3.0 AU (https://creativecommons.org/licenses/by/3.0/au/). Adapted by Prometiam (joined, normalised, status derived). Japan (JP) is company-level: Company records from the National Tax Agency corporate number publication site: legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day, with a monthly full reconciliation. Companies (kabushiki, godo, gomei, goshi and tokurei yugen kaisha) and registered foreign companies only; national and local government bodies, associations and other corporations are never served. Status is active, deregistered or merged (with the successor's number): the register publishes no liquidation or insolvency state and there are no insolvency notices; no founding date, activity code, share capital or VAT number. The registration date is the date the corporate number was assigned and is null for companies that carry only the 5 October 2015 designation. Names are in Japanese; the English name, the kana reading and a romanised name are in registry_details. Credit: Source: National Tax Agency Corporate Number Publication Site (https://www.houjin-bangou.nta.go.jp/). Edited and processed by Prometiam; not a product of the National Tax Agency or the State. 出典:国税庁法人番号公表サイト(https://www.houjin-bangou.nta.go.jp/)。Prometiamが編集・加工して作成(国税庁が作成した情報ではありません)。 Israel (IL) is company-level: Company records from the Israeli Corporations Authority (Ministry of Justice): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day. Israeli and registered foreign companies only; partnerships, cooperative societies, non-profit associations and sole traders are other registers and are not served. Company status includes liquidation, receivership, restructuring and insolvency proceedings; there are no insolvency notices. Names are in Hebrew, with the English name in registry_details where the register holds one. No activity code, share capital or VAT number. Credit: Contains information from the Israeli Corporations Authority, Ministry of Justice, via data.gov.il (used under the data.gov.il terms of use). Adapted by Prometiam; not an official register extract. Brazil (BR) is company-level: Company records from the Cadastro Nacional da Pessoa Jurídica (CNPJ), Receita Federal do Brasil: legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated monthly (the Receita publishes one full file a month). Commercial legal persons only: limited companies (LTDA), corporations (S.A.), simple societies, single-member limited companies (EIRELI), public companies and mixed-capital companies, and cooperatives; sole traders (empresário individual, MEI included), non-profit entities, branches of foreign companies and every other natural-person form are never served. One record per CNPJ root, with the head office's 14-character CNPJ (shown 00.000.000/0001-91; the 8-digit root finds it too); branches are not served. Status is active, suspended, inapta (served as active_strike_off_pending), deregistered or merged; judicial recovery, bankruptcy, liquidation and intervention are read from the register's special situation, and there are no insolvency notices. The activity code is CNAE-Subclasses 2.3 (BR-CNAE-2.3), not a NACE code, and no NACE class is derived; the secondary codes are in registry_details. No VAT number (a vat search is refused), and no partners, officers or contacts. Credit: Contains data from the Cadastro Nacional da Pessoa Jurídica (CNPJ), Receita Federal do Brasil, published as open data (CC BY). Adapted by Prometiam. Colombia (CO) is company-level: Company records from Confecámaras (RUES, the Colombian chambers of commerce): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated monthly: the source's own update date is data_as_of and is in the credit. Companies of the commercial register only (S.A.S., Ltda., S.A., S. en C., S.C.A., collective companies, single-person companies (E.U.) and branches of foreign companies); natural persons, non-profit entities, cooperatives and public bodies are never served. The register has no address, share capital, contact, activity description or VAT number (a vat search is refused), and no liquidation state: liquidation, judicial liquidation and reorganisation are read from the company name and served as the status, and a cancelled registration is deregistered or merged. The registration may not be current although it reads active: last_renewal_year in registry_details is the last year it was renewed. company_name is the name without those markers and name_as_registered is the name as published. The activity code is the CIIU Rev.4 A.C. 4-digit code (CO-CIIU-REV4-AC), not a NACE code. No insolvency notices. The records are offered under CC BY-SA 4.0 (share-alike). Credit: Contains data from Confecámaras (RUES, Registro Único Empresarial y Social), via the Portal de Datos Abiertos www.datos.gov.co, last updated on the date shown in data_as_of, licensed under CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/). Adapted by Prometiam; the adapted Colombian records are offered under CC BY-SA 4.0. Singapore (SG) is company-level: Company records from the Accounting and Corporate Regulatory Authority (ACRA): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated monthly. Local companies, limited liability partnerships (LLP) and registered foreign company branches only; sole proprietorships, general partnerships and limited partnerships are never served. Status includes liquidation, judicial management and receivership, and a struck-off, dissolved or amalgamated company is deregistered or merged; there are no insolvency notices. The register publishes no cessation date, share capital, GST (VAT) number (a vat search is refused), region or officers. The activity code is SSIC 2020 (5 digits, SG-SSIC-2020; a legacy 4-digit code carries no scheme) and no NACE class is derived. The annual return and accounts-due dates are in registry_details as published. API use of the data is licensed, not a right to the data itself. Credit: Contains information from ACRA Information on Corporate Entities and Entities Registered with ACRA accessed on the date shown in data_as_of from the Accounting and Corporate Regulatory Authority (ACRA) via data.gov.sg, which is made available under the terms of the Singapore Open Data Licence version 1.0 (https://data.gov.sg/open-data-licence). Adapted by Prometiam; not an official ACRA extract. Taiwan (TW) is company-level: Company records from the Ministry of Economic Affairs (GCIS) and the Ministry of Finance (Fiscal Information Agency): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day. Limited companies, companies limited by shares, unlimited companies, limited partnership companies and Taiwan branches of foreign companies only; sole proprietorships, partnerships, domestic branches, cooperatives, associations and representative offices are never served. Names and addresses are in Chinese (the register publishes no English name). The responsible person is not served. Status includes dissolution, reorganisation, receivership and bankruptcy. The VAT number is the unified business number where the company is in the Ministry of Finance tax file (searchable with vat=), else null. The activity code is the Ministry of Finance tax industry code (6 digits, TW-TAX-SIC), which is not a NACE code, and the other codes of the file are in secondary_activity_codes. City is the district and postal_code the 3-digit Chunghwa Post zip of the district (null where the district is not read); a no-data placeholder address is not served. The check digit of the number is advisory. No officers; no insolvency notices. Credit: Contains data from the Ministry of Economic Affairs (Department of Commerce, GCIS) and the Ministry of Finance (Fiscal Information Agency), Republic of China (Taiwan), released under the Open Government Data License, version 1.0 (https://data.gov.tw/license). Adapted by Prometiam, not a certified register extract. Czech Republic (CZ) is company-level: Company records from the Czech public register (Veřejný rejstřík), kept by the regional courts and published by the Ministry of Justice as open data, with the region (kraj) and the activity code from the Czech Statistical Office's Register of Economic Entities (RES): legal name, legal form, status, registered address, share capital, identifiers and dates; no officers, partners or shareholders and no registry-compliance signal; register-change events (name, status, legal form, registered address and share capital, dated when the change first appears in the register data, none before the first load, October 2026) and monitoring are available. Updated each working day. Commercial legal persons only (s.r.o., a.s., v.o.s., k.s., cooperatives, SE, SCE and EEIG); sole traders (OSVČ) and every other natural person, associations, foundations, trust funds, owners' associations (SVJ) and branches are never served. Status includes liquidation, insolvency, bankruptcy and restructuring; there are no insolvency notices (the Czech Republic is not one of the fifteen insolvency markets) and no financial statements. No VAT number: a vat search is refused. The activity code is CZ-NACE 2025. The IČO has eight digits and its check digit is advisory, so companies whose IČO fails it are served. The registering court and file number (for example B 1581, Městský soud v Praze) are in registry_details. Credit: Contains data from the public registers of the Czech Republic (Ministry of Justice, ISVR open data) and the Czech Statistical Office (RES, CC BY 4.0). Adapted by Prometiam. Germany (DE) is company-level, from two sources, one record per company: LEI-registered entities (the Global Legal Entity Identifier Foundation (GLEIF) golden copy), plus companies listed in the energy market register (Marktstammdatenregister, Bundesnetzagentur) with their commercial-register entry that no LEI record holds; this is not the German commercial register (Handelsregister) and not every German company. Company records: legal name, legal form, status, registered address, identifiers and dates; the company number is the 20-character LEI (ISO 17442 check), or for an energy-market-register company its commercial-register entry with the court (HRB12653/FRANKFURT-AM-MAIN); lei is an alias of the LEI, and register_number (with an optional register_court) finds a company by its commercial-register entry. registry_details.source is gleif or mastr. An energy-market-register company is as declared by its market actor and not checked against the commercial register: its status is null (local_status unknown; registry_details.mastr_activity is the energy-market activity, not the company), it has no founding date and no register-change events. No officers, share capital, activity code or VAT number (a vat search is refused), no registry-compliance signal and no financial statements; register-change events for the LEI-registered entities (name, status, legal form, registered address, none before the first load, October 2026) and monitoring are available. Updated daily. GmbH, UG (haftungsbeschränkt), AG, KGaA, SE, OHG, KG (including GmbH & Co. KG), eG and PartG only; sole traders (e.K.) and other natural persons, GbR, associations (e.V.), foundations, public-law bodies, funds and branches are never served. For the LEI-registered entities the status is active, deregistered or merged; the LEI's own renewal status is registry_details.lei_status. The register court, register type and number (for example Amtsgericht München, HRB) are in registry_details. German corporate insolvency notices are served separately (Germany is one of the fifteen insolvency markets) and are not linked to these records. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. Not an extract of the German commercial register (Handelsregister). A record from the energy market register also carries: Contains data from the Marktstammdatenregister of the Bundesnetzagentur (https://www.marktstammdatenregister.de/MaStR/Datendownload), licensed under the Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0, https://www.govdata.de/dl-de/by-2-0). Data changed: selected, joined and normalised by Prometiam. Declared by the market actors and not checked against the commercial register; not an extract of the German commercial register (Handelsregister).
Company name (normalized pattern match). Spain: also matches the names a company's LEI record gives (the short name in brackets of its legal name, other and transliterated names), so the listed parent of a group is found by the group's name; a row with no NIF and no BORME entry ranks after every other row.
Spanish company NIF (CIF) — exact match, e.g. A28015865: an entity letter (ABCDEFGHJNPQRSUVW), seven digits and a control character that matches the digits (a digit or its letter). A personal DNI or NIE, a malformed value or a wrong control character is a 400. Alias of company_number.
VAT number — exact match, written with its country prefix or without (spaces, dots and dashes are ignored): ES ESA28015865 or the NIF, FR FR + two-digit key + SIREN (the key is verified) or the SIREN, PL PL + NIP or the NIP, NO NO + number + MVA or the number. A malformed or wrong-country value is a 400; GB and IE hold no VAT number, SK, CY and US refuse vat. Otherwise an alias of company_number. For country=HR it is the Croatian VAT number, HR plus the eleven digits of the OIB, e.g. HR27759560625. For country=BE it is the Belgian VAT number, BE plus the ten digits of the enterprise number, e.g. BE0417497106. For country=DK it is the Danish VAT number, DK plus the eight digits of the CVR number, e.g. DK24256790. For country=EE it is the Estonian VAT number (KMKR), EE plus nine digits, e.g. EE100354546; it is a separate number from the registry code, so it resolves only where the register publishes it. For country=CH it is the Swiss VAT number, the UID followed by MWST, TVA or IVA, e.g. CHE-103.867.266 MWST; it resolves to the same company as the UID. For country=LV it is the Latvian VAT number, LV plus the eleven digits of the registration number, e.g. LV40003032949, where the State Revenue Service lists the company as a VAT payer. For country=RO it is the Romanian VAT number, RO plus the CUI, e.g. RO5022670, built by rule (the registration is not confirmed). For country=SK and country=CY a vat search is refused: the Slovak register carries no VAT number. For country=US a vat search is refused: there is no US VAT number. For country=LT it is the Lithuanian VAT number, LT plus 9 or 12 digits, e.g. LT100538411, where the State Tax Inspectorate (VMI) lists the company. For country=AU it is the GST number, the eleven-digit ABN with a valid check, e.g. 49004028077, found only while the ABN is active and registered for GST. For country=TW it is the unified business number, e.g. 22099131 (TW in front is optional), where the company is in the Ministry of Finance tax file. For country=CA, JP, IL, BR, CO, SG, CZ and DE a vat search is refused: those registers hold no VAT number.
Australian Business Number (11 digits, e.g. 49004028077; an ABN prefix and spaces are optional) — exact match, with country=AU. The ABN check is verified: a wrong one is a 400 validation_error, and with any other country it is a 400. A company's ACN or ARBN goes in company_number.
Canadian Business Number (CRA, 9 digits, e.g. 847871746; a 15-character program account such as 847871746RC0001 names the same number) — exact match, with country=CA. Several federal corporations can carry the same Business Number, so the answer is a list. A malformed value is a 400 validation_error, and with any other country it is a 400.
French SIREN (exactly 9 digits; anything else is a 400)
French SIRET (exactly 14 digits; anything else is a 400)
Polish NIP (10 digits, check digit verified: a wrong one is a 400), exact match. Use with country=PL; the KRS number stays on company_number.
Polish REGON (9 or 14 digits, check digit verified: a wrong one is a 400), exact match. Use with country=PL.
Croatian OIB (11 digits), exact match, e.g. 27759560625. Use with country=HR; the ISO 7064 check digit is verified and a wrong one is a 400. The MBS stays on company_number.
Registry identifier — exact match. A malformed value is a 400 validation_error, never an empty 200. Resolves per country: Spanish company NIF/CIF (A28015865; entity letter, seven digits, valid control character; a wrong one is a 400), French SIREN (nine digits), UK Companies House number (00445790, SC123456), the IE (up to seven digits), PL (ten-digit KRS) or NO (nine-digit organisasjonsnummer) registration number, for country=FI the Y-tunnus (0112038-9; the hyphen is optional and the check digit is verified), for country=SE the ten-digit organisationsnummer (556012-5790; the hyphen is optional and the check digit is verified), for country=HR the nine-digit MBS (080000604; a dropped leading zero is restored and the check digit is advisory), for country=BE the ten-digit enterprise number (0417.497.106; the dots and spaces are optional and a wrong check digit is a 400), for country=DK the eight-digit CVR number (24256790; spaces and hyphens are optional and the mod-11 check is advisory, so only a number that is not eight digits is a 400), for country=EE the eight-digit registry code (10060701; spaces and hyphens are optional and the check digit is enforced, so a wrong one is a 400), for country=US the state code and register number (NY-4424185, CO-20091096973, CT-0292920, PA-0007065008, DE-10684990), CIK- with the SEC number (CIK-0000320193) or LEI- with the 20-character LEI (the dash is optional, a CIK may drop its leading zeros; there is no check digit, so only a malformed one is a 400), for country=SK the eight-digit IČO (35763469; a six or seven digit number is read with its leading zeros and the mod-11 check is advisory, so only a number that is not six to eight digits is a 400), or for country=CH the UID (CHE-103.867.266; CHE plus nine digits, separators and a MWST, TVA or IVA suffix are optional and the check digit is enforced, so a wrong one is a 400), or for country=LV the registration number (40003032949; 11 digits, an LV prefix is optional and the mod-11 check is enforced, so a wrong one is a 400; the oldest 9-digit codes carry no check digit), or for country=CY the registration number (HE165; HE for a company, AE for an overseas company, up to nine digits, bare digits mean HE; no check digit), or for country=RO the CUI (5022670; 2 to 10 digits, an RO prefix is optional; the check digit is advisory, so a mismatch is not an error; a 13-digit personal code is a 400), or for country=LT the legal entity code (110053842; nine digits, the check digit is enforced; LT in front is a VAT number and a 400), or for country=CA the corporation number (426160-7; 2 to 8 digits, written NNNNNN-N, the check digit is advisory; nine digits is a Business Number and a 400), or for country=AU the ACN or ARBN (004 028 077; nine digits, the check digit is enforced; eleven digits is an ABN and a 400), or for country=JP the 13-digit corporate number (1180301018771; the check digit is enforced; a T in front and full-width digits are read), or for country=IL the company number (520013954; nine digits starting 51, 52 or 56, the check digit is advisory), or for country=BR the CNPJ (33.000.167/0001-01 or 33000167000101; 14 characters, the check digits are enforced; the 8-digit root, 33000167, finds the head office; an 11-digit CPF is a 400), or for country=CO the NIT (900843898-9; nine digits starting 8 or 9, the verification digit is computed when left out and a typed one must match), or for country=SG the UEN (196800306E; the check letter is enforced; an eight-digit business UEN is a 400), or for country=TW the unified business number (22099131; eight digits, leading zeros kept, the check digit is advisory), or for country=CZ the IČO (45274649; eight digits, the check digit is advisory), or for country=DE the LEI (W38RGI023J3WT1HWRP32; 20 characters, the ISO 17442 check is enforced). For country=DE the company number is an LEI (20 characters, check digits verified) or, for a company of the energy market register, its commercial-register entry with the court in the form of the insolvency notices (HRB12653/FRANKFURT-AM-MAIN; HRB 12653 Frankfurt am Main is read as the same entry); a register number without its court is searched with register_number.
Legal Entity Identifier (20 characters, ISO 17442 check digits verified: a wrong one is a 400 validation_error), exact match, with country=DE: an alias of company_number for the LEI-registered entities (GLEIF). A German company from the energy market register has no LEI here; find it with company_number (its commercial-register entry) or register_number. Not the Handelsregister. Accepted only where a country has it (DE); with any other country it is a 400.
German commercial-register entry, with country=DE only: the register type (HRA, HRB, GnR, PR, VR or GsR) and the number, for example HRB12653 or HRB 12653 (a court-area suffix such as the B of Berlin is ignored). A register number repeats across courts, so the answer is every court's company with that number, from both German sources (LEI-registered entities and companies of the energy market register); narrow it with register_court, or write the court beside the number (HRB 12653 Frankfurt am Main). The entry is in registry_details (register_type, register_number, register_court) and as an identifier of type register_number. With any other country it is a 400.
Register court, with register_number and country=DE: the city or the Amtsgericht (Frankfurt am Main, Amtsgericht München). Spellings of one court are read as the same court (Freiburg, Freiburg im Breisgau). A company whose register court is not stated is not returned when a court is given.
YYYY-MM-DD — return companies incorporated on or after this date. Works without a name: poll it daily for a newly-incorporated-companies feed and page via next_cursor.
YYYY-MM-DD — upper bound on incorporation date.
Only 'founding_date' is supported; applies when listing by incorporation date.
asc or desc (default desc).
CNAE-2009 activity code or prefix (e.g. 62 = programming/IT, 6201 = computer programming). Combine with founded_after for an activity-scoped new-company feed. Coverage ~20%.
Keyword in the company's objeto social (statutory business purpose), min 3 chars. Best signal for startup/sector scouting; coverage ~90%+.
Integer from 1 to 100. A value outside the range, or one that is not an integer, is a 400 validation_error with an X-Error-Code header; it is never clamped.
Pagination cursor from the previous response's pagination.next_cursor
Spain only. Return only companies carrying a published risk flag (currently the AEAT >EUR600,000 tax-debtor list). For the registry-compliance signal use risk_flag_type=registry_compliance, which also works for GB, IE and NO.
Restrict to one flag type. registry_compliance (ES, GB, IE, NO) returns companies still on the register that have stopped meeting their filing duties, the state that precedes a forced strike-off: ES BORME sheet closure, GB strike-off proposal or overdue accounts, IE strike-off list, NO compulsory liquidation. The other types are Spain only.
Filter by the standard status (see Company.status), the same list in every country. Outside Spain it must be combined with name, company_number or another identifying parameter (siren, siret, nip, regon, oib): an unscoped status feed has no index to ride and is rejected with a 400. status=merged returns the Spanish companies absorbed into another. Replaces status_canonical, which now answers 400.
Filter by the register's own status value (see Company.local_status, for example "dissolved" for GB or "radiated" for FR). Use status or local_status, not both; an unknown value is a 400 that lists the values the register uses. Outside Spain it needs name or company_number, like status.
Response
Company search results
Example response
{
"data": [
{
"id": 2000099999001,
"country": "GB",
"company_number": "09999001",
"company_name": "EXAMPLE HARBOUR TRADING LTD",
"previous_names": [
{
"name": "EXAMPLE QUAY SUPPLIES LTD",
"from_date": "2016-03-01",
"until_date": "2021-06-14"
}
],
"identifiers": [
{
"type": "crn",
"value": "09999001"
}
],
"vat_number": null,
"vat_number_source": null,
"lei": null,
"legal_form": "LTD",
"legal_form_family": "private_limited_company",
"local_legal_form": "ltd",
"local_legal_form_name": "Private limited company",
"status": "active",
"stage": "active",
"local_status": "active",
"status_date": null,
"founding_date": "2016-03-01",
"registration_date": null,
"dissolution_date": null,
"activity_code": "46900",
"activity_code_scheme": "UK-SIC-2007",
"activity_description": "Non-specialised wholesale trade",
"activity_description_en": "Non-specialised wholesale trade",
"nace_class": "46.90",
"nace_version": "2",
"secondary_activity_codes": [
{
"code": "52290",
"scheme": "UK-SIC-2007",
"description": "Other transportation support activities"
}
],
"business_purpose": null,
"address": "1 EXAMPLE WHARF, LONDON, E1 0AA",
"postal_code": "E1 0AA",
"city": "LONDON",
"municipality": null,
"region": "GREATER LONDON",
"address_country": "GB",
"capital_amount": null,
"capital_currency": null,
"capital_eur": null,
"employees": null,
"employee_band": null,
"website": null,
"website_source": null,
"register": "Companies House",
"first_seen_date": "2026-01-15",
"last_seen_date": "2026-10-14",
"updated_at": "2026-10-14T03:12:44+00:00",
"registry_details": {
"jurisdiction": "ENGLAND-WALES",
"next_accounts_due": "2027-06-30",
"next_confirmation_due": "2027-03-28",
"address_line1": "1 EXAMPLE WHARF",
"address_line2": null
}
}
]
}Changes
- info
added the new optional
queryrequest parameterregister_court - info
added the new optional
queryrequest parameterregister_number
- info