{ "info": { "name": "Prometiam Risk Intelligence API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": "European company registry API: company lookup, KYB data, insolvency notices and sanctions screening (beta). Spain, France, the UK, Ireland, Poland, Norway, Finland, Sweden, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus, Romania, Belgium, Croatia, Lithuania, Canada, Australia, Japan, Israel, Singapore, Colombia, Taiwan, Brazil, the Czech Republic, Germany (LEI-registered entities and energy-market register companies), the Netherlands (LEI-registered entities with a KVK number) and the United States under one REST API and one schema.\n\nFree trial: 500 credits for 14 days (a successful call costs credits: 1 for a company record, errors are free; each response states its cost in the X-Credits-Cost header) at https://www.prometiam.com/signup. A card is required, nothing is charged for 14 days, then Starter (EUR 9.99/month) unless you cancel.\n\nSet the collection variable `api_key` to your `rk_live_...` token, then send any request.\n\nDocs: https://www.prometiam.com/risk-api/docs" }, "item": [ { "name": "search", "description": "", "item": [ { "id": "1ce9f21c-cb30-45e1-8a74-6299341e5c3f", "name": "Search insolvency / risk notices", "request": { "name": "Search insolvency / risk notices", "description": { "content": "Search registry risk notices by company name, VAT/NIF (Spain), SIREN/SIRET (France), or company_number (UK). Returns insolvency filings, dissolutions, liquidations, and other risk-relevant events extracted from official gazettes. At least one of `name`, `vat`, `siren`, `siret`, or `company_number` is required.", "type": "text/plain" }, "url": { "path": [ "search" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "Company name — accent-insensitive normalized pattern match", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "Spanish NIF/CIF (exact match)", "type": "text/plain" }, "key": "vat", "value": "" }, { "disabled": false, "description": { "content": "French SIREN (9 digits) — pair with `country=FR`", "type": "text/plain" }, "key": "siren", "value": "" }, { "disabled": false, "description": { "content": "French SIRET (14 digits)", "type": "text/plain" }, "key": "siret", "value": "" }, { "disabled": false, "description": { "content": "Registry registration number (exact match)", "type": "text/plain" }, "key": "company_number", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of insolvency,dissolution,liquidation,restructuring,status_change)", "type": "text/plain" }, "key": "event_type", "value": "insolvency" }, { "disabled": false, "description": { "content": "Filing date range start (YYYY-MM-DD)", "type": "text/plain" }, "key": "date_from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "date_to", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Pagination cursor from the previous response's `pagination.next_cursor`, passed back unchanged. A name search issues `o:`; the other lists issue an id or `YYYY-MM-DD_`.", "type": "text/plain" }, "key": "cursor", "value": "" } ], "variable": [], "raw": "{{base_url}}/search?country=ES&name=&vat=&siren=&siret=&company_number=&event_type=insolvency&date_from=&date_to=&limit=20&cursor=" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "d9f6f9fc-daec-4c85-9f40-1aef64160833", "name": "Search results", "originalRequest": { "url": { "path": [ "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "Company name — accent-insensitive normalized pattern match", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "Spanish NIF/CIF (exact match)", "type": "text/plain" }, "key": "vat", "value": "" }, { "disabled": false, "description": { "content": "French SIREN (9 digits) — pair with `country=FR`", "type": "text/plain" }, "key": "siren", "value": "" }, { "disabled": false, "description": { "content": "French SIRET (14 digits)", "type": "text/plain" }, "key": "siret", "value": "" }, { "disabled": false, "description": { "content": "Registry registration number (exact match)", "type": "text/plain" }, "key": "company_number", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of insolvency,dissolution,liquidation,restructuring,status_change)", "type": "text/plain" }, "key": "event_type", "value": "insolvency" }, { "disabled": false, "description": { "content": "Filing date range start (YYYY-MM-DD)", "type": "text/plain" }, "key": "date_from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "date_to", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Pagination cursor from the previous response's `pagination.next_cursor`, passed back unchanged. A name search issues `o:`; the other lists issue an id or `YYYY-MM-DD_`.", "type": "text/plain" }, "key": "cursor", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"vat_number\": \"\",\n \"country\": \"GB\",\n \"status\": \"\",\n \"local_status\": \"\",\n \"event_type\": \"\",\n \"filing_date\": \"\",\n \"source\": \"\",\n \"notice_url\": \"\",\n \"created_at\": \"\"\n },\n {\n \"id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"vat_number\": \"\",\n \"country\": \"IE\",\n \"status\": \"\",\n \"local_status\": \"\",\n \"event_type\": \"\",\n \"filing_date\": \"\",\n \"source\": \"\",\n \"notice_url\": \"\",\n \"created_at\": \"\"\n }\n ],\n \"pagination\": {\n \"count\": \"\",\n \"has_more\": \"\",\n \"next_cursor\": \"\"\n },\n \"meta\": {\n \"query_ms\": \"\",\n \"search_mode\": \"\",\n \"country\": \"SE\",\n \"rate_limit\": {\n \"rpm_remaining\": \"\",\n \"daily_remaining\": \"\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "records", "description": "", "item": [ { "name": "{id}", "description": "", "item": [ { "id": "75f7cb14-89d5-4b52-9297-23f9b5dcc86a", "name": "Get insolvency notice by ID", "request": { "name": "Get insolvency notice by ID", "description": { "content": "Fetch a single registry risk notice by numeric ID. Includes the full `notice_text` and `raw_data` fields that are omitted from search results.", "type": "text/plain" }, "url": { "path": [ "records", ":id" ], "host": [ "{{base_url}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Numeric internal ID", "type": "text/plain" } } ], "raw": "{{base_url}}/records/:id" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "10eec63c-50e2-479f-aed6-a287c0c94d60", "name": "Notice detail", "originalRequest": { "url": { "path": [ "records", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Numeric internal ID", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"vat_number\": \"\",\n \"country\": \"GB\",\n \"status\": \"\",\n \"local_status\": \"\",\n \"event_type\": \"\",\n \"filing_date\": \"\",\n \"source\": \"\",\n \"notice_url\": \"\",\n \"created_at\": \"\",\n \"notice_text\": \"\",\n \"raw_data\": {\n \"key_0\": 9633.245556048818,\n \"key_1\": false,\n \"key_2\": 1431.0566689357552\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "companies", "description": "", "item": [ { "name": "search", "description": "", "item": [ { "id": "ac522435-8229-4748-a7a8-ee2de365f0bf", "name": "Search companies", "request": { "name": "Search companies", "description": { "content": "Search 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).\n\n**Paging a name search.** A name search ranks a pool of up to about 700 candidates and pages through it: when `pagination.has_more` is true, `pagination.next_cursor` is `o:` (rows already served); send it back unchanged as `cursor` and the same search is ranked again and returns the rows from n on. `offset=` means the same as `cursor=o:` (both with different values is a 400 `validation_error`). The depth reachable is the pool: a page past the end is empty with `has_more` false and `next_cursor` null. Every page costs 1 credit. `offset` has no effect on the other modes (an identifier, the founded_after feed), which page by keyset with `cursor`. `match_score` is 100 for the name itself, 80-99 for a name that starts with the query's words, 50-79 for a name that holds all of them and under 50 for parts of words.", "type": "text/plain" }, "url": { "path": [ "companies", "search" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "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. Pages with `next_cursor` (`o:`) or `offset`, up to the candidate pool (about 700 rows).", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "nif", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "vat", "value": "" }, { "disabled": false, "description": { "content": "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`.", "type": "text/plain" }, "key": "abn", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "business_number", "value": "" }, { "disabled": false, "description": { "content": "French SIREN (exactly 9 digits; anything else is a 400)", "type": "text/plain" }, "key": "siren", "value": "" }, { "disabled": false, "description": { "content": "French SIRET (exactly 14 digits; anything else is a 400)", "type": "text/plain" }, "key": "siret", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "nip", "value": "" }, { "disabled": false, "description": { "content": "Polish REGON (9 or 14 digits, check digit verified: a wrong one is a 400), exact match. Use with country=PL.", "type": "text/plain" }, "key": "regon", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "oib", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "company_number", "value": "" }, { "disabled": false, "description": { "content": "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. In every live country the LEI is resolved through our GLEIF links to the company whose registration carries it (an LEI with no link is an empty list); with country=DE or NL it is an alias of company_number. Every company object carries `lei` where a link exists.", "type": "text/plain" }, "key": "lei", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "register_number", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "register_court", "value": "" }, { "disabled": false, "description": { "content": "Name search only: rows of the ranked pool to skip, the same as `cursor=o:`. Ignored by the other modes.", "type": "text/plain" }, "key": "offset", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "founded_after", "value": "" }, { "disabled": false, "description": { "content": "YYYY-MM-DD — upper bound on incorporation date.", "type": "text/plain" }, "key": "founded_before", "value": "" }, { "disabled": false, "description": { "content": "Only 'founding_date' is supported; applies when listing by incorporation date. (This can only be one of founding_date)", "type": "text/plain" }, "key": "sort", "value": "founding_date" }, { "disabled": false, "description": { "content": "asc or desc (default desc). (This can only be one of asc,desc)", "type": "text/plain" }, "key": "order", "value": "asc" }, { "disabled": false, "description": { "content": "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%.", "type": "text/plain" }, "key": "cnae", "value": "" }, { "disabled": false, "description": { "content": "Keyword in the company's objeto social (statutory business purpose), min 3 chars. Best signal for startup/sector scouting; coverage ~90%+.", "type": "text/plain" }, "key": "objeto", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Pagination cursor from the previous response's `pagination.next_cursor`, passed back unchanged. A name search issues `o:`; the other lists issue an id or `YYYY-MM-DD_`.", "type": "text/plain" }, "key": "cursor", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "has_risk_flag", "value": "" }, { "disabled": false, "description": { "content": "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. (This can only be one of tax_debt,debarment,regulator_sanction,subsidy,registry_compliance)", "type": "text/plain" }, "key": "risk_flag_type", "value": "registry_compliance" }, { "disabled": false, "description": { "content": "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. (This can only be one of active,active_strike_off_pending,suspended,not_yet_active,in_restructuring,in_administration,in_receivership,insolvent,in_liquidation_insolvent,in_liquidation,in_compulsory_liquidation,in_dissolution,deregistered,merged,withheld)", "type": "text/plain" }, "key": "status", "value": "active" }, { "disabled": false, "description": { "content": "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`.", "type": "text/plain" }, "key": "local_status", "value": "" } ], "variable": [], "raw": "{{base_url}}/companies/search?country=ES&name=&nif=&vat=&abn=&business_number=&siren=&siret=&nip=®on=&oib=&company_number=&lei=®ister_number=®ister_court=&offset=&founded_after=&founded_before=&sort=founding_date&order=asc&cnae=&objeto=&limit=20&cursor=&has_risk_flag=&risk_flag_type=registry_compliance&status=active&local_status=" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "e39d65ae-37cb-4f4c-b3b8-f7842524a187", "name": "Company search results", "originalRequest": { "url": { "path": [ "companies", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "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. Pages with `next_cursor` (`o:`) or `offset`, up to the candidate pool (about 700 rows).", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "nif", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "vat", "value": "" }, { "disabled": false, "description": { "content": "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`.", "type": "text/plain" }, "key": "abn", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "business_number", "value": "" }, { "disabled": false, "description": { "content": "French SIREN (exactly 9 digits; anything else is a 400)", "type": "text/plain" }, "key": "siren", "value": "" }, { "disabled": false, "description": { "content": "French SIRET (exactly 14 digits; anything else is a 400)", "type": "text/plain" }, "key": "siret", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "nip", "value": "" }, { "disabled": false, "description": { "content": "Polish REGON (9 or 14 digits, check digit verified: a wrong one is a 400), exact match. Use with country=PL.", "type": "text/plain" }, "key": "regon", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "oib", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "company_number", "value": "" }, { "disabled": false, "description": { "content": "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. In every live country the LEI is resolved through our GLEIF links to the company whose registration carries it (an LEI with no link is an empty list); with country=DE or NL it is an alias of company_number. Every company object carries `lei` where a link exists.", "type": "text/plain" }, "key": "lei", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "register_number", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "register_court", "value": "" }, { "disabled": false, "description": { "content": "Name search only: rows of the ranked pool to skip, the same as `cursor=o:`. Ignored by the other modes.", "type": "text/plain" }, "key": "offset", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "founded_after", "value": "" }, { "disabled": false, "description": { "content": "YYYY-MM-DD — upper bound on incorporation date.", "type": "text/plain" }, "key": "founded_before", "value": "" }, { "disabled": false, "description": { "content": "Only 'founding_date' is supported; applies when listing by incorporation date. (This can only be one of founding_date)", "type": "text/plain" }, "key": "sort", "value": "founding_date" }, { "disabled": false, "description": { "content": "asc or desc (default desc). (This can only be one of asc,desc)", "type": "text/plain" }, "key": "order", "value": "asc" }, { "disabled": false, "description": { "content": "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%.", "type": "text/plain" }, "key": "cnae", "value": "" }, { "disabled": false, "description": { "content": "Keyword in the company's objeto social (statutory business purpose), min 3 chars. Best signal for startup/sector scouting; coverage ~90%+.", "type": "text/plain" }, "key": "objeto", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Pagination cursor from the previous response's `pagination.next_cursor`, passed back unchanged. A name search issues `o:`; the other lists issue an id or `YYYY-MM-DD_`.", "type": "text/plain" }, "key": "cursor", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "has_risk_flag", "value": "" }, { "disabled": false, "description": { "content": "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. (This can only be one of tax_debt,debarment,regulator_sanction,subsidy,registry_compliance)", "type": "text/plain" }, "key": "risk_flag_type", "value": "registry_compliance" }, { "disabled": false, "description": { "content": "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. (This can only be one of active,active_strike_off_pending,suspended,not_yet_active,in_restructuring,in_administration,in_receivership,insolvent,in_liquidation_insolvent,in_liquidation,in_compulsory_liquidation,in_dissolution,deregistered,merged,withheld)", "type": "text/plain" }, "key": "status", "value": "active" }, { "disabled": false, "description": { "content": "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`.", "type": "text/plain" }, "key": "local_status", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"match_score\": \"\",\n \"country\": \"RO\",\n \"company_number\": \"\",\n \"company_name\": \"\",\n \"previous_names\": [\n {\n \"name\": \"\",\n \"from_date\": \"\",\n \"until_date\": \"\"\n },\n {\n \"name\": \"\",\n \"from_date\": \"\",\n \"until_date\": \"\"\n }\n ],\n \"identifiers\": [\n {\n \"type\": \"\",\n \"value\": \"\"\n },\n {\n \"type\": \"\",\n \"value\": \"\"\n }\n ],\n \"vat_number\": \"\",\n \"vat_number_source\": \"rule\",\n \"lei\": \"\",\n \"legal_form\": \"\",\n \"legal_form_family\": \"\",\n \"local_legal_form\": \"\",\n \"local_legal_form_name\": \"\",\n \"status\": \"in_dissolution\",\n \"stage\": \"distress\",\n \"local_status\": \"\",\n \"status_date\": \"\",\n \"founding_date\": \"\",\n \"registration_date\": \"\",\n \"dissolution_date\": \"\",\n \"activity_code\": \"\",\n \"activity_code_scheme\": \"CAEN-1998\",\n \"activity_description\": \"\",\n \"activity_description_en\": \"\",\n \"nace_class\": \"\",\n \"nace_version\": \"\",\n \"nace_division\": \"\",\n \"nace_derived\": \"\",\n \"secondary_activity_codes\": [\n {\n \"code\": \"\",\n \"scheme\": \"\",\n \"description\": \"\"\n },\n {\n \"code\": \"\",\n \"scheme\": \"\",\n \"description\": \"\"\n }\n ],\n \"business_purpose\": \"\",\n \"address\": \"\",\n \"postal_code\": \"\",\n \"city\": \"\",\n \"municipality\": \"\",\n \"region\": \"\",\n \"address_country\": \"\",\n \"capital_amount\": \"\",\n \"capital_currency\": \"\",\n \"capital_eur\": \"\",\n \"employees\": \"\",\n \"employee_band\": \"\",\n \"website\": \"\",\n \"website_source\": {\n \"method\": \"wikidata\",\n \"confidence\": \"\",\n \"found_in\": \"\",\n \"source_url\": \"\",\n \"checked_at\": \"\"\n },\n \"register\": \"\",\n \"first_seen_date\": \"\",\n \"last_seen_date\": \"\",\n \"updated_at\": \"\",\n \"registry_details\": {\n \"key_0\": \"string\",\n \"key_1\": 4595,\n \"key_2\": 4415,\n \"key_3\": \"string\"\n }\n },\n {\n \"id\": \"\",\n \"match_score\": \"\",\n \"country\": \"SK\",\n \"company_number\": \"\",\n \"company_name\": \"\",\n \"previous_names\": [\n {\n \"name\": \"\",\n \"from_date\": \"\",\n \"until_date\": \"\"\n },\n {\n \"name\": \"\",\n \"from_date\": \"\",\n \"until_date\": \"\"\n }\n ],\n \"identifiers\": [\n {\n \"type\": \"\",\n \"value\": \"\"\n },\n {\n \"type\": \"\",\n \"value\": \"\"\n }\n ],\n \"vat_number\": \"\",\n \"vat_number_source\": \"register\",\n \"lei\": \"\",\n \"legal_form\": \"\",\n \"legal_form_family\": \"\",\n \"local_legal_form\": \"\",\n \"local_legal_form_name\": \"\",\n \"status\": \"in_compulsory_liquidation\",\n \"stage\": \"closed\",\n \"local_status\": \"\",\n \"status_date\": \"\",\n \"founding_date\": \"\",\n \"registration_date\": \"\",\n \"dissolution_date\": \"\",\n \"activity_code\": \"\",\n \"activity_code_scheme\": \"NKD-2007\",\n \"activity_description\": \"\",\n \"activity_description_en\": \"\",\n \"nace_class\": \"\",\n \"nace_version\": \"\",\n \"nace_division\": \"\",\n \"nace_derived\": \"\",\n \"secondary_activity_codes\": [\n {\n \"code\": \"\",\n \"scheme\": \"\",\n \"description\": \"\"\n },\n {\n \"code\": \"\",\n \"scheme\": \"\",\n \"description\": \"\"\n }\n ],\n \"business_purpose\": \"\",\n \"address\": \"\",\n \"postal_code\": \"\",\n \"city\": \"\",\n \"municipality\": \"\",\n \"region\": \"\",\n \"address_country\": \"\",\n \"capital_amount\": \"\",\n \"capital_currency\": \"\",\n \"capital_eur\": \"\",\n \"employees\": \"\",\n \"employee_band\": \"\",\n \"website\": \"\",\n \"website_source\": {\n \"method\": \"name_address\",\n \"confidence\": \"\",\n \"found_in\": \"\",\n \"source_url\": \"\",\n \"checked_at\": \"\"\n },\n \"register\": \"\",\n \"first_seen_date\": \"\",\n \"last_seen_date\": \"\",\n \"updated_at\": \"\",\n \"registry_details\": {\n \"key_0\": \"string\"\n }\n }\n ],\n \"pagination\": {\n \"count\": \"\",\n \"has_more\": \"\",\n \"next_cursor\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "{id}", "description": "", "item": [ { "id": "5e52ac67-f855-4342-84b3-b3f6c7d9fa76", "name": "Get company by ID", "request": { "name": "Get company by ID", "description": { "content": "Fetch a single company profile by the id /companies/search returned. The id names its country, so `country` is optional; an id issued for France, the United Kingdom, Ireland or Poland before 1 October 2026 (without the country offset) still needs `country`. Returns full detail including `activity_description` (in Spain the purpose clause), registry coordinates (`registry_details`), founding date, and embedded contacts and appointments. `include=lei` (Spain) adds `lei_record`, the GLEIF record; `lei` is the code string. UK disqualified directors: on a GB company, `disqualified_officers` lists the company's CURRENT officers who are on the Companies House register of disqualified directors with a disqualification in force (each with the same `disqualifications` entry as /people/{id}); an empty list means none found, null means the register could not be read (retry). Matched as on /people/{id} (full name plus birth month), so only persons with significant control are covered, not directors.", "type": "text/plain" }, "url": { "path": [ "companies", ":id" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "Comma-separated extra blocks to attach: `procurement`, `insolvency`, `financials`, `lei`, `risk_flags`, `structure`, `charges` (GB: asks Companies House for the company's charges when the nightly crawl has not reached it yet; the summary is in `registry_details.charges`) — or `all` (which adds `lei` and `risk_flags`; `procurement`, `insolvency`, `financials` and `structure` are named explicitly). `structure` adds `corporate_structure`, the company's direct and ultimate parent as reported to GLEIF (Level 2, CC0), for a company of any live country that carries a Legal Entity Identifier; null with a `meta.notice` when no LEI is linked to the company (not reported, not no parent). For a Spanish company the block is returned even without an LEI (the GLEIF fields null) and carries `register_ownership`: the sole shareholder named by the BORME sole-shareholder notices since 2009 (companies only, natural persons are never served), the ultimate owner by the chain of those notices and then GLEIF's ultimate parent, the foreign parent of a branch (W NIF) and the companies it solely owns; a null `sole_shareholder` means no notice names a company, not that there is no owner. `financials` adds `latest_financials`, the latest current annual statement (same shape as one entry of GET /companies/{id}/financials; the company's own before its group's) for GB, FR, DK, SE and NO, for FI (statements filed digitally with PRH, and listed groups) for US SEC filers, EE, LT and RO (headline figures), LV, CO (Superintendencia de Sociedades filers) and BR (listed companies), for US SEC filers, EE, LT and RO (headline figures), LV, CO (Superintendencia de Sociedades filers) and BR (listed companies), and for listed companies in ES, PL, HR and BE, for keys with the `financials` scope (Scale plan and above); for other keys the field is left out with a `meta.notice`, and for other countries it is null with a notice. Annual accounts as filed (outside France, digitally filed accounts only); see GET /companies/{id}/financials for the scope limits. `procurement` adds the company's latest awards for ES, FR, GB, IE, PL and NO (`procurement.top_awards`). `insolvency` adds the Spanish concurso proceedings from the BORME entries for ES (`insolvency_proceedings`) and the corporate insolvency notices linked by registry number for FR, GB, NO, FI, DK, HR, SE, CH, LV and EE (`insolvency_notices`; a Swiss notice only where it names the debtor's UID). A block a country does not carry is named in `meta.notice`; a block that could not be read is null with a `meta.notice` (unknown, not empty). `risk_flags` returns two kinds of entry: `registry_compliance` (ES, GB, IE, NO), the register's own signal that the company has stopped meeting its filing duties (`signal` = sheet_closed, strike_off_proposed, accounts_overdue, strike_off_listed or forced_dissolution, dated in `as_of`), and the Spain-only AEAT tax-debtor entries (`tax_debt`), which are point-in-time and OCR-derived, each stating via `identifier_source` whether its identifier was read directly from the source or reconstructed with name corroboration.", "type": "text/plain" }, "key": "include", "value": "" }, { "disabled": false, "description": { "content": "Officer appointments returned, 1 to 500 (default 100). Current appointments (no end date, not a cessation) come first, then the history, each newest first, so the default page holds every current officer of a company that has up to 100. Outside the range is a 400 validation_error; it is never clamped.", "type": "text/plain" }, "key": "appointments_limit", "value": "100" }, { "disabled": false, "description": { "content": "Appointments to skip in the current-first order, an integer of 0 or more.", "type": "text/plain" }, "key": "appointments_offset", "value": "0" }, { "disabled": false, "description": { "content": "Recent corporate events returned, 1 to 200 (default 25). Outside the range is a 400 validation_error.", "type": "text/plain" }, "key": "events_limit", "value": "25" }, { "disabled": false, "description": { "content": "Events to skip, an integer of 0 or more.", "type": "text/plain" }, "key": "events_offset", "value": "0" } ], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Numeric internal ID", "type": "text/plain" } } ], "raw": "{{base_url}}/companies/:id?country=ES&include=&appointments_limit=100&appointments_offset=0&events_limit=25&events_offset=0" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "4bca21c8-cfeb-4169-b047-749d59c2ee89", "name": "Company detail", "originalRequest": { "url": { "path": [ "companies", ":id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "Comma-separated extra blocks to attach: `procurement`, `insolvency`, `financials`, `lei`, `risk_flags`, `structure`, `charges` (GB: asks Companies House for the company's charges when the nightly crawl has not reached it yet; the summary is in `registry_details.charges`) — or `all` (which adds `lei` and `risk_flags`; `procurement`, `insolvency`, `financials` and `structure` are named explicitly). `structure` adds `corporate_structure`, the company's direct and ultimate parent as reported to GLEIF (Level 2, CC0), for a company of any live country that carries a Legal Entity Identifier; null with a `meta.notice` when no LEI is linked to the company (not reported, not no parent). For a Spanish company the block is returned even without an LEI (the GLEIF fields null) and carries `register_ownership`: the sole shareholder named by the BORME sole-shareholder notices since 2009 (companies only, natural persons are never served), the ultimate owner by the chain of those notices and then GLEIF's ultimate parent, the foreign parent of a branch (W NIF) and the companies it solely owns; a null `sole_shareholder` means no notice names a company, not that there is no owner. `financials` adds `latest_financials`, the latest current annual statement (same shape as one entry of GET /companies/{id}/financials; the company's own before its group's) for GB, FR, DK, SE and NO, for FI (statements filed digitally with PRH, and listed groups) for US SEC filers, EE, LT and RO (headline figures), LV, CO (Superintendencia de Sociedades filers) and BR (listed companies), for US SEC filers, EE, LT and RO (headline figures), LV, CO (Superintendencia de Sociedades filers) and BR (listed companies), and for listed companies in ES, PL, HR and BE, for keys with the `financials` scope (Scale plan and above); for other keys the field is left out with a `meta.notice`, and for other countries it is null with a notice. Annual accounts as filed (outside France, digitally filed accounts only); see GET /companies/{id}/financials for the scope limits. `procurement` adds the company's latest awards for ES, FR, GB, IE, PL and NO (`procurement.top_awards`). `insolvency` adds the Spanish concurso proceedings from the BORME entries for ES (`insolvency_proceedings`) and the corporate insolvency notices linked by registry number for FR, GB, NO, FI, DK, HR, SE, CH, LV and EE (`insolvency_notices`; a Swiss notice only where it names the debtor's UID). A block a country does not carry is named in `meta.notice`; a block that could not be read is null with a `meta.notice` (unknown, not empty). `risk_flags` returns two kinds of entry: `registry_compliance` (ES, GB, IE, NO), the register's own signal that the company has stopped meeting its filing duties (`signal` = sheet_closed, strike_off_proposed, accounts_overdue, strike_off_listed or forced_dissolution, dated in `as_of`), and the Spain-only AEAT tax-debtor entries (`tax_debt`), which are point-in-time and OCR-derived, each stating via `identifier_source` whether its identifier was read directly from the source or reconstructed with name corroboration.", "type": "text/plain" }, "key": "include", "value": "" }, { "disabled": false, "description": { "content": "Officer appointments returned, 1 to 500 (default 100). Current appointments (no end date, not a cessation) come first, then the history, each newest first, so the default page holds every current officer of a company that has up to 100. Outside the range is a 400 validation_error; it is never clamped.", "type": "text/plain" }, "key": "appointments_limit", "value": "100" }, { "disabled": false, "description": { "content": "Appointments to skip in the current-first order, an integer of 0 or more.", "type": "text/plain" }, "key": "appointments_offset", "value": "0" }, { "disabled": false, "description": { "content": "Recent corporate events returned, 1 to 200 (default 25). Outside the range is a 400 validation_error.", "type": "text/plain" }, "key": "events_limit", "value": "25" }, { "disabled": false, "description": { "content": "Events to skip, an integer of 0 or more.", "type": "text/plain" }, "key": "events_offset", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Numeric internal ID", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"match_score\": \"\",\n \"country\": \"NO\",\n \"company_number\": \"\",\n \"company_name\": \"\",\n \"previous_names\": [\n {\n \"name\": \"\",\n \"from_date\": \"\",\n \"until_date\": \"\"\n }\n ],\n \"identifiers\": [\n {\n \"type\": \"\",\n \"value\": \"\"\n }\n ],\n \"vat_number\": \"\",\n \"vat_number_source\": \"register\",\n \"lei\": \"\",\n \"legal_form\": \"\",\n \"legal_form_family\": \"\",\n \"local_legal_form\": \"\",\n \"local_legal_form_name\": \"\",\n \"status\": \"suspended\",\n \"stage\": \"distress\",\n \"local_status\": \"\",\n \"status_date\": \"\",\n \"founding_date\": \"\",\n \"registration_date\": \"\",\n \"dissolution_date\": \"\",\n \"activity_code\": \"\",\n \"activity_code_scheme\": \"CAEN-2003\",\n \"activity_description\": \"\",\n \"activity_description_en\": \"\",\n \"nace_class\": \"\",\n \"nace_version\": \"\",\n \"nace_division\": \"\",\n \"nace_derived\": \"\",\n \"secondary_activity_codes\": [\n {\n \"code\": \"\",\n \"scheme\": \"\",\n \"description\": \"\"\n }\n ],\n \"business_purpose\": \"\",\n \"address\": \"\",\n \"postal_code\": \"\",\n \"city\": \"\",\n \"municipality\": \"\",\n \"region\": \"\",\n \"address_country\": \"\",\n \"capital_amount\": \"\",\n \"capital_currency\": \"\",\n \"capital_eur\": \"\",\n \"employees\": \"\",\n \"employee_band\": \"\",\n \"website\": \"\",\n \"website_source\": {\n \"method\": \"email_domain\",\n \"confidence\": \"\",\n \"found_in\": \"\",\n \"source_url\": \"\",\n \"checked_at\": \"\"\n },\n \"register\": \"\",\n \"first_seen_date\": \"\",\n \"last_seen_date\": \"\",\n \"updated_at\": \"\",\n \"registry_details\": {\n \"key_0\": \"string\"\n },\n \"contacts\": [\n {\n \"id\": \"\",\n \"person_id\": \"\",\n \"organ\": \"representing_partners\",\n \"organ_name\": \"\",\n \"role_type\": \"\",\n \"role_description\": \"\",\n \"person_name_raw\": \"\",\n \"name_masked\": \"\",\n \"is_legal_entity\": \"\",\n \"regon\": \"\",\n \"suspended\": \"\",\n \"suspended_until\": \"\",\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"full_name\": \"\",\n \"role\": \"\",\n \"appointment_date\": \"\",\n \"end_date\": \"\",\n \"is_current\": \"\"\n }\n ],\n \"appointments\": [\n {\n \"key_0\": 6590,\n \"key_1\": true,\n \"key_2\": 8101\n }\n ],\n \"representation\": [\n {\n \"key_0\": \"string\",\n \"key_1\": 6668.647284635483\n }\n ],\n \"recent_events\": [\n {\n \"key_0\": 1782.3294443881232,\n \"key_1\": false\n }\n ],\n \"lei_record\": {\n \"key_0\": 6354,\n \"key_1\": \"string\"\n },\n \"corporate_structure\": {\n \"lei\": \"\",\n \"lei_name\": \"\",\n \"lei_registration_status\": \"\",\n \"direct_parent\": {\n \"lei\": \"\",\n \"name\": \"\",\n \"country\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"relationship_registration_status\": \"\",\n \"corroboration\": \"\",\n \"since\": \"\"\n },\n \"direct_parent_exception\": \"\",\n \"ultimate_parent\": {\n \"lei\": \"\",\n \"name\": \"\",\n \"country\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"relationship_registration_status\": \"\",\n \"corroboration\": \"\",\n \"since\": \"\"\n },\n \"ultimate_parent_exception\": \"\",\n \"direct_subsidiaries\": \"\",\n \"source\": \"\",\n \"data_as_of\": \"\",\n \"register_ownership\": {\n \"sole_shareholder\": {\n \"name\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"lei\": \"\",\n \"link\": \"\",\n \"since\": \"\",\n \"borme_id\": \"\",\n \"entry_number\": \"\"\n },\n \"ultimate_owner\": {\n \"name\": \"\",\n \"lei\": \"\",\n \"country\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"path_length\": \"\",\n \"basis\": \"borme_chain_gleif\"\n },\n \"branch_of\": {\n \"parent_name\": \"\",\n \"lei\": \"\",\n \"country\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"link\": \"\"\n },\n \"solely_owned_subsidiaries\": {\n \"count\": \"\",\n \"group_members\": \"\",\n \"items\": [\n {\n \"company_id\": \"\",\n \"company_number\": \"\",\n \"company_name\": \"\",\n \"status\": \"\"\n }\n ],\n \"truncated\": \"\"\n },\n \"source\": \"\",\n \"data_as_of\": \"\"\n }\n },\n \"latest_financials\": {\n \"fiscal_year\": \"\",\n \"period_start\": \"\",\n \"period_end\": \"\",\n \"period_days\": \"\",\n \"statement_type\": \"consolidated\",\n \"framework\": \"\",\n \"currency\": \"\",\n \"origin\": \"own_filing\",\n \"filing_date\": \"\",\n \"filing_delay_days\": \"\",\n \"source_url\": \"\",\n \"accounts_type\": \"\",\n \"audit\": {\n \"status\": \"\",\n \"opinion\": \"unqualified\",\n \"auditor_name\": \"\"\n },\n \"figures\": {\n \"revenue\": \"\",\n \"gross_profit\": \"\",\n \"operating_profit\": \"\",\n \"profit_before_tax\": \"\",\n \"net_profit\": \"\",\n \"personnel_costs\": \"\",\n \"depreciation\": \"\",\n \"interest_expense\": \"\",\n \"total_assets\": \"\",\n \"fixed_assets\": \"\",\n \"current_assets\": \"\",\n \"cash\": \"\",\n \"inventories\": \"\",\n \"receivables\": \"\",\n \"equity\": \"\",\n \"current_liabilities\": \"\",\n \"non_current_liabilities\": \"\",\n \"total_liabilities\": \"\",\n \"employees\": \"\",\n \"operating_cash_flow\": \"\",\n \"capital_expenditure\": \"\",\n \"free_cash_flow\": \"\",\n \"dividends_paid\": \"\",\n \"cost_of_sales\": \"\",\n \"tax_expense\": \"\",\n \"retained_earnings\": \"\",\n \"financial_debt_long_term\": \"\",\n \"financial_debt_short_term\": \"\",\n \"trade_payables\": \"\",\n \"provisions\": \"\"\n },\n \"figures_eur\": {\n \"revenue\": \"\",\n \"gross_profit\": \"\",\n \"operating_profit\": \"\",\n \"profit_before_tax\": \"\",\n \"net_profit\": \"\",\n \"personnel_costs\": \"\",\n \"depreciation\": \"\",\n \"interest_expense\": \"\",\n \"total_assets\": \"\",\n \"fixed_assets\": \"\",\n \"current_assets\": \"\",\n \"cash\": \"\",\n \"inventories\": \"\",\n \"receivables\": \"\",\n \"equity\": \"\",\n \"current_liabilities\": \"\",\n \"non_current_liabilities\": \"\",\n \"total_liabilities\": \"\",\n \"employees\": \"\",\n \"operating_cash_flow\": \"\",\n \"capital_expenditure\": \"\",\n \"free_cash_flow\": \"\",\n \"dividends_paid\": \"\",\n \"cost_of_sales\": \"\",\n \"tax_expense\": \"\",\n \"retained_earnings\": \"\",\n \"financial_debt_long_term\": \"\",\n \"financial_debt_short_term\": \"\",\n \"trade_payables\": \"\",\n \"provisions\": \"\"\n },\n \"ratios\": {\n \"gross_margin\": \"\",\n \"operating_margin\": \"\",\n \"net_margin\": \"\",\n \"ebitda\": \"\",\n \"ebitda_margin\": \"\",\n \"return_on_assets\": \"\",\n \"return_on_equity\": \"\",\n \"roce\": \"\",\n \"current_ratio\": \"\",\n \"quick_ratio\": \"\",\n \"cash_ratio\": \"\",\n \"working_capital\": \"\",\n \"equity_ratio\": \"\",\n \"debt_to_equity\": \"\",\n \"interest_cover\": \"\",\n \"asset_turnover\": \"\",\n \"days_sales_outstanding\": \"\",\n \"revenue_per_employee\": \"\",\n \"personnel_cost_share\": \"\"\n },\n \"ratios_eur\": {\n \"ebitda\": \"\",\n \"working_capital\": \"\",\n \"revenue_per_employee\": \"\"\n },\n \"ratios_basis\": \"gross_profit\",\n \"growth\": {\n \"revenue\": \"\",\n \"net_profit\": \"\",\n \"equity\": \"\",\n \"employees\": \"\"\n },\n \"flags\": {\n \"negative_equity\": \"\",\n \"loss_two_years\": \"\",\n \"current_ratio_below_1\": \"\",\n \"interest_cover_below_1_5\": \"\",\n \"revenue_down_over_20pct\": \"\"\n },\n \"fx\": {\n \"rate\": \"\",\n \"year_used\": \"\",\n \"basis\": \"\"\n },\n \"quality\": {\n \"has_balance_sheet\": \"\",\n \"has_profit_and_loss\": \"\",\n \"balance_check\": \"\",\n \"derived\": [\n \"\"\n ],\n \"is_abridged\": \"\",\n \"is_micro_entity\": \"\",\n \"is_dormant\": \"\",\n \"is_amended\": \"\",\n \"notes\": [\n \"\"\n ],\n \"missing\": {\n \"key_0\": \"reported_as_gross_profit\",\n \"key_1\": \"not_published_by_register\"\n }\n },\n \"superseded\": \"\",\n \"balance_sheet\": {\n \"key_0\": \"\",\n \"key_1\": \"\"\n },\n \"income_statement\": {\n \"key_0\": \"\"\n },\n \"ratio_benchmarks\": {\n \"key_0\": {\n \"percentile\": \"\",\n \"cell\": {\n \"country\": \"\",\n \"nace_division\": \"\",\n \"nace_division_name\": \"\",\n \"size_band\": \"under_1m\",\n \"year\": \"\",\n \"companies\": \"\",\n \"pooled\": \"\"\n }\n },\n \"key_1\": {\n \"percentile\": \"\",\n \"cell\": {\n \"country\": \"\",\n \"nace_division\": \"\",\n \"nace_division_name\": \"\",\n \"size_band\": \"under_1m\",\n \"year\": \"\",\n \"companies\": \"\",\n \"pooled\": \"\"\n }\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "financials", "description": "", "item": [ { "id": "4683e0a2-53b7-46ae-a1ff-313f103db9d5", "name": "Annual financial statements of a company", "request": { "name": "Annual financial statements of a company", "description": { "content": "Annual financial statements as filed with the official registers, mapped to one standard chart (revenue, profit, assets, equity, liabilities, cash, employees), so figures compare across companies and countries. Statements are served for GB, FR, DK, SE and NO, for FI (statements filed digitally with PRH, plus listed groups' annual financial reports), for US SEC filers (annual reports from EDGAR XBRL), for the consolidated annual financial reports of listed groups in GB, DK, SE, LV and LT (beside the individual accounts), for listed companies only in ES, PL, HR and BE (their ESEF annual financial reports) and in BR (the CVM's annual statements), for EE, LT and RO (headline figures only, never a full statement), for LV, for CO (companies filing NIIF statements with the Superintendencia de Sociedades only), and, for AU, tax records only with no statements; every other company answers 200 with an empty `statements` array and `meta.availability` saying why (other companies in ES, PL, HR, BE and BR `listed_companies_only`; other US companies `sec_filers_only`; other Colombian companies `supersociedades_filers_only`; Australian companies `tax_records_only`; Finnish companies without a digital filing `no_statement_held`; IE `source_not_supported`). Finnish and Australian companies carry `data.tax_records` (see below). The id names its country, so `country` is optional. Requires the `financials` scope: Scale plan and above (EUR 99.99/month); Starter, Professional and free trial keys get 10 successful calls a month (`meta.trial_allowance`), then 403 `upgrade_required`. A successful call that returns statements (or Finnish or Australian tax records) costs 25 credits; an answer with no statement held (`statements` empty) costs 0 credits (`X-Credits-Cost: 0`) and uses none of the 10 calls. The id in `data.company` is that of the record the statements belong to: for a US SEC filer such as Apple it is the SEC record (`CIK-`), which differs from the id a search returns for the same company in a state register; search `company_number=CIK-<10 digits>` for it.\n\n**Scope limits.** Annual accounts as filed. FR: accounts keyed by INPI from the filed documents; none for companies that declare their accounts confidential (about 45% of French filers), and no profit and loss account where only it is declared confidential. Elsewhere digitally filed accounts only: GB electronic (iXBRL) filings, about three in four, and small and micro companies often file no profit and loss account; DK XBRL annual reports, where most small companies report gross profit instead of revenue (Contains CVR data (Erhvervsstyrelsen), CC BY 4.0.); SE digitally filed (iXBRL) reports only; NO the last three approved accounts, with no employee count. GB, DK, SE, LV and LT also hold the consolidated annual financial report of listed groups and other issuers (ESEF, IFRS; UKSEF for GB), statement_type consolidated, annual reports only, fiscal years from 2022, as XBRL International's filings.xbrl.org collects them (an issuer registered elsewhere, a building society or a mutual is not matched; SE: no report added after May 2025, LV after July 2024); credit: Contains annual financial reports published by the issuers (ESEF, IFRS), collected by XBRL International (filings.xbrl.org). Adapted by Prometiam. The last three fiscal years at launch. Figures are in the filing currency plus euro at the ECB annual average of the fiscal year (for comparison, not an accounting translation). FI: statements filed digitally with PRH, the Finnish Patent and Registration Office (XBRL, the company's own accounts; about one filer in twenty, registered since July 2023; no employee count; profit before tax is before appropriations), beside the ESEF annual financial reports of listed groups; Finnish companies that file on paper have none. ES, PL, HR and BE: listed companies only, their ESEF annual financial reports (the European Single Electronic Format reports that EU-listed issuers publish; IFRS, mostly the group's consolidated accounts); ES from the CNMV, HR from the Zagreb Stock Exchange (group and company accounts); not every listed company's report is held, and Polish reports arrive more than a year late (mostly fiscal 2023). Spanish listed companies' reports are available free of charge on the CNMV website. US: SEC filers only, their annual reports (10-K, 20-F and 40-F, with amendments) from EDGAR XBRL, consolidated, US GAAP or IFRS, fiscal years from 2023, in the filing currency (mostly USD) plus euro at the ECB annual average of the fiscal year; no statements for the other US companies. Not available for other companies there, nor for IE (PDF images). EE: headline figures only (about sixteen summary items from the annual report: assets, equity, revenue, profits, employee expense, head count; total liabilities is assets minus equity), never a full statement, fiscal years 2019 on (a fiscal year whose report carries no figures in the open data is absent), updated monthly; some figures are read from PDF reports and non-profit income statements follow their own layout. Contains data from the Estonian e-Business Register (RIK), CC BY 4.0. LV: full balance sheet and profit and loss account with employees as filed, consolidated statements separate, fiscal years 2015 on in euro, no cash flow, no filing date, updated daily. Contains data from the Register of Enterprises of the Republic of Latvia (CC0). RO: headline indicators only (assets, equity, debts, net turnover, profit or loss, average employees) of companies filing with the Ministry of Finance, never a full statement, fiscal years 2019 on, in lei with euro copies, no banks, insurers or non-profits. Contains data from the Ministry of Finance of Romania (situații financiare, data.gov.ro), licensed under CC BY 4.0. LT: headline figures only (the balance sheet section totals: fixed assets, current assets, equity, liabilities; the profit and loss account revenue, profit before tax and net profit), never a full statement, individual and consolidated, fiscal years 2023 on in euro, no employees, updated daily from the open data of the register, which held filings up to March 2026 at launch. Contains data from the Register of Legal Entities (JAR), Registrų centras, via data.gov.lt, CC BY 4.0. Adapted by Prometiam. CO: companies that file NIIF statements with the Superintendencia de Sociedades only (groups 1 and 2; about 33,000 companies; banks and Superfinanciera issuers excluded; other Colombian companies answer availability `supersociedades_filers_only`), individual and consolidated, fiscal years 2023 on, in pesos with no euro copy (the ECB publishes no peso rate), no employees, personnel costs or depreciation, no filing date. Contains data from the Superintendencia de Sociedades (estados financieros NIIF), via www.datos.gov.co, licensed CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/). Modified by Prometiam; the Colombian records are offered under CC BY-SA 4.0 (share-alike). BR: listed companies only (about 750, the CVM DFP annual statements, individual and consolidated, in reais with euro copies, fiscal years 2023 on, updated weekly); other Brazilian companies publish none (`listed_companies_only`). Contains data from the Comissão de Valores Mobiliários (CVM), Portal Dados Abertos, licensed under the Open Database License (ODbL, share-alike). Adapted by Prometiam. AU: tax_records only, no financial statements (availability `tax_records_only`): the Australian Taxation Office's Corporate Tax Transparency report per income year from 2013-14 (total income, taxable income, tax payable, in Australian dollars) for large corporate tax entities, total income AUD 100 million and over (AUD 200 million for Australian-owned private companies up to 2021-22); a null taxable income or tax payable means withheld (zero or a loss), not 0. Contains data from the Australian Taxation Office (ATO), Corporate Tax Transparency report, licensed CC BY 3.0 AU (https://creativecommons.org/licenses/by/3.0/au/). Adapted by Prometiam; the credit and licence link travel with every answer. **Finland: `tax_records`.** For every Finnish company, `data.tax_records` lists the Finnish Tax Administration's public corporate income tax data (Verohallinto, CC BY 4.0), newest tax year first, from tax year 2020 (published each November for the year before); 0 means none (no taxable income, or a loss), not unknown; `null` means the read failed, `[]` that nothing was published for the company. The key is present only for Finnish and Australian companies (for Australia see the AU paragraph above), and `meta.tax_note` explains it. Contains data from the Finnish Patent and Registration Office (PRH), CC BY 4.0.\n\n**Further items per statement** (added 20 Oct 2026; null with `quality.missing` = `not_collected_for_source` where the country's source gives none). Cash flow: `operating_cash_flow`, `capital_expenditure`, `free_cash_flow` (operating cash flow less capital expenditure, where both are filed) and `dividends_paid` for US SEC filers, the ESEF reports of listed companies (ES, PL, HR, BE and the listed groups of FI) and BR (the CVM cash flow statement); GB, DK, SE and NO give none (small companies file no cash flow statement). Balance sheet and profit and loss: `retained_earnings` (GB about a third of filings, NO the earned equity, DK, SE, FI, SK, CO, BR, US, ESEF), `trade_payables` (DK, SE, FI, FR, SK, CO, BR, US, ESEF), `provisions` (DK, SK, LV, ESEF), `financial_debt_long_term` and `financial_debt_short_term` (bank loans and borrowings as tagged: BR, US, FI, ESEF; short term also DK), `cost_of_sales` (US, BR, CO, LV, ESEF) and `tax_expense` (DK, SE, NO, FI, FR, SK, CO, LV, BR, US, ESEF); DK and SE `dividends_paid` is the dividends distributed in the year from the statement of changes in equity. Declared by the filing: `accounts_type` (GB, DK, NO, US), `audit.status` (GB, DK, NO), `audit.opinion` (BR: unqualified, qualified, adverse, disclaimer) and `audit.auditor_name` (DK). Coverage varies inside a country with what each company files; the figures of a company are as filed, never estimated.\n\nA null figure was not stated in the filing; it is never zero. Each statement says whether it is the company's `own_filing` or a `comparative` (a prior-year figure taken from the next year's filing when the company's own filing for that year is not held). The latest statement is also on `GET /companies/{id}?include=financials` as `latest_financials`.\n\n**Sector benchmarks.** A statement that carries `ratios` also carries `ratio_benchmarks`: per ratio `{percentile, cell}` (percentile 5 to 95 among peers; higher means a higher ratio, not a better one), or null where no peer group exists. Peers: companies of the same country, NACE division (the first two digits of the company's NACE activity code), size band (total assets in euro: under_1m, 1m_10m, 10m_100m, 100m_plus), statement type and fiscal year, in cells of at least 30 companies that state the ratio (`cell.companies`); a year with fewer is pooled with the year before (`cell.pooled`). A statement that reports gross profit instead of revenue (Denmark) is compared only with such statements. The peers are the companies with filed statements in this dataset, not every company of the sector: cells exist for GB, FR, DK, SE, NO, FI, EE, LT and RO; none for countries without a NACE-based activity code (for example LV, CO, BR, US, AU), for the listed-company-only countries (ES, PL, HR, BE), for a company without an activity code, for a statement of under 300 or over 430 days, a dormant company or a failed balance check, or where fewer than 30 companies state the ratio. The cells are computed periodically, not on every request, so a very recent filing may not be in them yet. A percentile is descriptive, not a rating, a credit score or advice.", "type": "text/plain" }, "url": { "path": [ "companies", ":id", "financials" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "Number of fiscal years to return, 1-10, default 3 (most recent first).", "type": "text/plain" }, "key": "years", "value": "3" }, { "disabled": false, "description": { "content": "`individual` (the company alone), `consolidated` (the group) or `all` (default). (This can only be one of individual,consolidated,all)", "type": "text/plain" }, "key": "statement_type", "value": "all" }, { "disabled": false, "description": { "content": "`native` returns `figures` in the filing currency, `eur` returns `figures_eur` only, `both` (default) returns both. Euro figures use the ECB annual average rate of the fiscal year (`fx`), for comparison, not an accounting translation. (This can only be one of native,eur,both)", "type": "text/plain" }, "key": "currency", "value": "both" }, { "disabled": false, "description": { "content": "`lines` adds `balance_sheet` and `income_statement` to each statement: every mapped line of the filing, with keys such as `total_assets`, `cash`, `share_capital`, `revenue`, `cost_of_sales`. (This can only be one of lines)", "type": "text/plain" }, "key": "include", "value": "lines" }, { "disabled": false, "description": { "content": "When `true`, also return statements replaced by a later or amended filing, flagged `superseded: true`. Default `false`.", "type": "text/plain" }, "key": "include_superseded", "value": "false" } ], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Numeric internal ID", "type": "text/plain" } } ], "raw": "{{base_url}}/companies/:id/financials?country=ES&years=3&statement_type=all¤cy=both&include=lines&include_superseded=false" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "8f96b52b-e5d4-48a0-afc0-71c8dc506983", "name": "Financial statements (an empty `statements` array with `meta.availability` where the country has none)", "originalRequest": { "url": { "path": [ "companies", ":id", "financials" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "Number of fiscal years to return, 1-10, default 3 (most recent first).", "type": "text/plain" }, "key": "years", "value": "3" }, { "disabled": false, "description": { "content": "`individual` (the company alone), `consolidated` (the group) or `all` (default). (This can only be one of individual,consolidated,all)", "type": "text/plain" }, "key": "statement_type", "value": "all" }, { "disabled": false, "description": { "content": "`native` returns `figures` in the filing currency, `eur` returns `figures_eur` only, `both` (default) returns both. Euro figures use the ECB annual average rate of the fiscal year (`fx`), for comparison, not an accounting translation. (This can only be one of native,eur,both)", "type": "text/plain" }, "key": "currency", "value": "both" }, { "disabled": false, "description": { "content": "`lines` adds `balance_sheet` and `income_statement` to each statement: every mapped line of the filing, with keys such as `total_assets`, `cash`, `share_capital`, `revenue`, `cost_of_sales`. (This can only be one of lines)", "type": "text/plain" }, "key": "include", "value": "lines" }, { "disabled": false, "description": { "content": "When `true`, also return statements replaced by a later or amended filing, flagged `superseded: true`. Default `false`.", "type": "text/plain" }, "key": "include_superseded", "value": "false" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Numeric internal ID", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"company\": {\n \"id\": \"\",\n \"country\": \"\",\n \"company_number\": \"\",\n \"company_name\": \"\",\n \"status\": \"\",\n \"employee_band\": \"\"\n },\n \"statements\": [\n {\n \"fiscal_year\": \"\",\n \"period_start\": \"\",\n \"period_end\": \"\",\n \"period_days\": \"\",\n \"statement_type\": \"consolidated\",\n \"framework\": \"\",\n \"currency\": \"\",\n \"origin\": \"own_filing\",\n \"filing_date\": \"\",\n \"filing_delay_days\": \"\",\n \"source_url\": \"\",\n \"accounts_type\": \"\",\n \"audit\": {\n \"status\": \"\",\n \"opinion\": \"qualified\",\n \"auditor_name\": \"\"\n },\n \"figures\": {\n \"revenue\": \"\",\n \"gross_profit\": \"\",\n \"operating_profit\": \"\",\n \"profit_before_tax\": \"\",\n \"net_profit\": \"\",\n \"personnel_costs\": \"\",\n \"depreciation\": \"\",\n \"interest_expense\": \"\",\n \"total_assets\": \"\",\n \"fixed_assets\": \"\",\n \"current_assets\": \"\",\n \"cash\": \"\",\n \"inventories\": \"\",\n \"receivables\": \"\",\n \"equity\": \"\",\n \"current_liabilities\": \"\",\n \"non_current_liabilities\": \"\",\n \"total_liabilities\": \"\",\n \"employees\": \"\",\n \"operating_cash_flow\": \"\",\n \"capital_expenditure\": \"\",\n \"free_cash_flow\": \"\",\n \"dividends_paid\": \"\",\n \"cost_of_sales\": \"\",\n \"tax_expense\": \"\",\n \"retained_earnings\": \"\",\n \"financial_debt_long_term\": \"\",\n \"financial_debt_short_term\": \"\",\n \"trade_payables\": \"\",\n \"provisions\": \"\"\n },\n \"figures_eur\": {\n \"revenue\": \"\",\n \"gross_profit\": \"\",\n \"operating_profit\": \"\",\n \"profit_before_tax\": \"\",\n \"net_profit\": \"\",\n \"personnel_costs\": \"\",\n \"depreciation\": \"\",\n \"interest_expense\": \"\",\n \"total_assets\": \"\",\n \"fixed_assets\": \"\",\n \"current_assets\": \"\",\n \"cash\": \"\",\n \"inventories\": \"\",\n \"receivables\": \"\",\n \"equity\": \"\",\n \"current_liabilities\": \"\",\n \"non_current_liabilities\": \"\",\n \"total_liabilities\": \"\",\n \"employees\": \"\",\n \"operating_cash_flow\": \"\",\n \"capital_expenditure\": \"\",\n \"free_cash_flow\": \"\",\n \"dividends_paid\": \"\",\n \"cost_of_sales\": \"\",\n \"tax_expense\": \"\",\n \"retained_earnings\": \"\",\n \"financial_debt_long_term\": \"\",\n \"financial_debt_short_term\": \"\",\n \"trade_payables\": \"\",\n \"provisions\": \"\"\n },\n \"ratios\": {\n \"gross_margin\": \"\",\n \"operating_margin\": \"\",\n \"net_margin\": \"\",\n \"ebitda\": \"\",\n \"ebitda_margin\": \"\",\n \"return_on_assets\": \"\",\n \"return_on_equity\": \"\",\n \"roce\": \"\",\n \"current_ratio\": \"\",\n \"quick_ratio\": \"\",\n \"cash_ratio\": \"\",\n \"working_capital\": \"\",\n \"equity_ratio\": \"\",\n \"debt_to_equity\": \"\",\n \"interest_cover\": \"\",\n \"asset_turnover\": \"\",\n \"days_sales_outstanding\": \"\",\n \"revenue_per_employee\": \"\",\n \"personnel_cost_share\": \"\"\n },\n \"ratios_eur\": {\n \"ebitda\": \"\",\n \"working_capital\": \"\",\n \"revenue_per_employee\": \"\"\n },\n \"ratios_basis\": \"revenue\",\n \"growth\": {\n \"revenue\": \"\",\n \"net_profit\": \"\",\n \"equity\": \"\",\n \"employees\": \"\"\n },\n \"flags\": {\n \"negative_equity\": \"\",\n \"loss_two_years\": \"\",\n \"current_ratio_below_1\": \"\",\n \"interest_cover_below_1_5\": \"\",\n \"revenue_down_over_20pct\": \"\"\n },\n \"fx\": {\n \"rate\": \"\",\n \"year_used\": \"\",\n \"basis\": \"\"\n },\n \"quality\": {\n \"has_balance_sheet\": \"\",\n \"has_profit_and_loss\": \"\",\n \"balance_check\": \"\",\n \"derived\": [\n \"\",\n \"\"\n ],\n \"is_abridged\": \"\",\n \"is_micro_entity\": \"\",\n \"is_dormant\": \"\",\n \"is_amended\": \"\",\n \"notes\": [\n \"\",\n \"\"\n ],\n \"missing\": {\n \"key_0\": \"not_collected_for_source\",\n \"key_1\": \"reported_as_gross_profit\"\n }\n },\n \"superseded\": \"\",\n \"balance_sheet\": {\n \"key_0\": \"\",\n \"key_1\": \"\",\n \"key_2\": \"\"\n },\n \"income_statement\": {\n \"key_0\": \"\",\n \"key_1\": \"\"\n },\n \"ratio_benchmarks\": {\n \"key_0\": {\n \"percentile\": \"\",\n \"cell\": {\n \"country\": \"\",\n \"nace_division\": \"\",\n \"nace_division_name\": \"\",\n \"size_band\": \"1m_10m\",\n \"year\": \"\",\n \"companies\": \"\",\n \"pooled\": \"\"\n }\n },\n \"key_1\": {\n \"percentile\": \"\",\n \"cell\": {\n \"country\": \"\",\n \"nace_division\": \"\",\n \"nace_division_name\": \"\",\n \"size_band\": \"100m_plus\",\n \"year\": \"\",\n \"companies\": \"\",\n \"pooled\": \"\"\n }\n },\n \"key_2\": {\n \"percentile\": \"\",\n \"cell\": {\n \"country\": \"\",\n \"nace_division\": \"\",\n \"nace_division_name\": \"\",\n \"size_band\": \"under_1m\",\n \"year\": \"\",\n \"companies\": \"\",\n \"pooled\": \"\"\n }\n }\n }\n },\n {\n \"fiscal_year\": \"\",\n \"period_start\": \"\",\n \"period_end\": \"\",\n \"period_days\": \"\",\n \"statement_type\": \"consolidated\",\n \"framework\": \"\",\n \"currency\": \"\",\n \"origin\": \"own_filing\",\n \"filing_date\": \"\",\n \"filing_delay_days\": \"\",\n \"source_url\": \"\",\n \"accounts_type\": \"\",\n \"audit\": {\n \"status\": \"\",\n \"opinion\": \"adverse\",\n \"auditor_name\": \"\"\n },\n \"figures\": {\n \"revenue\": \"\",\n \"gross_profit\": \"\",\n \"operating_profit\": \"\",\n \"profit_before_tax\": \"\",\n \"net_profit\": \"\",\n \"personnel_costs\": \"\",\n \"depreciation\": \"\",\n \"interest_expense\": \"\",\n \"total_assets\": \"\",\n \"fixed_assets\": \"\",\n \"current_assets\": \"\",\n \"cash\": \"\",\n \"inventories\": \"\",\n \"receivables\": \"\",\n \"equity\": \"\",\n \"current_liabilities\": \"\",\n \"non_current_liabilities\": \"\",\n \"total_liabilities\": \"\",\n \"employees\": \"\",\n \"operating_cash_flow\": \"\",\n \"capital_expenditure\": \"\",\n \"free_cash_flow\": \"\",\n \"dividends_paid\": \"\",\n \"cost_of_sales\": \"\",\n \"tax_expense\": \"\",\n \"retained_earnings\": \"\",\n \"financial_debt_long_term\": \"\",\n \"financial_debt_short_term\": \"\",\n \"trade_payables\": \"\",\n \"provisions\": \"\"\n },\n \"figures_eur\": {\n \"revenue\": \"\",\n \"gross_profit\": \"\",\n \"operating_profit\": \"\",\n \"profit_before_tax\": \"\",\n \"net_profit\": \"\",\n \"personnel_costs\": \"\",\n \"depreciation\": \"\",\n \"interest_expense\": \"\",\n \"total_assets\": \"\",\n \"fixed_assets\": \"\",\n \"current_assets\": \"\",\n \"cash\": \"\",\n \"inventories\": \"\",\n \"receivables\": \"\",\n \"equity\": \"\",\n \"current_liabilities\": \"\",\n \"non_current_liabilities\": \"\",\n \"total_liabilities\": \"\",\n \"employees\": \"\",\n \"operating_cash_flow\": \"\",\n \"capital_expenditure\": \"\",\n \"free_cash_flow\": \"\",\n \"dividends_paid\": \"\",\n \"cost_of_sales\": \"\",\n \"tax_expense\": \"\",\n \"retained_earnings\": \"\",\n \"financial_debt_long_term\": \"\",\n \"financial_debt_short_term\": \"\",\n \"trade_payables\": \"\",\n \"provisions\": \"\"\n },\n \"ratios\": {\n \"gross_margin\": \"\",\n \"operating_margin\": \"\",\n \"net_margin\": \"\",\n \"ebitda\": \"\",\n \"ebitda_margin\": \"\",\n \"return_on_assets\": \"\",\n \"return_on_equity\": \"\",\n \"roce\": \"\",\n \"current_ratio\": \"\",\n \"quick_ratio\": \"\",\n \"cash_ratio\": \"\",\n \"working_capital\": \"\",\n \"equity_ratio\": \"\",\n \"debt_to_equity\": \"\",\n \"interest_cover\": \"\",\n \"asset_turnover\": \"\",\n \"days_sales_outstanding\": \"\",\n \"revenue_per_employee\": \"\",\n \"personnel_cost_share\": \"\"\n },\n \"ratios_eur\": {\n \"ebitda\": \"\",\n \"working_capital\": \"\",\n \"revenue_per_employee\": \"\"\n },\n \"ratios_basis\": \"revenue\",\n \"growth\": {\n \"revenue\": \"\",\n \"net_profit\": \"\",\n \"equity\": \"\",\n \"employees\": \"\"\n },\n \"flags\": {\n \"negative_equity\": \"\",\n \"loss_two_years\": \"\",\n \"current_ratio_below_1\": \"\",\n \"interest_cover_below_1_5\": \"\",\n \"revenue_down_over_20pct\": \"\"\n },\n \"fx\": {\n \"rate\": \"\",\n \"year_used\": \"\",\n \"basis\": \"\"\n },\n \"quality\": {\n \"has_balance_sheet\": \"\",\n \"has_profit_and_loss\": \"\",\n \"balance_check\": \"\",\n \"derived\": [\n \"\",\n \"\"\n ],\n \"is_abridged\": \"\",\n \"is_micro_entity\": \"\",\n \"is_dormant\": \"\",\n \"is_amended\": \"\",\n \"notes\": [\n \"\",\n \"\"\n ],\n \"missing\": {\n \"key_0\": \"not_filed\",\n \"key_1\": \"not_filed\",\n \"key_2\": \"not_stated\"\n }\n },\n \"superseded\": \"\",\n \"balance_sheet\": {\n \"key_0\": \"\",\n \"key_1\": \"\",\n \"key_2\": \"\"\n },\n \"income_statement\": {\n \"key_0\": \"\",\n \"key_1\": \"\",\n \"key_2\": \"\"\n },\n \"ratio_benchmarks\": {\n \"key_0\": {\n \"percentile\": \"\",\n \"cell\": {\n \"country\": \"\",\n \"nace_division\": \"\",\n \"nace_division_name\": \"\",\n \"size_band\": \"100m_plus\",\n \"year\": \"\",\n \"companies\": \"\",\n \"pooled\": \"\"\n }\n },\n \"key_1\": {\n \"percentile\": \"\",\n \"cell\": {\n \"country\": \"\",\n \"nace_division\": \"\",\n \"nace_division_name\": \"\",\n \"size_band\": \"10m_100m\",\n \"year\": \"\",\n \"companies\": \"\",\n \"pooled\": \"\"\n }\n }\n }\n }\n ],\n \"tax_records\": [\n {\n \"tax_year\": \"\",\n \"taxable_income\": \"\",\n \"tax_assessed\": \"\",\n \"tax_refund\": \"\",\n \"residual_tax\": \"\",\n \"currency\": \"\",\n \"municipality\": \"\",\n \"reassessed\": \"\",\n \"published\": \"\",\n \"income_year\": \"\",\n \"total_income\": \"\",\n \"tax_payable\": \"\"\n },\n {\n \"tax_year\": \"\",\n \"taxable_income\": \"\",\n \"tax_assessed\": \"\",\n \"tax_refund\": \"\",\n \"residual_tax\": \"\",\n \"currency\": \"\",\n \"municipality\": \"\",\n \"reassessed\": \"\",\n \"published\": \"\",\n \"income_year\": \"\",\n \"total_income\": \"\",\n \"tax_payable\": \"\"\n }\n ]\n },\n \"meta\": {\n \"country\": \"\",\n \"availability\": \"tax_records_only\",\n \"coverage_note\": \"\",\n \"tax_note\": \"\",\n \"source\": \"\",\n \"years\": \"\",\n \"rate_limit\": {},\n \"trial_allowance\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "by-identifier", "description": "", "item": [ { "id": "cb64e706-5394-486a-896a-b023cf030e4d", "name": "Find a company by any identifier", "request": { "name": "Find a company by any identifier", "description": { "content": "Find ONE company from an identifier, with the country worked out for you, and answer it as `GET /companies/{id}` does (same company object, `include=` and the other parameters of that route, 1 credit). `type=vat`: the prefix names the country (`ESA28015865`, `FR27552032534`, `EL` is Greece, `XI` Northern Ireland, `CHE` Switzerland), then that country's VAT search runs; a bare number needs `country`. Countries whose registers publish no VAT number cannot be resolved this way (a 400 says so). `type=lei`: our GLEIF links first (`meta.resolved_by` `lei_link`); failing that, GLEIF's own record, its legal-address country and its registered-as number, searched in that country (`gleif_registration`). `type=company_number`: needs `country` (the same number exists in several countries), else a 400. `meta.resolved_by` (`vat_prefix`, `vat_with_country`, `lei_link`, `gleif_registration`, `company_number`) says which rule found the company and `meta.country` where. No match is a 404 `not_found`; several records (a US number repeated across states) a 409 `ambiguous_company_number` with `error.candidates`, as for `GET /companies/{country}/{company_number}`.", "type": "text/plain" }, "url": { "path": [ "companies", "by-identifier" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) The kind of identifier in `value`. (This can only be one of vat,lei,company_number)", "type": "text/plain" }, "key": "type", "value": "lei" }, { "disabled": false, "description": { "content": "(Required) The VAT number (spaces, dots and hyphens are ignored), the 20-character LEI or the register's company number.", "type": "text/plain" }, "key": "value", "value": "" }, { "disabled": false, "description": { "content": "Two-letter country code. Required with `type=company_number` and with a VAT number that has no prefix; optional otherwise (it narrows an LEI to that country and must agree with a VAT prefix).", "type": "text/plain" }, "key": "country", "value": "nB" }, { "disabled": false, "description": { "content": "Extra blocks to attach, as on `GET /companies/{id}`.", "type": "text/plain" }, "key": "include", "value": "" } ], "variable": [], "raw": "{{base_url}}/companies/by-identifier?type=lei&value=&country=nB&include=" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "1c1c4dc9-88c5-46ee-b1d3-ba1b953ff272", "name": "Company detail, with `meta.resolved_by` and `meta.country`", "originalRequest": { "url": { "path": [ "companies", "by-identifier" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) The kind of identifier in `value`. (This can only be one of vat,lei,company_number)", "type": "text/plain" }, "key": "type", "value": "lei" }, { "disabled": false, "description": { "content": "(Required) The VAT number (spaces, dots and hyphens are ignored), the 20-character LEI or the register's company number.", "type": "text/plain" }, "key": "value", "value": "" }, { "disabled": false, "description": { "content": "Two-letter country code. Required with `type=company_number` and with a VAT number that has no prefix; optional otherwise (it narrows an LEI to that country and must agree with a VAT prefix).", "type": "text/plain" }, "key": "country", "value": "nB" }, { "disabled": false, "description": { "content": "Extra blocks to attach, as on `GET /companies/{id}`.", "type": "text/plain" }, "key": "include", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"match_score\": \"\",\n \"country\": \"TW\",\n \"company_number\": \"\",\n \"company_name\": \"\",\n \"previous_names\": [\n {\n \"name\": \"\",\n \"from_date\": \"\",\n \"until_date\": \"\"\n }\n ],\n \"identifiers\": [\n {\n \"type\": \"\",\n \"value\": \"\"\n }\n ],\n \"vat_number\": \"\",\n \"vat_number_source\": \"rule\",\n \"lei\": \"\",\n \"legal_form\": \"\",\n \"legal_form_family\": \"\",\n \"local_legal_form\": \"\",\n \"local_legal_form_name\": \"\",\n \"status\": \"withheld\",\n \"stage\": \"unknown\",\n \"local_status\": \"\",\n \"status_date\": \"\",\n \"founding_date\": \"\",\n \"registration_date\": \"\",\n \"dissolution_date\": \"\",\n \"activity_code\": \"\",\n \"activity_code_scheme\": \"LT-NACE-2025\",\n \"activity_description\": \"\",\n \"activity_description_en\": \"\",\n \"nace_class\": \"\",\n \"nace_version\": \"\",\n \"nace_division\": \"\",\n \"nace_derived\": \"\",\n \"secondary_activity_codes\": [\n {\n \"code\": \"\",\n \"scheme\": \"\",\n \"description\": \"\"\n }\n ],\n \"business_purpose\": \"\",\n \"address\": \"\",\n \"postal_code\": \"\",\n \"city\": \"\",\n \"municipality\": \"\",\n \"region\": \"\",\n \"address_country\": \"\",\n \"capital_amount\": \"\",\n \"capital_currency\": \"\",\n \"capital_eur\": \"\",\n \"employees\": \"\",\n \"employee_band\": \"\",\n \"website\": \"\",\n \"website_source\": {\n \"method\": \"id_on_site\",\n \"confidence\": \"\",\n \"found_in\": \"\",\n \"source_url\": \"\",\n \"checked_at\": \"\"\n },\n \"register\": \"\",\n \"first_seen_date\": \"\",\n \"last_seen_date\": \"\",\n \"updated_at\": \"\",\n \"registry_details\": {\n \"key_0\": true,\n \"key_1\": \"string\",\n \"key_2\": 7032.749191920507\n },\n \"contacts\": [\n {\n \"id\": \"\",\n \"person_id\": \"\",\n \"organ\": \"supervisory_board\",\n \"organ_name\": \"\",\n \"role_type\": \"\",\n \"role_description\": \"\",\n \"person_name_raw\": \"\",\n \"name_masked\": \"\",\n \"is_legal_entity\": \"\",\n \"regon\": \"\",\n \"suspended\": \"\",\n \"suspended_until\": \"\",\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"full_name\": \"\",\n \"role\": \"\",\n \"appointment_date\": \"\",\n \"end_date\": \"\",\n \"is_current\": \"\"\n }\n ],\n \"appointments\": [\n {\n \"key_0\": 6547.993730708087,\n \"key_1\": 2170,\n \"key_2\": \"string\"\n }\n ],\n \"representation\": [\n {\n \"key_0\": false\n }\n ],\n \"recent_events\": [\n {\n \"key_0\": 6903,\n \"key_1\": \"string\",\n \"key_2\": \"string\",\n \"key_3\": 5479\n }\n ],\n \"lei_record\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"corporate_structure\": {\n \"lei\": \"\",\n \"lei_name\": \"\",\n \"lei_registration_status\": \"\",\n \"direct_parent\": {\n \"lei\": \"\",\n \"name\": \"\",\n \"country\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"relationship_registration_status\": \"\",\n \"corroboration\": \"\",\n \"since\": \"\"\n },\n \"direct_parent_exception\": \"\",\n \"ultimate_parent\": {\n \"lei\": \"\",\n \"name\": \"\",\n \"country\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"relationship_registration_status\": \"\",\n \"corroboration\": \"\",\n \"since\": \"\"\n },\n \"ultimate_parent_exception\": \"\",\n \"direct_subsidiaries\": \"\",\n \"source\": \"\",\n \"data_as_of\": \"\",\n \"register_ownership\": {\n \"sole_shareholder\": {\n \"name\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"lei\": \"\",\n \"link\": \"\",\n \"since\": \"\",\n \"borme_id\": \"\",\n \"entry_number\": \"\"\n },\n \"ultimate_owner\": {\n \"name\": \"\",\n \"lei\": \"\",\n \"country\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"path_length\": \"\",\n \"basis\": \"borme_chain_gleif\"\n },\n \"branch_of\": {\n \"parent_name\": \"\",\n \"lei\": \"\",\n \"country\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"link\": \"\"\n },\n \"solely_owned_subsidiaries\": {\n \"count\": \"\",\n \"group_members\": \"\",\n \"items\": [\n {\n \"company_id\": \"\",\n \"company_number\": \"\",\n \"company_name\": \"\",\n \"status\": \"\"\n }\n ],\n \"truncated\": \"\"\n },\n \"source\": \"\",\n \"data_as_of\": \"\"\n }\n },\n \"latest_financials\": {\n \"fiscal_year\": \"\",\n \"period_start\": \"\",\n \"period_end\": \"\",\n \"period_days\": \"\",\n \"statement_type\": \"individual\",\n \"framework\": \"\",\n \"currency\": \"\",\n \"origin\": \"comparative\",\n \"filing_date\": \"\",\n \"filing_delay_days\": \"\",\n \"source_url\": \"\",\n \"accounts_type\": \"\",\n \"audit\": {\n \"status\": \"\",\n \"opinion\": null,\n \"auditor_name\": \"\"\n },\n \"figures\": {\n \"revenue\": \"\",\n \"gross_profit\": \"\",\n \"operating_profit\": \"\",\n \"profit_before_tax\": \"\",\n \"net_profit\": \"\",\n \"personnel_costs\": \"\",\n \"depreciation\": \"\",\n \"interest_expense\": \"\",\n \"total_assets\": \"\",\n \"fixed_assets\": \"\",\n \"current_assets\": \"\",\n \"cash\": \"\",\n \"inventories\": \"\",\n \"receivables\": \"\",\n \"equity\": \"\",\n \"current_liabilities\": \"\",\n \"non_current_liabilities\": \"\",\n \"total_liabilities\": \"\",\n \"employees\": \"\",\n \"operating_cash_flow\": \"\",\n \"capital_expenditure\": \"\",\n \"free_cash_flow\": \"\",\n \"dividends_paid\": \"\",\n \"cost_of_sales\": \"\",\n \"tax_expense\": \"\",\n \"retained_earnings\": \"\",\n \"financial_debt_long_term\": \"\",\n \"financial_debt_short_term\": \"\",\n \"trade_payables\": \"\",\n \"provisions\": \"\"\n },\n \"figures_eur\": {\n \"revenue\": \"\",\n \"gross_profit\": \"\",\n \"operating_profit\": \"\",\n \"profit_before_tax\": \"\",\n \"net_profit\": \"\",\n \"personnel_costs\": \"\",\n \"depreciation\": \"\",\n \"interest_expense\": \"\",\n \"total_assets\": \"\",\n \"fixed_assets\": \"\",\n \"current_assets\": \"\",\n \"cash\": \"\",\n \"inventories\": \"\",\n \"receivables\": \"\",\n \"equity\": \"\",\n \"current_liabilities\": \"\",\n \"non_current_liabilities\": \"\",\n \"total_liabilities\": \"\",\n \"employees\": \"\",\n \"operating_cash_flow\": \"\",\n \"capital_expenditure\": \"\",\n \"free_cash_flow\": \"\",\n \"dividends_paid\": \"\",\n \"cost_of_sales\": \"\",\n \"tax_expense\": \"\",\n \"retained_earnings\": \"\",\n \"financial_debt_long_term\": \"\",\n \"financial_debt_short_term\": \"\",\n \"trade_payables\": \"\",\n \"provisions\": \"\"\n },\n \"ratios\": {\n \"gross_margin\": \"\",\n \"operating_margin\": \"\",\n \"net_margin\": \"\",\n \"ebitda\": \"\",\n \"ebitda_margin\": \"\",\n \"return_on_assets\": \"\",\n \"return_on_equity\": \"\",\n \"roce\": \"\",\n \"current_ratio\": \"\",\n \"quick_ratio\": \"\",\n \"cash_ratio\": \"\",\n \"working_capital\": \"\",\n \"equity_ratio\": \"\",\n \"debt_to_equity\": \"\",\n \"interest_cover\": \"\",\n \"asset_turnover\": \"\",\n \"days_sales_outstanding\": \"\",\n \"revenue_per_employee\": \"\",\n \"personnel_cost_share\": \"\"\n },\n \"ratios_eur\": {\n \"ebitda\": \"\",\n \"working_capital\": \"\",\n \"revenue_per_employee\": \"\"\n },\n \"ratios_basis\": \"revenue\",\n \"growth\": {\n \"revenue\": \"\",\n \"net_profit\": \"\",\n \"equity\": \"\",\n \"employees\": \"\"\n },\n \"flags\": {\n \"negative_equity\": \"\",\n \"loss_two_years\": \"\",\n \"current_ratio_below_1\": \"\",\n \"interest_cover_below_1_5\": \"\",\n \"revenue_down_over_20pct\": \"\"\n },\n \"fx\": {\n \"rate\": \"\",\n \"year_used\": \"\",\n \"basis\": \"\"\n },\n \"quality\": {\n \"has_balance_sheet\": \"\",\n \"has_profit_and_loss\": \"\",\n \"balance_check\": \"\",\n \"derived\": [\n \"\"\n ],\n \"is_abridged\": \"\",\n \"is_micro_entity\": \"\",\n \"is_dormant\": \"\",\n \"is_amended\": \"\",\n \"notes\": [\n \"\"\n ],\n \"missing\": {\n \"key_0\": \"not_collected_for_source\",\n \"key_1\": \"not_filed\"\n }\n },\n \"superseded\": \"\",\n \"balance_sheet\": {\n \"key_0\": \"\",\n \"key_1\": \"\",\n \"key_2\": \"\",\n \"key_3\": \"\"\n },\n \"income_statement\": {\n \"key_0\": \"\",\n \"key_1\": \"\"\n },\n \"ratio_benchmarks\": {\n \"key_0\": {\n \"percentile\": \"\",\n \"cell\": {\n \"country\": \"\",\n \"nace_division\": \"\",\n \"nace_division_name\": \"\",\n \"size_band\": \"100m_plus\",\n \"year\": \"\",\n \"companies\": \"\",\n \"pooled\": \"\"\n }\n },\n \"key_1\": {\n \"percentile\": \"\",\n \"cell\": {\n \"country\": \"\",\n \"nace_division\": \"\",\n \"nace_division_name\": \"\",\n \"size_band\": \"1m_10m\",\n \"year\": \"\",\n \"companies\": \"\",\n \"pooled\": \"\"\n }\n }\n }\n }\n },\n \"meta\": {\n \"resolved_by\": \"vat_with_country\",\n \"country\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "{country}", "description": "", "item": [ { "name": "{company_number}", "description": "", "item": [ { "id": "5a29352b-0480-4084-b518-0ed701aa8240", "name": "Get company by its registry number", "request": { "name": "Get company by its registry number", "description": { "content": "Fetch a company profile by the customer's own number instead of our id: `GET /companies/{country}/{company_number}`, for example `/companies/ES/A28015865` (NIF), `/companies/FR/552120222` (SIREN; a 14-digit SIRET also works), `/companies/GB/00445790`, `/companies/PL/0000028860` (KRS), `/companies/DK/12345678` (CVR). The number is resolved exactly as `/companies/search?country=&company_number=` resolves it (same validators: a malformed number is a 400 `validation_error` with an `X-Error-Code` header), then the answer is exactly what `GET /companies/{id}?country=` returns, with `include=` and the other query parameters of that route. Costs 1 credit. Nothing found is a 404 `not_found`. A number that more than one company carries (US registers repeat numbers across states, a German commercial-register entry repeats across courts) is a **409 `ambiguous_company_number`** with `error.candidates` (id, company_name, company_number, status, country); fetch the one you mean with `GET /companies/{id}?country=`. 409 rather than 300 because HTTP clients treat a 3xx as a redirect to follow, and the situation is a conflict the caller must resolve, not a choice the server may make.", "type": "text/plain" }, "url": { "path": [ "companies", ":country", ":company_number" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "Comma-separated extra blocks to attach: `procurement`, `insolvency`, `financials`, `lei`, `risk_flags`, `structure`, `charges` (GB: asks Companies House for the company's charges when the nightly crawl has not reached it yet; the summary is in `registry_details.charges`) — or `all` (which adds `lei` and `risk_flags`; `procurement`, `insolvency`, `financials` and `structure` are named explicitly). `structure` adds `corporate_structure`, the company's direct and ultimate parent as reported to GLEIF (Level 2, CC0), for a company of any live country that carries a Legal Entity Identifier; null with a `meta.notice` when no LEI is linked to the company (not reported, not no parent). For a Spanish company the block is returned even without an LEI (the GLEIF fields null) and carries `register_ownership`: the sole shareholder named by the BORME sole-shareholder notices since 2009 (companies only, natural persons are never served), the ultimate owner by the chain of those notices and then GLEIF's ultimate parent, the foreign parent of a branch (W NIF) and the companies it solely owns; a null `sole_shareholder` means no notice names a company, not that there is no owner. `financials` adds `latest_financials`, the latest current annual statement (same shape as one entry of GET /companies/{id}/financials; the company's own before its group's) for GB, FR, DK, SE and NO, for FI (statements filed digitally with PRH, and listed groups) for US SEC filers, EE, LT and RO (headline figures), LV, CO (Superintendencia de Sociedades filers) and BR (listed companies), for US SEC filers, EE, LT and RO (headline figures), LV, CO (Superintendencia de Sociedades filers) and BR (listed companies), and for listed companies in ES, PL, HR and BE, for keys with the `financials` scope (Scale plan and above); for other keys the field is left out with a `meta.notice`, and for other countries it is null with a notice. Annual accounts as filed (outside France, digitally filed accounts only); see GET /companies/{id}/financials for the scope limits. `procurement` adds the company's latest awards for ES, FR, GB, IE, PL and NO (`procurement.top_awards`). `insolvency` adds the Spanish concurso proceedings from the BORME entries for ES (`insolvency_proceedings`) and the corporate insolvency notices linked by registry number for FR, GB, NO, FI, DK, HR, SE, CH, LV and EE (`insolvency_notices`; a Swiss notice only where it names the debtor's UID). A block a country does not carry is named in `meta.notice`; a block that could not be read is null with a `meta.notice` (unknown, not empty). `risk_flags` returns two kinds of entry: `registry_compliance` (ES, GB, IE, NO), the register's own signal that the company has stopped meeting its filing duties (`signal` = sheet_closed, strike_off_proposed, accounts_overdue, strike_off_listed or forced_dissolution, dated in `as_of`), and the Spain-only AEAT tax-debtor entries (`tax_debt`), which are point-in-time and OCR-derived, each stating via `identifier_source` whether its identifier was read directly from the source or reconstructed with name corroboration.", "type": "text/plain" }, "key": "include", "value": "" }, { "disabled": false, "description": { "content": "Officer appointments returned, 1 to 500 (default 100). Current appointments (no end date, not a cessation) come first, then the history, each newest first, so the default page holds every current officer of a company that has up to 100. Outside the range is a 400 validation_error; it is never clamped.", "type": "text/plain" }, "key": "appointments_limit", "value": "100" }, { "disabled": false, "description": { "content": "Appointments to skip in the current-first order, an integer of 0 or more.", "type": "text/plain" }, "key": "appointments_offset", "value": "0" }, { "disabled": false, "description": { "content": "Recent corporate events returned, 1 to 200 (default 25). Outside the range is a 400 validation_error.", "type": "text/plain" }, "key": "events_limit", "value": "25" }, { "disabled": false, "description": { "content": "Events to skip, an integer of 0 or more.", "type": "text/plain" }, "key": "events_offset", "value": "0" } ], "variable": [ { "type": "any", "value": "nB", "key": "country", "disabled": false, "description": { "content": "(Required) Two-letter country code of a live registry country (ES, FR, GB, ...), upper or lower case.", "type": "text/plain" } }, { "type": "any", "value": "", "key": "company_number", "disabled": false, "description": { "content": "(Required) The register's number for the country: NIF/CIF (ES), SIREN or SIRET (FR), company number (GB, IE), KRS (PL), organisation number (NO), CVR (DK), and so on; for a German commercial-register entry (HRB12653) encode a slash as %2F.", "type": "text/plain" } } ], "raw": "{{base_url}}/companies/:country/:company_number?include=&appointments_limit=100&appointments_offset=0&events_limit=25&events_offset=0" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "1714fea5-2d85-4ef1-b69b-a5a75a0cb2ee", "name": "Company detail", "originalRequest": { "url": { "path": [ "companies", ":country", ":company_number" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Comma-separated extra blocks to attach: `procurement`, `insolvency`, `financials`, `lei`, `risk_flags`, `structure`, `charges` (GB: asks Companies House for the company's charges when the nightly crawl has not reached it yet; the summary is in `registry_details.charges`) — or `all` (which adds `lei` and `risk_flags`; `procurement`, `insolvency`, `financials` and `structure` are named explicitly). `structure` adds `corporate_structure`, the company's direct and ultimate parent as reported to GLEIF (Level 2, CC0), for a company of any live country that carries a Legal Entity Identifier; null with a `meta.notice` when no LEI is linked to the company (not reported, not no parent). For a Spanish company the block is returned even without an LEI (the GLEIF fields null) and carries `register_ownership`: the sole shareholder named by the BORME sole-shareholder notices since 2009 (companies only, natural persons are never served), the ultimate owner by the chain of those notices and then GLEIF's ultimate parent, the foreign parent of a branch (W NIF) and the companies it solely owns; a null `sole_shareholder` means no notice names a company, not that there is no owner. `financials` adds `latest_financials`, the latest current annual statement (same shape as one entry of GET /companies/{id}/financials; the company's own before its group's) for GB, FR, DK, SE and NO, for FI (statements filed digitally with PRH, and listed groups) for US SEC filers, EE, LT and RO (headline figures), LV, CO (Superintendencia de Sociedades filers) and BR (listed companies), for US SEC filers, EE, LT and RO (headline figures), LV, CO (Superintendencia de Sociedades filers) and BR (listed companies), and for listed companies in ES, PL, HR and BE, for keys with the `financials` scope (Scale plan and above); for other keys the field is left out with a `meta.notice`, and for other countries it is null with a notice. Annual accounts as filed (outside France, digitally filed accounts only); see GET /companies/{id}/financials for the scope limits. `procurement` adds the company's latest awards for ES, FR, GB, IE, PL and NO (`procurement.top_awards`). `insolvency` adds the Spanish concurso proceedings from the BORME entries for ES (`insolvency_proceedings`) and the corporate insolvency notices linked by registry number for FR, GB, NO, FI, DK, HR, SE, CH, LV and EE (`insolvency_notices`; a Swiss notice only where it names the debtor's UID). A block a country does not carry is named in `meta.notice`; a block that could not be read is null with a `meta.notice` (unknown, not empty). `risk_flags` returns two kinds of entry: `registry_compliance` (ES, GB, IE, NO), the register's own signal that the company has stopped meeting its filing duties (`signal` = sheet_closed, strike_off_proposed, accounts_overdue, strike_off_listed or forced_dissolution, dated in `as_of`), and the Spain-only AEAT tax-debtor entries (`tax_debt`), which are point-in-time and OCR-derived, each stating via `identifier_source` whether its identifier was read directly from the source or reconstructed with name corroboration.", "type": "text/plain" }, "key": "include", "value": "" }, { "disabled": false, "description": { "content": "Officer appointments returned, 1 to 500 (default 100). Current appointments (no end date, not a cessation) come first, then the history, each newest first, so the default page holds every current officer of a company that has up to 100. Outside the range is a 400 validation_error; it is never clamped.", "type": "text/plain" }, "key": "appointments_limit", "value": "100" }, { "disabled": false, "description": { "content": "Appointments to skip in the current-first order, an integer of 0 or more.", "type": "text/plain" }, "key": "appointments_offset", "value": "0" }, { "disabled": false, "description": { "content": "Recent corporate events returned, 1 to 200 (default 25). Outside the range is a 400 validation_error.", "type": "text/plain" }, "key": "events_limit", "value": "25" }, { "disabled": false, "description": { "content": "Events to skip, an integer of 0 or more.", "type": "text/plain" }, "key": "events_offset", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Two-letter country code of a live registry country (ES, FR, GB, ...), upper or lower case.", "type": "text/plain" }, "type": "any", "value": "nB", "key": "country" }, { "disabled": false, "description": { "content": "(Required) The register's number for the country: NIF/CIF (ES), SIREN or SIRET (FR), company number (GB, IE), KRS (PL), organisation number (NO), CVR (DK), and so on; for a German commercial-register entry (HRB12653) encode a slash as %2F.", "type": "text/plain" }, "type": "any", "value": "", "key": "company_number" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"match_score\": \"\",\n \"country\": \"NO\",\n \"company_number\": \"\",\n \"company_name\": \"\",\n \"previous_names\": [\n {\n \"name\": \"\",\n \"from_date\": \"\",\n \"until_date\": \"\"\n }\n ],\n \"identifiers\": [\n {\n \"type\": \"\",\n \"value\": \"\"\n }\n ],\n \"vat_number\": \"\",\n \"vat_number_source\": \"register\",\n \"lei\": \"\",\n \"legal_form\": \"\",\n \"legal_form_family\": \"\",\n \"local_legal_form\": \"\",\n \"local_legal_form_name\": \"\",\n \"status\": \"suspended\",\n \"stage\": \"distress\",\n \"local_status\": \"\",\n \"status_date\": \"\",\n \"founding_date\": \"\",\n \"registration_date\": \"\",\n \"dissolution_date\": \"\",\n \"activity_code\": \"\",\n \"activity_code_scheme\": \"CAEN-2003\",\n \"activity_description\": \"\",\n \"activity_description_en\": \"\",\n \"nace_class\": \"\",\n \"nace_version\": \"\",\n \"nace_division\": \"\",\n \"nace_derived\": \"\",\n \"secondary_activity_codes\": [\n {\n \"code\": \"\",\n \"scheme\": \"\",\n \"description\": \"\"\n }\n ],\n \"business_purpose\": \"\",\n \"address\": \"\",\n \"postal_code\": \"\",\n \"city\": \"\",\n \"municipality\": \"\",\n \"region\": \"\",\n \"address_country\": \"\",\n \"capital_amount\": \"\",\n \"capital_currency\": \"\",\n \"capital_eur\": \"\",\n \"employees\": \"\",\n \"employee_band\": \"\",\n \"website\": \"\",\n \"website_source\": {\n \"method\": \"email_domain\",\n \"confidence\": \"\",\n \"found_in\": \"\",\n \"source_url\": \"\",\n \"checked_at\": \"\"\n },\n \"register\": \"\",\n \"first_seen_date\": \"\",\n \"last_seen_date\": \"\",\n \"updated_at\": \"\",\n \"registry_details\": {\n \"key_0\": \"string\"\n },\n \"contacts\": [\n {\n \"id\": \"\",\n \"person_id\": \"\",\n \"organ\": \"representing_partners\",\n \"organ_name\": \"\",\n \"role_type\": \"\",\n \"role_description\": \"\",\n \"person_name_raw\": \"\",\n \"name_masked\": \"\",\n \"is_legal_entity\": \"\",\n \"regon\": \"\",\n \"suspended\": \"\",\n \"suspended_until\": \"\",\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"full_name\": \"\",\n \"role\": \"\",\n \"appointment_date\": \"\",\n \"end_date\": \"\",\n \"is_current\": \"\"\n }\n ],\n \"appointments\": [\n {\n \"key_0\": 6590,\n \"key_1\": true,\n \"key_2\": 8101\n }\n ],\n \"representation\": [\n {\n \"key_0\": \"string\",\n \"key_1\": 6668.647284635483\n }\n ],\n \"recent_events\": [\n {\n \"key_0\": 1782.3294443881232,\n \"key_1\": false\n }\n ],\n \"lei_record\": {\n \"key_0\": 6354,\n \"key_1\": \"string\"\n },\n \"corporate_structure\": {\n \"lei\": \"\",\n \"lei_name\": \"\",\n \"lei_registration_status\": \"\",\n \"direct_parent\": {\n \"lei\": \"\",\n \"name\": \"\",\n \"country\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"relationship_registration_status\": \"\",\n \"corroboration\": \"\",\n \"since\": \"\"\n },\n \"direct_parent_exception\": \"\",\n \"ultimate_parent\": {\n \"lei\": \"\",\n \"name\": \"\",\n \"country\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"relationship_registration_status\": \"\",\n \"corroboration\": \"\",\n \"since\": \"\"\n },\n \"ultimate_parent_exception\": \"\",\n \"direct_subsidiaries\": \"\",\n \"source\": \"\",\n \"data_as_of\": \"\",\n \"register_ownership\": {\n \"sole_shareholder\": {\n \"name\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"lei\": \"\",\n \"link\": \"\",\n \"since\": \"\",\n \"borme_id\": \"\",\n \"entry_number\": \"\"\n },\n \"ultimate_owner\": {\n \"name\": \"\",\n \"lei\": \"\",\n \"country\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"path_length\": \"\",\n \"basis\": \"borme_chain_gleif\"\n },\n \"branch_of\": {\n \"parent_name\": \"\",\n \"lei\": \"\",\n \"country\": \"\",\n \"company_id\": \"\",\n \"company_country\": \"\",\n \"link\": \"\"\n },\n \"solely_owned_subsidiaries\": {\n \"count\": \"\",\n \"group_members\": \"\",\n \"items\": [\n {\n \"company_id\": \"\",\n \"company_number\": \"\",\n \"company_name\": \"\",\n \"status\": \"\"\n }\n ],\n \"truncated\": \"\"\n },\n \"source\": \"\",\n \"data_as_of\": \"\"\n }\n },\n \"latest_financials\": {\n \"fiscal_year\": \"\",\n \"period_start\": \"\",\n \"period_end\": \"\",\n \"period_days\": \"\",\n \"statement_type\": \"consolidated\",\n \"framework\": \"\",\n \"currency\": \"\",\n \"origin\": \"own_filing\",\n \"filing_date\": \"\",\n \"filing_delay_days\": \"\",\n \"source_url\": \"\",\n \"accounts_type\": \"\",\n \"audit\": {\n \"status\": \"\",\n \"opinion\": \"unqualified\",\n \"auditor_name\": \"\"\n },\n \"figures\": {\n \"revenue\": \"\",\n \"gross_profit\": \"\",\n \"operating_profit\": \"\",\n \"profit_before_tax\": \"\",\n \"net_profit\": \"\",\n \"personnel_costs\": \"\",\n \"depreciation\": \"\",\n \"interest_expense\": \"\",\n \"total_assets\": \"\",\n \"fixed_assets\": \"\",\n \"current_assets\": \"\",\n \"cash\": \"\",\n \"inventories\": \"\",\n \"receivables\": \"\",\n \"equity\": \"\",\n \"current_liabilities\": \"\",\n \"non_current_liabilities\": \"\",\n \"total_liabilities\": \"\",\n \"employees\": \"\",\n \"operating_cash_flow\": \"\",\n \"capital_expenditure\": \"\",\n \"free_cash_flow\": \"\",\n \"dividends_paid\": \"\",\n \"cost_of_sales\": \"\",\n \"tax_expense\": \"\",\n \"retained_earnings\": \"\",\n \"financial_debt_long_term\": \"\",\n \"financial_debt_short_term\": \"\",\n \"trade_payables\": \"\",\n \"provisions\": \"\"\n },\n \"figures_eur\": {\n \"revenue\": \"\",\n \"gross_profit\": \"\",\n \"operating_profit\": \"\",\n \"profit_before_tax\": \"\",\n \"net_profit\": \"\",\n \"personnel_costs\": \"\",\n \"depreciation\": \"\",\n \"interest_expense\": \"\",\n \"total_assets\": \"\",\n \"fixed_assets\": \"\",\n \"current_assets\": \"\",\n \"cash\": \"\",\n \"inventories\": \"\",\n \"receivables\": \"\",\n \"equity\": \"\",\n \"current_liabilities\": \"\",\n \"non_current_liabilities\": \"\",\n \"total_liabilities\": \"\",\n \"employees\": \"\",\n \"operating_cash_flow\": \"\",\n \"capital_expenditure\": \"\",\n \"free_cash_flow\": \"\",\n \"dividends_paid\": \"\",\n \"cost_of_sales\": \"\",\n \"tax_expense\": \"\",\n \"retained_earnings\": \"\",\n \"financial_debt_long_term\": \"\",\n \"financial_debt_short_term\": \"\",\n \"trade_payables\": \"\",\n \"provisions\": \"\"\n },\n \"ratios\": {\n \"gross_margin\": \"\",\n \"operating_margin\": \"\",\n \"net_margin\": \"\",\n \"ebitda\": \"\",\n \"ebitda_margin\": \"\",\n \"return_on_assets\": \"\",\n \"return_on_equity\": \"\",\n \"roce\": \"\",\n \"current_ratio\": \"\",\n \"quick_ratio\": \"\",\n \"cash_ratio\": \"\",\n \"working_capital\": \"\",\n \"equity_ratio\": \"\",\n \"debt_to_equity\": \"\",\n \"interest_cover\": \"\",\n \"asset_turnover\": \"\",\n \"days_sales_outstanding\": \"\",\n \"revenue_per_employee\": \"\",\n \"personnel_cost_share\": \"\"\n },\n \"ratios_eur\": {\n \"ebitda\": \"\",\n \"working_capital\": \"\",\n \"revenue_per_employee\": \"\"\n },\n \"ratios_basis\": \"gross_profit\",\n \"growth\": {\n \"revenue\": \"\",\n \"net_profit\": \"\",\n \"equity\": \"\",\n \"employees\": \"\"\n },\n \"flags\": {\n \"negative_equity\": \"\",\n \"loss_two_years\": \"\",\n \"current_ratio_below_1\": \"\",\n \"interest_cover_below_1_5\": \"\",\n \"revenue_down_over_20pct\": \"\"\n },\n \"fx\": {\n \"rate\": \"\",\n \"year_used\": \"\",\n \"basis\": \"\"\n },\n \"quality\": {\n \"has_balance_sheet\": \"\",\n \"has_profit_and_loss\": \"\",\n \"balance_check\": \"\",\n \"derived\": [\n \"\"\n ],\n \"is_abridged\": \"\",\n \"is_micro_entity\": \"\",\n \"is_dormant\": \"\",\n \"is_amended\": \"\",\n \"notes\": [\n \"\"\n ],\n \"missing\": {\n \"key_0\": \"reported_as_gross_profit\",\n \"key_1\": \"not_published_by_register\"\n }\n },\n \"superseded\": \"\",\n \"balance_sheet\": {\n \"key_0\": \"\",\n \"key_1\": \"\"\n },\n \"income_statement\": {\n \"key_0\": \"\"\n },\n \"ratio_benchmarks\": {\n \"key_0\": {\n \"percentile\": \"\",\n \"cell\": {\n \"country\": \"\",\n \"nace_division\": \"\",\n \"nace_division_name\": \"\",\n \"size_band\": \"under_1m\",\n \"year\": \"\",\n \"companies\": \"\",\n \"pooled\": \"\"\n }\n },\n \"key_1\": {\n \"percentile\": \"\",\n \"cell\": {\n \"country\": \"\",\n \"nace_division\": \"\",\n \"nace_division_name\": \"\",\n \"size_band\": \"under_1m\",\n \"year\": \"\",\n \"companies\": \"\",\n \"pooled\": \"\"\n }\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "lookup", "description": "", "item": [ { "id": "45b0e13f-b9d0-4d63-8cb3-1495f28dec42", "name": "Resolve up to 100 companies in one call", "request": { "name": "Resolve up to 100 companies in one call", "description": { "content": "Batch form of `GET /companies/search`. Each item resolves through the same rules as the single-endpoint call (country routing, surface ids, match scoring). Every item costs 1 credit against the plan's per-minute, daily and monthly limits; a batch that does not fit is refused up front with 429 `batch_exceeds_quota` and `max_items_now`. Items are processed in parallel groups; anything not finished inside the time budget comes back as `timeout` and can be resent. Supports an optional `Idempotency-Key` header (see the parameter) for safe replay of the whole batch.", "type": "text/plain" }, "url": { "path": [ "companies", "lookup" ], "host": [ "{{base_url}}" ], "query": [], "variable": [], "raw": "{{base_url}}/companies/lookup" }, "header": [ { "disabled": false, "description": { "content": "Optional, per draft-ietf-httpapi-idempotency-key-header. 1-255 printable ASCII characters, else 400 `validation_error`. Scoped to the API key. A replay of the same key with the same request (method + path + a canonical, sorted-key hash of the body) within 24 hours returns the original 2xx response with `Idempotent-Replayed: true` and writes no new usage row (it costs no credits). The same key with a different body is 422 `idempotency_key_reuse`. A replay while the first attempt is still running is 409 `idempotency_key_in_progress` with `Retry-After`. Only 2xx results are stored — a 4xx/5xx (or an internal timeout) releases the key so the client can retry; a 2xx body over ~200 KB also releases the key (nothing is stored) rather than fail the request. Omitting the header changes nothing about the request.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"country\": \"LV\",\n \"company_number\": \"\",\n \"nif\": \"\",\n \"siren\": \"\",\n \"vat\": \"\",\n \"name\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "response": [ { "id": "2cb9b3da-621d-4f0a-94d0-48e0f1e9361d", "name": "Results in request order", "originalRequest": { "url": { "path": [ "companies", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Optional, per draft-ietf-httpapi-idempotency-key-header. 1-255 printable ASCII characters, else 400 `validation_error`. Scoped to the API key. A replay of the same key with the same request (method + path + a canonical, sorted-key hash of the body) within 24 hours returns the original 2xx response with `Idempotent-Replayed: true` and writes no new usage row (it costs no credits). The same key with a different body is 422 `idempotency_key_reuse`. A replay while the first attempt is still running is 409 `idempotency_key_in_progress` with `Retry-After`. Only 2xx results are stored — a 4xx/5xx (or an internal timeout) releases the key so the client can retry; a 2xx body over ~200 KB also releases the key (nothing is stored) rather than fail the request. Omitting the header changes nothing about the request.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"country\": \"LV\",\n \"company_number\": \"\",\n \"nif\": \"\",\n \"siren\": \"\",\n \"vat\": \"\",\n \"name\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replayed", "value": "" } ], "body": "{\n \"data\": [\n {\n \"index\": \"\",\n \"input\": {\n \"key_0\": 3015,\n \"key_1\": \"string\",\n \"key_2\": 7168.242881267829\n },\n \"error\": \"\",\n \"status\": \"error\",\n \"company\": {\n \"id\": \"\",\n \"match_score\": \"\",\n \"country\": \"CA\",\n \"company_number\": \"\",\n \"company_name\": \"\",\n \"previous_names\": [\n {\n \"name\": \"\",\n \"from_date\": \"\",\n \"until_date\": \"\"\n },\n {\n \"name\": \"\",\n \"from_date\": \"\",\n \"until_date\": \"\"\n }\n ],\n \"identifiers\": [\n {\n \"type\": \"\",\n \"value\": \"\"\n },\n {\n \"type\": \"\",\n \"value\": \"\"\n }\n ],\n \"vat_number\": \"\",\n \"vat_number_source\": \"register\",\n \"lei\": \"\",\n \"legal_form\": \"\",\n \"legal_form_family\": \"\",\n \"local_legal_form\": \"\",\n \"local_legal_form_name\": \"\",\n \"status\": \"in_dissolution\",\n \"stage\": \"closed\",\n \"local_status\": \"\",\n \"status_date\": \"\",\n \"founding_date\": \"\",\n \"registration_date\": \"\",\n \"dissolution_date\": \"\",\n \"activity_code\": \"\",\n \"activity_code_scheme\": \"EMTAK-2008\",\n \"activity_description\": \"\",\n \"activity_description_en\": \"\",\n \"nace_class\": \"\",\n \"nace_version\": \"\",\n \"nace_division\": \"\",\n \"nace_derived\": \"\",\n \"secondary_activity_codes\": [\n {\n \"code\": \"\",\n \"scheme\": \"\",\n \"description\": \"\"\n },\n {\n \"code\": \"\",\n \"scheme\": \"\",\n \"description\": \"\"\n }\n ],\n \"business_purpose\": \"\",\n \"address\": \"\",\n \"postal_code\": \"\",\n \"city\": \"\",\n \"municipality\": \"\",\n \"region\": \"\",\n \"address_country\": \"\",\n \"capital_amount\": \"\",\n \"capital_currency\": \"\",\n \"capital_eur\": \"\",\n \"employees\": \"\",\n \"employee_band\": \"\",\n \"website\": \"\",\n \"website_source\": {\n \"method\": \"email_domain\",\n \"confidence\": \"\",\n \"found_in\": \"\",\n \"source_url\": \"\",\n \"checked_at\": \"\"\n },\n \"register\": \"\",\n \"first_seen_date\": \"\",\n \"last_seen_date\": \"\",\n \"updated_at\": \"\",\n \"registry_details\": {\n \"key_0\": false\n }\n },\n \"match_score\": \"\"\n },\n {\n \"index\": \"\",\n \"input\": {\n \"key_0\": 1702,\n \"key_1\": 5182.2119206286125\n },\n \"error\": \"\",\n \"status\": \"timeout\",\n \"company\": {\n \"id\": \"\",\n \"match_score\": \"\",\n \"country\": \"SG\",\n \"company_number\": \"\",\n \"company_name\": \"\",\n \"previous_names\": [\n {\n \"name\": \"\",\n \"from_date\": \"\",\n \"until_date\": \"\"\n },\n {\n \"name\": \"\",\n \"from_date\": \"\",\n \"until_date\": \"\"\n }\n ],\n \"identifiers\": [\n {\n \"type\": \"\",\n \"value\": \"\"\n },\n {\n \"type\": \"\",\n \"value\": \"\"\n }\n ],\n \"vat_number\": \"\",\n \"vat_number_source\": \"register\",\n \"lei\": \"\",\n \"legal_form\": \"\",\n \"legal_form_family\": \"\",\n \"local_legal_form\": \"\",\n \"local_legal_form_name\": \"\",\n \"status\": \"merged\",\n \"stage\": \"distress\",\n \"local_status\": \"\",\n \"status_date\": \"\",\n \"founding_date\": \"\",\n \"registration_date\": \"\",\n \"dissolution_date\": \"\",\n \"activity_code\": \"\",\n \"activity_code_scheme\": \"TW-TAX-SIC\",\n \"activity_description\": \"\",\n \"activity_description_en\": \"\",\n \"nace_class\": \"\",\n \"nace_version\": \"\",\n \"nace_division\": \"\",\n \"nace_derived\": \"\",\n \"secondary_activity_codes\": [\n {\n \"code\": \"\",\n \"scheme\": \"\",\n \"description\": \"\"\n },\n {\n \"code\": \"\",\n \"scheme\": \"\",\n \"description\": \"\"\n }\n ],\n \"business_purpose\": \"\",\n \"address\": \"\",\n \"postal_code\": \"\",\n \"city\": \"\",\n \"municipality\": \"\",\n \"region\": \"\",\n \"address_country\": \"\",\n \"capital_amount\": \"\",\n \"capital_currency\": \"\",\n \"capital_eur\": \"\",\n \"employees\": \"\",\n \"employee_band\": \"\",\n \"website\": \"\",\n \"website_source\": {\n \"method\": \"email_domain\",\n \"confidence\": \"\",\n \"found_in\": \"\",\n \"source_url\": \"\",\n \"checked_at\": \"\"\n },\n \"register\": \"\",\n \"first_seen_date\": \"\",\n \"last_seen_date\": \"\",\n \"updated_at\": \"\",\n \"registry_details\": {\n \"key_0\": 7091\n }\n },\n \"match_score\": \"\"\n }\n ],\n \"meta\": {\n \"items\": \"\",\n \"errors\": \"\",\n \"query_ms\": \"\",\n \"note\": \"\",\n \"rate_limit\": {\n \"key_0\": true,\n \"key_1\": 562.2389001197814,\n \"key_2\": 8616,\n \"key_3\": 4941.673913318554\n },\n \"found\": \"\",\n \"not_found\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "people", "description": "", "item": [ { "name": "search", "description": "", "item": [ { "id": "764db52d-9cc9-4341-98f4-811ce38fb74d", "name": "Search people by name", "request": { "name": "Search people by name", "description": { "content": "Search officers, directors and PSCs by name across ES (BORME), FR (BODACC), GB (Companies House) and NO (Enhetsregisteret roles register). Returns a ranked list of person summaries; use /people/{id} for full detail. Requires the `people` scope (Starter tier and above). Ireland is company-level (no people data). Poland has no person records either: the KRS publishes natural persons masked, so Polish officers are only in `appointments` on the company record. Norwegian officers carry a year-month (YYYY-MM) date of birth only, and Norwegian person ids are returned raw rather than country-offset.", "type": "text/plain" }, "url": { "path": [ "people", "search" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "(Required) Person name (normalized pattern match). Minimum 2 characters.", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "1-100, default 20.", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Pagination cursor from the previous response.", "type": "text/plain" }, "key": "cursor", "value": "" } ], "variable": [], "raw": "{{base_url}}/people/search?country=ES&name=&limit=20&cursor=" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "e6638958-ef80-4a81-b576-292d9cc34d35", "name": "Matching people", "originalRequest": { "url": { "path": [ "people", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "(Required) Person name (normalized pattern match). Minimum 2 characters.", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "1-100, default 20.", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Pagination cursor from the previous response.", "type": "text/plain" }, "key": "cursor", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"match_score\": \"\",\n \"full_name\": \"\",\n \"nif\": \"\",\n \"is_legal_entity\": \"\",\n \"first_seen_date\": \"\",\n \"last_seen_date\": \"\",\n \"appointments\": [\n {\n \"id\": \"\",\n \"person_id\": \"\",\n \"organ\": \"representing_partners\",\n \"organ_name\": \"\",\n \"role_type\": \"\",\n \"role_description\": \"\",\n \"person_name_raw\": \"\",\n \"name_masked\": \"\",\n \"is_legal_entity\": \"\",\n \"regon\": \"\",\n \"suspended\": \"\",\n \"suspended_until\": \"\",\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"full_name\": \"\",\n \"role\": \"\",\n \"appointment_date\": \"\",\n \"end_date\": \"\",\n \"is_current\": \"\"\n },\n {\n \"id\": \"\",\n \"person_id\": \"\",\n \"organ\": \"management_board\",\n \"organ_name\": \"\",\n \"role_type\": \"\",\n \"role_description\": \"\",\n \"person_name_raw\": \"\",\n \"name_masked\": \"\",\n \"is_legal_entity\": \"\",\n \"regon\": \"\",\n \"suspended\": \"\",\n \"suspended_until\": \"\",\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"full_name\": \"\",\n \"role\": \"\",\n \"appointment_date\": \"\",\n \"end_date\": \"\",\n \"is_current\": \"\"\n }\n ],\n \"created_at\": \"\"\n },\n {\n \"id\": \"\",\n \"match_score\": \"\",\n \"full_name\": \"\",\n \"nif\": \"\",\n \"is_legal_entity\": \"\",\n \"first_seen_date\": \"\",\n \"last_seen_date\": \"\",\n \"appointments\": [\n {\n \"id\": \"\",\n \"person_id\": \"\",\n \"organ\": \"proxy\",\n \"organ_name\": \"\",\n \"role_type\": \"\",\n \"role_description\": \"\",\n \"person_name_raw\": \"\",\n \"name_masked\": \"\",\n \"is_legal_entity\": \"\",\n \"regon\": \"\",\n \"suspended\": \"\",\n \"suspended_until\": \"\",\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"full_name\": \"\",\n \"role\": \"\",\n \"appointment_date\": \"\",\n \"end_date\": \"\",\n \"is_current\": \"\"\n },\n {\n \"id\": \"\",\n \"person_id\": \"\",\n \"organ\": \"audit_committee\",\n \"organ_name\": \"\",\n \"role_type\": \"\",\n \"role_description\": \"\",\n \"person_name_raw\": \"\",\n \"name_masked\": \"\",\n \"is_legal_entity\": \"\",\n \"regon\": \"\",\n \"suspended\": \"\",\n \"suspended_until\": \"\",\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"full_name\": \"\",\n \"role\": \"\",\n \"appointment_date\": \"\",\n \"end_date\": \"\",\n \"is_current\": \"\"\n }\n ],\n \"created_at\": \"\"\n }\n ],\n \"pagination\": {\n \"count\": \"\",\n \"has_more\": \"\",\n \"next_cursor\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "{id}", "description": "", "item": [ { "id": "a2f0142c-7c0d-4422-a6d1-4c3883ba1b9b", "name": "Get person by ID", "request": { "name": "Get person by ID", "description": { "content": "Fetch a single person (officer / director) by numeric ID. Returns full name, NIF (if available), and a list of all known company appointments — past and current. UK disqualified directors: on a GB person, `disqualifications` is the person's entry on the Companies House register of disqualified directors (orders and undertakings under the Company Directors Disqualification Act 1986, and sanctions-regime disqualifications) with each period, the section of the Act, whether it is an order, an undertaking or a sanction, and the companies named; null when the person is not on the register. Matched on the words of the full name and the month and year of birth together (the register publishes no id shared with the officer records), so only persons with significant control, whose birth month is held, can match, never a director listed without a birth month; two register entries with the same name and birth month match nobody; `match_basis` says whether a company named in the disqualification is also one the person is linked to. An identity match on those signals, not a determination. Month and year of birth only, no address. Contains public sector information licensed under the Open Government Licence v3.0.", "type": "text/plain" }, "url": { "path": [ "people", ":id" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "Officer appointments returned, 1 to 500 (default 100). Current appointments (no end date, not a cessation) come first, then the history, each newest first, so the default page holds every current officer of a company that has up to 100. Outside the range is a 400 validation_error; it is never clamped.", "type": "text/plain" }, "key": "appointments_limit", "value": "100" }, { "disabled": false, "description": { "content": "Appointments to skip in the current-first order, an integer of 0 or more.", "type": "text/plain" }, "key": "appointments_offset", "value": "0" } ], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Numeric internal ID", "type": "text/plain" } } ], "raw": "{{base_url}}/people/:id?appointments_limit=100&appointments_offset=0" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "d6ef17d0-f653-413f-b977-a60a1950a28c", "name": "Person detail", "originalRequest": { "url": { "path": [ "people", ":id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Officer appointments returned, 1 to 500 (default 100). Current appointments (no end date, not a cessation) come first, then the history, each newest first, so the default page holds every current officer of a company that has up to 100. Outside the range is a 400 validation_error; it is never clamped.", "type": "text/plain" }, "key": "appointments_limit", "value": "100" }, { "disabled": false, "description": { "content": "Appointments to skip in the current-first order, an integer of 0 or more.", "type": "text/plain" }, "key": "appointments_offset", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Numeric internal ID", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"match_score\": \"\",\n \"full_name\": \"\",\n \"nif\": \"\",\n \"is_legal_entity\": \"\",\n \"first_seen_date\": \"\",\n \"last_seen_date\": \"\",\n \"appointments\": [\n {\n \"id\": \"\",\n \"person_id\": \"\",\n \"organ\": \"audit_committee\",\n \"organ_name\": \"\",\n \"role_type\": \"\",\n \"role_description\": \"\",\n \"person_name_raw\": \"\",\n \"name_masked\": \"\",\n \"is_legal_entity\": \"\",\n \"regon\": \"\",\n \"suspended\": \"\",\n \"suspended_until\": \"\",\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"full_name\": \"\",\n \"role\": \"\",\n \"appointment_date\": \"\",\n \"end_date\": \"\",\n \"is_current\": \"\"\n },\n {\n \"id\": \"\",\n \"person_id\": \"\",\n \"organ\": \"audit_committee\",\n \"organ_name\": \"\",\n \"role_type\": \"\",\n \"role_description\": \"\",\n \"person_name_raw\": \"\",\n \"name_masked\": \"\",\n \"is_legal_entity\": \"\",\n \"regon\": \"\",\n \"suspended\": \"\",\n \"suspended_until\": \"\",\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"full_name\": \"\",\n \"role\": \"\",\n \"appointment_date\": \"\",\n \"end_date\": \"\",\n \"is_current\": \"\"\n }\n ],\n \"created_at\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "company-events", "description": "", "item": [ { "name": "search", "description": "", "item": [ { "id": "920e83d5-ea53-4094-aaf7-b7ca649610fd", "name": "Search corporate events, or a country's event feed", "request": { "name": "Search corporate events, or a country's event feed", "description": { "content": "Search normalized company lifecycle events by company name or registration number. Without either, the call is the country's event feed (since 17 Oct 2026): every event of `country` (then required), newest first, from `date_from` (default 7 days ago, at most 31 days back) to `date_to`, filterable by `event_type`, paged with the same `cursor`, 2 credits a call; `meta.search_mode` is `country_feed` and `meta.feed_window` states the window. A `date_from` older than 31 days is refused with 400. Event types: `new_incorporation`, `director_change`, `capital_change`, `address_change`, `name_change`, `merger`, `demerger`, `dissolution`, `liquidation`, `insolvency`, `status_change`, `filing`, `correction`, `object_change`, `bylaws_change`, `legal_form_change`, `ownership_change`, `power_of_attorney`, `sale_of_business`, `debt_default`, `registry_closure`, `registry_reopening`, `reactivation`, `litigation`, `securities_issue`, `branch`, `charge`, `resolution`, `website`, `other`. 9 Oct 2026: 19 finer types are served; `event_type=status_change` now matches only status changes no finer type describes (for ES it matches no BORME act any more); `power_of_attorney` (BORME Apoderamiento) used to be `director_change`, `securities_issue` used to be `capital_change`, `sale_of_business` (FR vente/cession) used to be `merger`. FI/SE/BE/HR/DK/EE/SK/US register-change events now carry `legal_form_change`, `reactivation` and `other` (removed from register) instead of `status_change`. Signals: `registry_closure`, `debt_default` and `litigation` are `distress`; `reactivation` and `registry_reopening` are `growth`; the rest of the new types are `neutral`. Matches for ES, FR and GB alike, derived from each register's own act/filing code (see `Event.act_type`); a raw GB Companies House code (e.g. `OFFICER_CHANGE`) still works as an alias. Norway, Ireland and Poland publish no corporate-event gazette: `country=NO|IE|PL` returns register-change events (name, status, legal form, registered address), dated when the change first appears in the register data, none before 14 Oct 2026 (the same act types as below). Finland, Sweden, Belgium, Croatia, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus, Romania, Lithuania, Canada, Australia, Japan, Israel, Singapore, Colombia, Taiwan, Brazil, the Czech Republic, Germany, the Netherlands and the United States publish no gazette either: `country=FI|SE|BE|HR|DK|EE|SK|CH|LV|CY|RO|US|LT|CA|AU|JP|IL|SG|CO|TW|BR|CZ|DE|NL|UA|RS|EC` returns register-change events (`act_type` `registered`, `name_change`, `legal_form_change`, `address_change` (not for UA: its register publishes no address), `capital_change` for HR, EE, SK, CH, LV, LT, TW, BR, CZ and UA, `status:`, `removed_from_register`, `returned_to_register`), dated by the load that first saw the change (`raw_data.date_basis` is `first_seen_in_register`), never by the date the register published it. An empty list means no change has been seen yet. Switzerland also serves the commercial-register publications of the Swiss Official Gazette of Commerce (SHAB) as gazette events from publications of 1 January 2024: `act_type` `shab_registration`, `shab_name_change`, `shab_seat_change`, `shab_address_change`, `shab_purpose_change`, `shab_capital_change`, `shab_legal_form_change`, `shab_board_change`, `shab_signatory_change`, `shab_auditor_change`, `shab_merger`, `shab_demerger`, `shab_asset_transfer`, `shab_branch_change`, `shab_liquidation`, `shab_liquidation_revoked`, `shab_bankruptcy`, `shab_bankruptcy_ended`, `shab_bankruptcy_revoked`, `shab_suspension`, `shab_reentry`, `shab_deletion` (and `shab_deletion_merger`, `shab_deletion_bankruptcy`, `shab_deletion_liquidation`, `shab_deletion_procedure`), dated by the publication date (`raw_data.date_basis` is `publication_date`, `raw_data.publication_number` names the publication), `notice_url` the SHAB publication, linked by UID; where the register-change event of the same change (name, address, capital, legal form, liquidation, bankruptcy) is already there, within 14 days, it carries the SHAB `notice_url` and `raw_data.publication_number` instead of a second event; legal entities and branches only; the notice text and the names of board members and signatories are never served (a board or signatory change says only that persons changed); the gazette events are a summary derived from the SOGC publications and the publication linked as `notice_url` is the authoritative text. Contains data from the Swiss Official Gazette of Commerce (SOGC/SHAB), State Secretariat for Economic Affairs (SECO), via the Official Gazettes Portal. Not an official publication; the legally binding text is the signed publication on amtsblattportal.ch.", "type": "text/plain" }, "url": { "path": [ "company-events", "search" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "A company name to search its events. Leave it out, with company_number, for the country feed.", "type": "text/plain" }, "key": "company_name", "value": "" }, { "disabled": false, "description": { "content": "A registration number (for FR the SIREN). Leave it out, with company_name, for the country feed.", "type": "text/plain" }, "key": "company_number", "value": "" }, { "disabled": false, "description": { "content": "One of the documented enum values (translated internally to the underlying register act codes), or a raw register code kept as an alias for backward compatibility (e.g. GB's `OFFICER_CHANGE`). Behaviour change on 2026-09-27: until then every ES and FR event carried `event_type: status_change`, so `event_type=status_change` matched all of them; it now matches only the events no more specific type describes. 9 Oct 2026: 19 finer types served; event_type=status_change now matches only status changes no finer type describes. (This can only be one of new_incorporation,director_change,capital_change,address_change,name_change,merger,demerger,dissolution,liquidation,insolvency,status_change,filing,correction,object_change,bylaws_change,legal_form_change,ownership_change,power_of_attorney,sale_of_business,debt_default,registry_closure,registry_reopening,reactivation,litigation,securities_issue,branch,charge,resolution,website,other)", "type": "text/plain" }, "key": "event_type", "value": "correction" }, { "disabled": false, "description": { "content": "Earliest event date (YYYY-MM-DD). In the country feed: default 7 days ago, at most 31 days back.", "type": "text/plain" }, "key": "date_from", "value": "" }, { "disabled": false, "description": { "content": "Latest event date (YYYY-MM-DD).", "type": "text/plain" }, "key": "date_to", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Pagination cursor from the previous response's `pagination.next_cursor`, passed back unchanged. A name search issues `o:`; the other lists issue an id or `YYYY-MM-DD_`.", "type": "text/plain" }, "key": "cursor", "value": "" }, { "disabled": false, "description": { "content": "`notice` attaches to each event the publication behind it as `notice` {id, source (BORME, BODACC or Companies House), published_date, reference, type, court, region, url}, or null for events of other countries (they have no notice). Replaces GET /notices/{id}, which was removed on 6 October 2026 (410 `gone`). (This can only be one of notice)", "type": "text/plain" }, "key": "include", "value": "notice" } ], "variable": [], "raw": "{{base_url}}/company-events/search?country=ES&company_name=&company_number=&event_type=correction&date_from=&date_to=&limit=20&cursor=&include=notice" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "e4eb0340-a08b-4199-94dc-36998a841668", "name": "Event search results", "originalRequest": { "url": { "path": [ "company-events", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "A company name to search its events. Leave it out, with company_number, for the country feed.", "type": "text/plain" }, "key": "company_name", "value": "" }, { "disabled": false, "description": { "content": "A registration number (for FR the SIREN). Leave it out, with company_name, for the country feed.", "type": "text/plain" }, "key": "company_number", "value": "" }, { "disabled": false, "description": { "content": "One of the documented enum values (translated internally to the underlying register act codes), or a raw register code kept as an alias for backward compatibility (e.g. GB's `OFFICER_CHANGE`). Behaviour change on 2026-09-27: until then every ES and FR event carried `event_type: status_change`, so `event_type=status_change` matched all of them; it now matches only the events no more specific type describes. 9 Oct 2026: 19 finer types served; event_type=status_change now matches only status changes no finer type describes. (This can only be one of new_incorporation,director_change,capital_change,address_change,name_change,merger,demerger,dissolution,liquidation,insolvency,status_change,filing,correction,object_change,bylaws_change,legal_form_change,ownership_change,power_of_attorney,sale_of_business,debt_default,registry_closure,registry_reopening,reactivation,litigation,securities_issue,branch,charge,resolution,website,other)", "type": "text/plain" }, "key": "event_type", "value": "correction" }, { "disabled": false, "description": { "content": "Earliest event date (YYYY-MM-DD). In the country feed: default 7 days ago, at most 31 days back.", "type": "text/plain" }, "key": "date_from", "value": "" }, { "disabled": false, "description": { "content": "Latest event date (YYYY-MM-DD).", "type": "text/plain" }, "key": "date_to", "value": "" }, { "disabled": false, "description": { "content": "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.", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Pagination cursor from the previous response's `pagination.next_cursor`, passed back unchanged. A name search issues `o:`; the other lists issue an id or `YYYY-MM-DD_`.", "type": "text/plain" }, "key": "cursor", "value": "" }, { "disabled": false, "description": { "content": "`notice` attaches to each event the publication behind it as `notice` {id, source (BORME, BODACC or Companies House), published_date, reference, type, court, region, url}, or null for events of other countries (they have no notice). Replaces GET /notices/{id}, which was removed on 6 October 2026 (410 `gone`). (This can only be one of notice)", "type": "text/plain" }, "key": "include", "value": "notice" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"vat_number\": \"\",\n \"country\": \"BE\",\n \"source\": \"\",\n \"event_type\": \"litigation\",\n \"act_type\": \"\",\n \"event_date\": \"\",\n \"previous_value\": \"\",\n \"new_value\": \"\",\n \"event_detail\": \"\",\n \"notice_url\": \"\",\n \"notice\": {\n \"id\": \"\",\n \"source\": \"BORME\",\n \"published_date\": \"\",\n \"reference\": \"\",\n \"type\": \"\",\n \"court\": \"\",\n \"region\": \"\",\n \"url\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"vat_number\": \"\",\n \"country\": \"RO\",\n \"source\": \"\",\n \"event_type\": \"legal_form_change\",\n \"act_type\": \"\",\n \"event_date\": \"\",\n \"previous_value\": \"\",\n \"new_value\": \"\",\n \"event_detail\": \"\",\n \"notice_url\": \"\",\n \"notice\": {\n \"id\": \"\",\n \"source\": \"Companies House\",\n \"published_date\": \"\",\n \"reference\": \"\",\n \"type\": \"\",\n \"court\": \"\",\n \"region\": \"\",\n \"url\": \"\"\n }\n }\n ],\n \"pagination\": {\n \"count\": \"\",\n \"has_more\": \"\",\n \"next_cursor\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "records", "description": "", "item": [ { "name": "{id}", "description": "", "item": [ { "id": "33fd6a28-17b8-4184-83b5-d11e51ee3874", "name": "Get corporate event by ID", "request": { "name": "Get corporate event by ID", "description": { "content": "Fetch a single corporate event by numeric ID. Returns full event detail including `raw_data` (omitted from search results). Ids emitted for FI, SE, BE, HR, DK, EE, SK, CH, LV, CY, RO, LT, CA, AU, JP, IL, SG, CO, TW, BR, CZ, DE, NL, UA, RS, EC and US resolve here like any other.", "type": "text/plain" }, "url": { "path": [ "company-events", "records", ":id" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "`notice` attaches to each event the publication behind it as `notice` {id, source (BORME, BODACC or Companies House), published_date, reference, type, court, region, url}, or null for events of other countries (they have no notice). Replaces GET /notices/{id}, which was removed on 6 October 2026 (410 `gone`). (This can only be one of notice)", "type": "text/plain" }, "key": "include", "value": "notice" } ], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Numeric internal ID", "type": "text/plain" } } ], "raw": "{{base_url}}/company-events/records/:id?include=notice" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "90a147a6-7a2d-4ade-a142-db16c628c462", "name": "Event detail", "originalRequest": { "url": { "path": [ "company-events", "records", ":id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "`notice` attaches to each event the publication behind it as `notice` {id, source (BORME, BODACC or Companies House), published_date, reference, type, court, region, url}, or null for events of other countries (they have no notice). Replaces GET /notices/{id}, which was removed on 6 October 2026 (410 `gone`). (This can only be one of notice)", "type": "text/plain" }, "key": "include", "value": "notice" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Numeric internal ID", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"vat_number\": \"\",\n \"country\": \"FI\",\n \"source\": \"\",\n \"event_type\": \"capital_change\",\n \"act_type\": \"\",\n \"event_date\": \"\",\n \"previous_value\": \"\",\n \"new_value\": \"\",\n \"event_detail\": \"\",\n \"notice_url\": \"\",\n \"notice\": {\n \"id\": \"\",\n \"source\": \"BODACC\",\n \"published_date\": \"\",\n \"reference\": \"\",\n \"type\": \"\",\n \"court\": \"\",\n \"region\": \"\",\n \"url\": \"\"\n },\n \"raw_data\": {\n \"key_0\": \"string\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "timeline", "description": "", "item": [ { "id": "ab80a839-fa92-47ed-a6b0-e0c11e91cb2a", "name": "Corporate event timeline", "request": { "name": "Corporate event timeline", "description": { "content": "Returns the event history for a single company, newest first (ordered by event date, most recent first). One of `company_number` or `company_name` is required. For `country=FI|SE|BE|HR|DK|EE|SK|CH|LV|CY|RO|US|LT|CA|AU|JP|IL|SG|CO|TW|BR|CZ|DE|NL|UA|RS|EC` the timeline holds register-change events, dated when first seen in the register data (for the United States, the weekly read of the registers that first sees it).", "type": "text/plain" }, "url": { "path": [ "company-events", "timeline" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "company_number", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "company_name", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "`notice` attaches to each event the publication behind it as `notice` {id, source (BORME, BODACC or Companies House), published_date, reference, type, court, region, url}, or null for events of other countries (they have no notice). Replaces GET /notices/{id}, which was removed on 6 October 2026 (410 `gone`). (This can only be one of notice)", "type": "text/plain" }, "key": "include", "value": "notice" } ], "variable": [], "raw": "{{base_url}}/company-events/timeline?country=ES&company_number=&company_name=&limit=50&include=notice" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "e528388b-2f2c-43f2-ab03-f08b67c0ba77", "name": "Event timeline", "originalRequest": { "url": { "path": [ "company-events", "timeline" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "company_number", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "company_name", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "`notice` attaches to each event the publication behind it as `notice` {id, source (BORME, BODACC or Companies House), published_date, reference, type, court, region, url}, or null for events of other countries (they have no notice). Replaces GET /notices/{id}, which was removed on 6 October 2026 (410 `gone`). (This can only be one of notice)", "type": "text/plain" }, "key": "include", "value": "notice" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"vat_number\": \"\",\n \"country\": \"CY\",\n \"source\": \"\",\n \"event_type\": \"reactivation\",\n \"act_type\": \"\",\n \"event_date\": \"\",\n \"previous_value\": \"\",\n \"new_value\": \"\",\n \"event_detail\": \"\",\n \"notice_url\": \"\",\n \"notice\": {\n \"id\": \"\",\n \"source\": \"Companies House\",\n \"published_date\": \"\",\n \"reference\": \"\",\n \"type\": \"\",\n \"court\": \"\",\n \"region\": \"\",\n \"url\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"vat_number\": \"\",\n \"country\": \"CY\",\n \"source\": \"\",\n \"event_type\": \"charge\",\n \"act_type\": \"\",\n \"event_date\": \"\",\n \"previous_value\": \"\",\n \"new_value\": \"\",\n \"event_detail\": \"\",\n \"notice_url\": \"\",\n \"notice\": {\n \"id\": \"\",\n \"source\": \"BORME\",\n \"published_date\": \"\",\n \"reference\": \"\",\n \"type\": \"\",\n \"court\": \"\",\n \"region\": \"\",\n \"url\": \"\"\n }\n }\n ],\n \"meta\": {\n \"query_ms\": \"\",\n \"search_mode\": \"\",\n \"country\": \"PL\",\n \"rate_limit\": {\n \"rpm_remaining\": \"\",\n \"daily_remaining\": \"\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "sanctions", "description": "", "item": [ { "name": "screen", "description": "", "item": [ { "id": "799ab388-931a-4f14-82b0-7c89c370c2da", "name": "Screen a name against sanctions lists (BETA)", "request": { "name": "Screen a name against sanctions lists (BETA)", "description": { "content": "**BETA. Do not use as the sole sanctions control until announced GA.**\n\nTrigram fuzzy match of a person or entity name against the EU consolidated list, the UN sanctions list, OFAC, the UK Sanctions List, and the Australian DFAT Consolidated List (list code `DFAT`; Source: Department of Foreign Affairs and Trade website – www.dfat.gov.au (Australian Sanctions Consolidated List), licensed CC BY 4.0. Adapted by Prometiam.). Returns matched entities with confidence scores. Names in non-Latin scripts (Cyrillic, Greek, Arabic and others) are transliterated to Latin letters, in the query and in the listed names, before matching, so a name sent in its own script (Руслан Александрович Ромашкин) and the same name in Latin spelling (Ruslan Aleksandrovich Romashkin) match the same listed entity.\n\n`match_score` is the match type, as on company search: 100 the listed name or alias is the query, 80-99 it starts with the query's words, 50-79 it holds them as whole words, under 50 only parts of words (a screen for Sberbank no longer scores 100 on every name that contains it); `threshold` still sets how similar a name must be to be returned, and hits come best first. `country` is the ISO 3166-1 alpha-2 code where the country could be placed (RU for RUSSIE, RUSSIAN FEDERATION and Russia); the list's own spelling is `country_as_listed`. The same entity on several lists appears once per list unless `group=entity` is set; `meta.grouping_hint` says so when it happens.", "type": "text/plain" }, "url": { "path": [ "sanctions", "screen" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Name to screen", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "Minimum match-confidence percentage (50–100)", "type": "text/plain" }, "key": "threshold", "value": "80" }, { "disabled": false, "description": { "content": "Filter by entity type. Stored values: `person`, `company`, `vessel`, `aircraft`, `unknown` (the list does not say). `any` (or omitted) applies no filter; `entity` is a legacy alias of `company`. Any other value is a 400 `validation_error`. (This can only be one of person,company,vessel,aircraft,unknown,any,entity)", "type": "text/plain" }, "key": "entity_type", "value": "any" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Also screen against politically exposed persons (BETA, Spain only, from Wikidata) and return a separate `pep` block. Membership is by OCCUPATION, not office: 44% of the set has no recorded office and local officials (6,108) outnumber national ones (3,191). Every hit carries `positions[]`, `pep_tier` and `has_current_office`. Deceased people are never returned: a person is deceased when Wikidata records a date of death, and one born 100 or more years ago with no recorded death is presumed deceased; a deceased person never has a current office. Contains NO relatives or close associates, so it does not by itself satisfy a FATF PEP obligation. Omitted entirely unless requested.", "type": "text/plain" }, "key": "include_pep", "value": "" }, { "disabled": false, "description": { "content": "Only return PEP hits at or above this tier. Omit to receive every hit including those with no recorded office — suppressing them by default would hide 44% of the set behind a threshold you never set. (This can only be one of national,regional,local)", "type": "text/plain" }, "key": "pep_min_tier", "value": "local" }, { "disabled": false, "description": { "content": "Set to `entity` to fold hits into one row per listed person or company: the best-scoring listing's fields plus `lists[]` (distinct source lists) and `sources[]` (every listing with its own id, program, dates, notice_url and match_score). Default keeps one row per listing (the same entity on several lists appears once per list, and `meta.grouping_hint` says so); `meta.distinct_entities` and `meta.hit_count` are reported in both modes. (This can only be one of entity)", "type": "text/plain" }, "key": "group", "value": "entity" } ], "variable": [], "raw": "{{base_url}}/sanctions/screen?name=&threshold=80&entity_type=any&limit=20&include_pep=&pep_min_tier=local&group=entity" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "86d645aa-f930-4dcf-857e-9a64c8f28849", "name": "Sanctions match results", "originalRequest": { "url": { "path": [ "sanctions", "screen" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Name to screen", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "Minimum match-confidence percentage (50–100)", "type": "text/plain" }, "key": "threshold", "value": "80" }, { "disabled": false, "description": { "content": "Filter by entity type. Stored values: `person`, `company`, `vessel`, `aircraft`, `unknown` (the list does not say). `any` (or omitted) applies no filter; `entity` is a legacy alias of `company`. Any other value is a 400 `validation_error`. (This can only be one of person,company,vessel,aircraft,unknown,any,entity)", "type": "text/plain" }, "key": "entity_type", "value": "any" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Also screen against politically exposed persons (BETA, Spain only, from Wikidata) and return a separate `pep` block. Membership is by OCCUPATION, not office: 44% of the set has no recorded office and local officials (6,108) outnumber national ones (3,191). Every hit carries `positions[]`, `pep_tier` and `has_current_office`. Deceased people are never returned: a person is deceased when Wikidata records a date of death, and one born 100 or more years ago with no recorded death is presumed deceased; a deceased person never has a current office. Contains NO relatives or close associates, so it does not by itself satisfy a FATF PEP obligation. Omitted entirely unless requested.", "type": "text/plain" }, "key": "include_pep", "value": "" }, { "disabled": false, "description": { "content": "Only return PEP hits at or above this tier. Omit to receive every hit including those with no recorded office — suppressing them by default would hide 44% of the set behind a threshold you never set. (This can only be one of national,regional,local)", "type": "text/plain" }, "key": "pep_min_tier", "value": "local" }, { "disabled": false, "description": { "content": "Set to `entity` to fold hits into one row per listed person or company: the best-scoring listing's fields plus `lists[]` (distinct source lists) and `sources[]` (every listing with its own id, program, dates, notice_url and match_score). Default keeps one row per listing (the same entity on several lists appears once per list, and `meta.grouping_hint` says so); `meta.distinct_entities` and `meta.hit_count` are reported in both modes. (This can only be one of entity)", "type": "text/plain" }, "key": "group", "value": "entity" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"entity_name\": \"\",\n \"entity_type\": \"person\",\n \"aliases\": [\n \"\",\n \"\"\n ],\n \"country\": \"\",\n \"nationality\": \"\",\n \"date_of_birth\": \"\",\n \"date_of_birth_raw\": \"\",\n \"date_of_incorporation\": \"\",\n \"identification_numbers\": {},\n \"source_list\": \"\",\n \"program\": \"\",\n \"program_detail\": \"\",\n \"listing_date\": \"\",\n \"delisting_date\": \"\",\n \"is_active\": \"\",\n \"notice_url\": \"\",\n \"match_score\": \"\",\n \"matched_name\": \"\",\n \"matched_on\": \"name\"\n },\n {\n \"id\": \"\",\n \"entity_name\": \"\",\n \"entity_type\": \"company\",\n \"aliases\": [\n \"\",\n \"\"\n ],\n \"country\": \"\",\n \"nationality\": \"\",\n \"date_of_birth\": \"\",\n \"date_of_birth_raw\": \"\",\n \"date_of_incorporation\": \"\",\n \"identification_numbers\": {},\n \"source_list\": \"\",\n \"program\": \"\",\n \"program_detail\": \"\",\n \"listing_date\": \"\",\n \"delisting_date\": \"\",\n \"is_active\": \"\",\n \"notice_url\": \"\",\n \"match_score\": \"\",\n \"matched_name\": \"\",\n \"matched_on\": \"alias\"\n }\n ],\n \"meta\": {\n \"query_ms\": \"\",\n \"search_mode\": \"\",\n \"country\": \"NO\",\n \"rate_limit\": {\n \"rpm_remaining\": \"\",\n \"daily_remaining\": \"\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9c9e677e-27b3-4341-ac95-50a8488f2205", "name": "Screen up to 50 names in one call", "request": { "name": "Screen up to 50 names in one call", "description": { "content": "Batch form of `GET /sanctions/screen`. Send `items` (name plus optional dob, entity_type, country) or the shorthand `names`. Shared options `threshold`, `list`, `active_only`, `group` and `limit` (hits per name, default 10) apply to every item. Requires the sanctions scope: batch calls do not draw on the free trial allowance. Every item costs what the same single call costs (3 credits for a screened name) against the plan's per-minute, daily and monthly limits; a batch that does not fit is refused up front with 429 `batch_exceeds_quota` and `max_items_now`. Supports an optional `Idempotency-Key` header (see the parameter) for safe replay of the whole batch.", "type": "text/plain" }, "url": { "path": [ "sanctions", "screen" ], "host": [ "{{base_url}}" ], "query": [], "variable": [], "raw": "{{base_url}}/sanctions/screen" }, "header": [ { "disabled": false, "description": { "content": "Optional, per draft-ietf-httpapi-idempotency-key-header. 1-255 printable ASCII characters, else 400 `validation_error`. Scoped to the API key. A replay of the same key with the same request (method + path + a canonical, sorted-key hash of the body) within 24 hours returns the original 2xx response with `Idempotent-Replayed: true` and writes no new usage row (it costs no credits). The same key with a different body is 422 `idempotency_key_reuse`. A replay while the first attempt is still running is 409 `idempotency_key_in_progress` with `Retry-After`. Only 2xx results are stored — a 4xx/5xx (or an internal timeout) releases the key so the client can retry; a 2xx body over ~200 KB also releases the key (nothing is stored) rather than fail the request. Omitting the header changes nothing about the request.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"name\": \"\",\n \"dob\": \"\",\n \"entity_type\": \"vessel\",\n \"country\": \"\"\n }\n ],\n \"names\": [\n \"\",\n \"\"\n ],\n \"threshold\": 80,\n \"list\": \"\",\n \"active_only\": true,\n \"group\": \"entity\",\n \"limit\": 10\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "response": [ { "id": "2c330cdd-0a3c-463d-963a-6df6bdf8cea7", "name": "Results in request order", "originalRequest": { "url": { "path": [ "sanctions", "screen" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Optional, per draft-ietf-httpapi-idempotency-key-header. 1-255 printable ASCII characters, else 400 `validation_error`. Scoped to the API key. A replay of the same key with the same request (method + path + a canonical, sorted-key hash of the body) within 24 hours returns the original 2xx response with `Idempotent-Replayed: true` and writes no new usage row (it costs no credits). The same key with a different body is 422 `idempotency_key_reuse`. A replay while the first attempt is still running is 409 `idempotency_key_in_progress` with `Retry-After`. Only 2xx results are stored — a 4xx/5xx (or an internal timeout) releases the key so the client can retry; a 2xx body over ~200 KB also releases the key (nothing is stored) rather than fail the request. Omitting the header changes nothing about the request.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"name\": \"\",\n \"dob\": \"\",\n \"entity_type\": \"vessel\",\n \"country\": \"\"\n }\n ],\n \"names\": [\n \"\",\n \"\"\n ],\n \"threshold\": 80,\n \"list\": \"\",\n \"active_only\": true,\n \"group\": \"entity\",\n \"limit\": 10\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replayed", "value": "" } ], "body": "{\n \"data\": [\n {\n \"index\": \"\",\n \"input\": {\n \"key_0\": 1933,\n \"key_1\": \"string\",\n \"key_2\": 5770.517918916738\n },\n \"error\": \"\",\n \"status\": \"clear\",\n \"hits\": [\n {\n \"id\": \"\",\n \"entity_name\": \"\",\n \"entity_type\": \"unknown\",\n \"aliases\": [\n \"\",\n \"\"\n ],\n \"country\": \"\",\n \"nationality\": \"\",\n \"date_of_birth\": \"\",\n \"date_of_birth_raw\": \"\",\n \"date_of_incorporation\": \"\",\n \"identification_numbers\": {},\n \"source_list\": \"\",\n \"program\": \"\",\n \"program_detail\": \"\",\n \"listing_date\": \"\",\n \"delisting_date\": \"\",\n \"is_active\": \"\",\n \"notice_url\": \"\",\n \"match_score\": \"\",\n \"matched_name\": \"\",\n \"matched_on\": \"alias\"\n },\n {\n \"id\": \"\",\n \"entity_name\": \"\",\n \"entity_type\": \"vessel\",\n \"aliases\": [\n \"\",\n \"\"\n ],\n \"country\": \"\",\n \"nationality\": \"\",\n \"date_of_birth\": \"\",\n \"date_of_birth_raw\": \"\",\n \"date_of_incorporation\": \"\",\n \"identification_numbers\": {},\n \"source_list\": \"\",\n \"program\": \"\",\n \"program_detail\": \"\",\n \"listing_date\": \"\",\n \"delisting_date\": \"\",\n \"is_active\": \"\",\n \"notice_url\": \"\",\n \"match_score\": \"\",\n \"matched_name\": \"\",\n \"matched_on\": \"name\"\n }\n ],\n \"hit_count\": \"\",\n \"distinct_entities\": \"\",\n \"best_match_score\": \"\"\n },\n {\n \"index\": \"\",\n \"input\": {\n \"key_0\": 3871.5956400760256,\n \"key_1\": true\n },\n \"error\": \"\",\n \"status\": \"error\",\n \"hits\": [\n {\n \"id\": \"\",\n \"entity_name\": \"\",\n \"entity_type\": \"company\",\n \"aliases\": [\n \"\",\n \"\"\n ],\n \"country\": \"\",\n \"nationality\": \"\",\n \"date_of_birth\": \"\",\n \"date_of_birth_raw\": \"\",\n \"date_of_incorporation\": \"\",\n \"identification_numbers\": {},\n \"source_list\": \"\",\n \"program\": \"\",\n \"program_detail\": \"\",\n \"listing_date\": \"\",\n \"delisting_date\": \"\",\n \"is_active\": \"\",\n \"notice_url\": \"\",\n \"match_score\": \"\",\n \"matched_name\": \"\",\n \"matched_on\": \"name\"\n },\n {\n \"id\": \"\",\n \"entity_name\": \"\",\n \"entity_type\": \"aircraft\",\n \"aliases\": [\n \"\",\n \"\"\n ],\n \"country\": \"\",\n \"nationality\": \"\",\n \"date_of_birth\": \"\",\n \"date_of_birth_raw\": \"\",\n \"date_of_incorporation\": \"\",\n \"identification_numbers\": {},\n \"source_list\": \"\",\n \"program\": \"\",\n \"program_detail\": \"\",\n \"listing_date\": \"\",\n \"delisting_date\": \"\",\n \"is_active\": \"\",\n \"notice_url\": \"\",\n \"match_score\": \"\",\n \"matched_name\": \"\",\n \"matched_on\": \"alias\"\n }\n ],\n \"hit_count\": \"\",\n \"distinct_entities\": \"\",\n \"best_match_score\": \"\"\n }\n ],\n \"meta\": {\n \"items\": \"\",\n \"errors\": \"\",\n \"query_ms\": \"\",\n \"note\": \"\",\n \"rate_limit\": {\n \"key_0\": 2050\n },\n \"matches\": \"\",\n \"clear\": \"\",\n \"threshold\": \"\",\n \"grouping\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "entity", "description": "", "item": [ { "name": "{id}", "description": "", "item": [ { "id": "83ff097d-698d-4c4a-a2d2-31fa8e749a97", "name": "Get sanctions entity detail", "request": { "name": "Get sanctions entity detail", "description": { "content": "Fetch a single sanctioned entity by numeric ID. Returns full entity record including aliases, addresses, and source-list references.", "type": "text/plain" }, "url": { "path": [ "sanctions", "entity", ":id" ], "host": [ "{{base_url}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Numeric internal ID", "type": "text/plain" } } ], "raw": "{{base_url}}/sanctions/entity/:id" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "f24ddf8c-c2e3-4f23-a9b7-6344d9b51e8f", "name": "Sanctions entity detail", "originalRequest": { "url": { "path": [ "sanctions", "entity", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Numeric internal ID", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"entity_name\": \"\",\n \"entity_type\": \"unknown\",\n \"aliases\": [\n \"\",\n \"\"\n ],\n \"country\": \"\",\n \"nationality\": \"\",\n \"date_of_birth\": \"\",\n \"date_of_birth_raw\": \"\",\n \"date_of_incorporation\": \"\",\n \"identification_numbers\": {},\n \"source_list\": \"\",\n \"program\": \"\",\n \"program_detail\": \"\",\n \"listing_date\": \"\",\n \"delisting_date\": \"\",\n \"is_active\": \"\",\n \"notice_url\": \"\",\n \"source_id\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "watchlist", "description": "", "item": [ { "name": "{id}", "description": "", "item": [ { "id": "7b2f67e7-3774-4fcd-a82a-818d70504489", "name": "Remove a watchlist entry", "request": { "name": "Remove a watchlist entry", "description": { "content": "Requires the sanctions_watch scope. Deletes one of your own entries; 404 when the id is not yours.", "type": "text/plain" }, "url": { "path": [ "sanctions", "watchlist", ":id" ], "host": [ "{{base_url}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ], "raw": "{{base_url}}/sanctions/watchlist/:id" }, "method": "DELETE", "body": {}, "header": [ { "key": "Accept", "value": "application/json" } ] }, "response": [ { "id": "ff2ebacb-5e0d-4464-9962-11e2b82dbf87", "name": "Deleted", "originalRequest": { "url": { "path": [ "sanctions", "watchlist", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "id": "7f2ab027-d42e-46a3-8c5f-4a56d3b8b382", "name": "Add a name to your sanctions watchlist", "request": { "name": "Add a name to your sanctions watchlist", "description": { "content": "Requires the sanctions_watch scope (Starter and above). Body: `name` (2-200 chars, required), `entity_type` (person, company, vessel or aircraft, optional), `webhook_url` (https, optional: called when a new hit appears). Entry cap varies by tier.", "type": "text/plain" }, "url": { "path": [ "sanctions", "watchlist" ], "host": [ "{{base_url}}" ], "query": [], "variable": [], "raw": "{{base_url}}/sanctions/watchlist" }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"entity_type\": \"company\",\n \"webhook_url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "response": [ { "id": "c3298066-8d31-4116-9814-85c884453221", "name": "The created entry", "originalRequest": { "url": { "path": [ "sanctions", "watchlist" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"entity_type\": \"company\",\n \"webhook_url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3b77352a-b4bf-4e8f-9682-5662ac862fb7", "name": "Your sanctions watchlists and recent hits", "request": { "name": "Your sanctions watchlists and recent hits", "description": { "content": "Requires the sanctions_watch scope. Entry cap varies by tier.", "type": "text/plain" }, "url": { "path": [ "sanctions", "watchlist" ], "host": [ "{{base_url}}" ], "query": [], "variable": [], "raw": "{{base_url}}/sanctions/watchlist" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "858f91db-9bde-4e31-bf4f-7b1b4acf4df4", "name": "OK", "originalRequest": { "url": { "path": [ "sanctions", "watchlist" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "changes", "description": "", "item": [ { "id": "99c422bc-8def-486b-ab3a-615f1d5c03e1", "name": "Sanctions list change feed", "request": { "name": "Sanctions list change feed", "description": { "content": "Additions, removals and amendments detected on each refresh. A `change_type` of `bulk` is a single row per list summarising a held-back mass change (no entity, never a watchlist hit); see the `change_type` parameter.", "type": "text/plain" }, "url": { "path": [ "sanctions", "changes" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "ISO date; only changes detected after it.", "type": "text/plain" }, "key": "since", "value": "" }, { "disabled": false, "description": { "content": "Kind of change. `listed`: a new designation. `delisted`: removed from the list. `relisted`: back on the list. `renamed`: the name changed. `bulk`: one event summarising a mass change of a whole list (more entries moved at once than a normal refresh) that is held back for review instead of being logged entry by entry: it has no entity (`entity_id` null), its `entity_name` reads \" entries of \", `details` carries the counts, and it is never a watchlist hit. (This can only be one of listed,delisted,relisted,renamed,bulk)", "type": "text/plain" }, "key": "change_type", "value": "bulk" }, { "disabled": false, "description": { "content": "Comma-separated source lists, e.g. EU,OFAC.", "type": "text/plain" }, "key": "list", "value": "" }, { "disabled": false, "description": { "content": "Integer from 1 to 500, default 100. Outside the range is a 400 validation_error.", "type": "text/plain" }, "key": "limit", "value": "100" } ], "variable": [], "raw": "{{base_url}}/sanctions/changes?since=&change_type=bulk&list=&limit=100" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "fb162e9f-b679-49ac-a435-97d9ca8c0cf4", "name": "OK", "originalRequest": { "url": { "path": [ "sanctions", "changes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ISO date; only changes detected after it.", "type": "text/plain" }, "key": "since", "value": "" }, { "disabled": false, "description": { "content": "Kind of change. `listed`: a new designation. `delisted`: removed from the list. `relisted`: back on the list. `renamed`: the name changed. `bulk`: one event summarising a mass change of a whole list (more entries moved at once than a normal refresh) that is held back for review instead of being logged entry by entry: it has no entity (`entity_id` null), its `entity_name` reads \" entries of \", `details` carries the counts, and it is never a watchlist hit. (This can only be one of listed,delisted,relisted,renamed,bulk)", "type": "text/plain" }, "key": "change_type", "value": "bulk" }, { "disabled": false, "description": { "content": "Comma-separated source lists, e.g. EU,OFAC.", "type": "text/plain" }, "key": "list", "value": "" }, { "disabled": false, "description": { "content": "Integer from 1 to 500, default 100. Outside the range is a 400 validation_error.", "type": "text/plain" }, "key": "limit", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"change_type\": \"delisted\",\n \"entity_id\": \"\",\n \"source_list\": \"\",\n \"source_id\": \"\",\n \"entity_name\": \"\",\n \"entity_type\": \"person\",\n \"country\": \"\",\n \"program\": \"\",\n \"details\": {\n \"key_0\": 1940,\n \"key_1\": 3413,\n \"key_2\": true,\n \"key_3\": false\n },\n \"detected_at\": \"\"\n },\n {\n \"id\": \"\",\n \"change_type\": \"listed\",\n \"entity_id\": \"\",\n \"source_list\": \"\",\n \"source_id\": \"\",\n \"entity_name\": \"\",\n \"entity_type\": \"unknown\",\n \"country\": \"\",\n \"program\": \"\",\n \"details\": {\n \"key_0\": 5618.396641399439\n },\n \"detected_at\": \"\"\n }\n ],\n \"meta\": {\n \"since\": \"\",\n \"result_count\": \"\",\n \"rate_limit\": {\n \"rpm_remaining\": \"\",\n \"daily_remaining\": \"\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "directors", "description": "", "item": [ { "name": "network", "description": "", "item": [ { "id": "f04a8d26-af8b-44c2-a5f0-960d38106e8c", "name": "Director network graph", "request": { "name": "Director network graph", "description": { "content": "Find people who direct multiple companies. Useful for fraud detection (cross-corporate concentration) and watchlist construction.", "type": "text/plain" }, "url": { "path": [ "directors", "network" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "Minimum number of distinct companies a person must direct to be included (2 to 100; outside the range is a 400 validation_error)", "type": "text/plain" }, "key": "min_companies", "value": "5" }, { "disabled": false, "description": { "content": "If true, includes legal-entity directors (not just natural persons)", "type": "text/plain" }, "key": "legal_entities", "value": "false" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Result offset, 0 to 1,000,000; outside the range is a 400 validation_error.", "type": "text/plain" }, "key": "offset", "value": "0" } ], "variable": [], "raw": "{{base_url}}/directors/network?country=ES&min_companies=5&legal_entities=false&limit=50&offset=0" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "bdd1d475-1020-4f0f-8757-3e2a44d49a09", "name": "Director network results", "originalRequest": { "url": { "path": [ "directors", "network" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Country scope. If omitted, defaults to the first country in the API key's allowlist. Ireland (IE) is company-level (no directors/UBO yet); Poland (PL) adds officers on the company record (`appointments`: management board, supervisory board, audit committee, proxies and attorneys from the KRS full extract, current first; natural persons are masked by the register itself, with `name_masked` true, no person id and no /people record; dated by the register entry, not the resolution; filled progressively over the weeks after launch; `representation` carries the current representation rule in the register's Polish words; no UBO yet); both have 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, and gazette events from the SHAB commercial-register publications from 1 January 2024 (dated by the publication date, linked by UID; no notice text and no names of board members or signatories; a summary derived from the SOGC publications, the linked publication is the authoritative text); 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, Florida, Iowa, the District of Columbia and Texas (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, Pennsylvania and Iowa publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status), 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), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), 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. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). 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. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; 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; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. 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); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. 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 English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). 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; International Trade Administration, English names) 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 sixteen 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. Netherlands (NL) is company-level and partial: LEI-registered entities with a KVK number, from the Global Legal Entity Identifier Foundation (GLEIF) golden copy, and not the Dutch commercial register (Handelsregister, KVK); a company with no LEI is not served. The company number is the KVK number, exactly 8 digits (a leading zero is part of it), and `lei` is a second identifier. BV, NV, SE (Europese NV), cooperatives, SCE, onderlinge waarborgmaatschappijen, CV and VOF only; sole proprietorships (eenmanszaak) and every natural person, maatschappen and rederijen, foundations (stichting), associations, churches, public-law bodies, funds and branches are never served. No officers, share capital, activity code (no NACE, ISIC or NAICS class, no EU size class) or VAT number (a vat search is refused), no financial statements; register-change events (none before 30 Oct 2026) and monitoring are available. Updated daily. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). 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 sixteen 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). (This can only be one of ES,FR,GB,IE,PL,NO,FI,SE,HR,BE,DK,EE,SK,CH,LV,CY,RO,LT,CA,AU,JP,IL,BR,CO,SG,TW,CZ,DE,NL,US)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "Minimum number of distinct companies a person must direct to be included (2 to 100; outside the range is a 400 validation_error)", "type": "text/plain" }, "key": "min_companies", "value": "5" }, { "disabled": false, "description": { "content": "If true, includes legal-entity directors (not just natural persons)", "type": "text/plain" }, "key": "legal_entities", "value": "false" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Result offset, 0 to 1,000,000; outside the range is a 400 validation_error.", "type": "text/plain" }, "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"person_id\": \"\",\n \"person_name\": \"\",\n \"company_count\": \"\",\n \"is_legal_entity\": \"\",\n \"company_ids\": [\n \"\",\n \"\"\n ],\n \"company_names\": [\n \"\",\n \"\"\n ]\n },\n {\n \"person_id\": \"\",\n \"person_name\": \"\",\n \"company_count\": \"\",\n \"is_legal_entity\": \"\",\n \"company_ids\": [\n \"\",\n \"\"\n ],\n \"company_names\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"meta\": {\n \"query_ms\": \"\",\n \"search_mode\": \"\",\n \"country\": \"PL\",\n \"rate_limit\": {\n \"rpm_remaining\": \"\",\n \"daily_remaining\": \"\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "coverage", "description": "", "item": [ { "id": "8b54b55c-f723-4284-bae0-f51f256ed144", "name": "Dataset coverage statistics", "request": { "name": "Dataset coverage statistics", "description": { "content": "Returns dataset coverage statistics per country: total company count, event count, person count, appointment count, latest filing date, and data sources. Response is server-cached for ~1 hour.", "type": "text/plain" }, "url": { "path": [ "coverage" ], "host": [ "{{base_url}}" ], "query": [], "variable": [], "raw": "{{base_url}}/coverage" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "d594e198-7245-4538-a78a-1ed4fa2faac6", "name": "Coverage stats", "originalRequest": { "url": { "path": [ "coverage" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"countries\": [\n {\n \"code\": \"\",\n \"name\": \"\",\n \"total_companies\": \"\",\n \"total_events\": \"\",\n \"total_persons\": \"\",\n \"total_appointments\": \"\",\n \"total_contacts\": \"\",\n \"latest_filing\": \"\",\n \"earliest_filing\": \"\",\n \"sources\": [\n \"\",\n \"\"\n ],\n \"update_frequency\": \"\",\n \"data_as_of\": \"\",\n \"last_synced_at\": \"\"\n },\n {\n \"code\": \"\",\n \"name\": \"\",\n \"total_companies\": \"\",\n \"total_events\": \"\",\n \"total_persons\": \"\",\n \"total_appointments\": \"\",\n \"total_contacts\": \"\",\n \"latest_filing\": \"\",\n \"earliest_filing\": \"\",\n \"sources\": [\n \"\",\n \"\"\n ],\n \"update_frequency\": \"\",\n \"data_as_of\": \"\",\n \"last_synced_at\": \"\"\n }\n ],\n \"total_records\": \"\",\n \"last_updated\": \"\",\n \"risk_datasets\": {\n \"tax_debt\": {},\n \"corporate_insolvency\": {},\n \"pep\": {}\n }\n },\n \"meta\": {\n \"cached\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "account", "description": "", "item": [ { "id": "352a3448-a748-44a1-975c-0dc82200a37f", "name": "Account info and usage", "request": { "name": "Account info and usage", "description": { "content": "Returns the authenticated key's account details: tier, scopes, country allowlist, current rate-limit usage, and 30-day usage breakdown by endpoint.", "type": "text/plain" }, "url": { "path": [ "account" ], "host": [ "{{base_url}}" ], "query": [], "variable": [], "raw": "{{base_url}}/account" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "fef34d91-06fa-4150-86e7-9d5ec3d47081", "name": "Account info", "originalRequest": { "url": { "path": [ "account" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"account_name\": \"\",\n \"email\": \"\",\n \"tier\": \"free\",\n \"key_prefix\": \"\",\n \"scopes\": [\n \"\",\n \"\"\n ],\n \"countries\": [\n \"\",\n \"\"\n ],\n \"rate_limit\": {\n \"rpm\": \"\",\n \"daily\": \"\",\n \"rpm_used\": \"\",\n \"daily_used\": \"\",\n \"rpm_remaining\": \"\",\n \"daily_remaining\": \"\"\n },\n \"usage_30d\": {\n \"total_requests\": \"\",\n \"by_endpoint\": {\n \"key_0\": \"\"\n }\n },\n \"created_at\": \"\",\n \"expires_at\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "vat", "description": "", "item": [ { "name": "{vatNumber}", "description": "", "item": [ { "id": "5af4494d-010c-454d-b23a-c095b7c2b344", "name": "Validate an EU VAT number (VIES)", "request": { "name": "Validate an EU VAT number (VIES)", "description": { "content": "Validate an EU VAT number against VIES (the European Commission's VAT Information Exchange System) and return the registered trader name and address when valid. Covers the 27 EU member states plus XI (Northern Ireland); Greek numbers use the EL prefix, and GB VAT is out of scope post-Brexit. Live official lookup — when a member-state registry is temporarily down it returns 503 (retryable) rather than reporting the VAT as invalid. Costs 1 credit. When VIES says a Spanish or German number is valid but withholds the name, `registry_match` {company_id, company_name, address, register} names the company our register holds under that number: register data, not VIES confirmation.", "type": "text/plain" }, "url": { "path": [ "vat", ":vatNumber" ], "host": [ "{{base_url}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "vatNumber", "disabled": false, "description": { "content": "(Required) Full VAT number including the 2-letter country prefix, e.g. IE6388047V or DE811569869. Spaces and punctuation are ignored.", "type": "text/plain" } } ], "raw": "{{base_url}}/vat/:vatNumber" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "b48e20ca-4e3b-4885-a9c5-c152275d17c4", "name": "VAT validation result", "originalRequest": { "url": { "path": [ "vat", ":vatNumber" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Full VAT number including the 2-letter country prefix, e.g. IE6388047V or DE811569869. Spaces and punctuation are ignored.", "type": "text/plain" }, "type": "any", "value": "", "key": "vatNumber" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"vat_number\": \"\",\n \"country_code\": \"\",\n \"number\": \"\",\n \"is_valid\": \"\",\n \"name\": \"\",\n \"address\": \"\",\n \"request_date\": \"\",\n \"source\": \"\",\n \"registry_match\": {\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"address\": \"\",\n \"register\": \"\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "lei", "description": "", "item": [ { "name": "{lei}", "description": "", "item": [ { "id": "c76b0386-a1b8-4a25-8de9-b278a653191d", "name": "Look up a Legal Entity Identifier (GLEIF)", "request": { "name": "Look up a Legal Entity Identifier (GLEIF)", "description": { "content": "Look up a 20-character ISO 17442 LEI in the GLEIF global register. Returns the legal name, jurisdiction, entity and registration status, legal/HQ address, managing LOU, and next renewal date. Use to validate or enrich a counterparty that publishes an LEI. Costs 1 credit.", "type": "text/plain" }, "url": { "path": [ "lei", ":lei" ], "host": [ "{{base_url}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "lei", "disabled": false, "description": { "content": "(Required) 20-character alphanumeric LEI, e.g. HWUPKR0MPOU8FGXBT394.", "type": "text/plain" } } ], "raw": "{{base_url}}/lei/:lei" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "90be9cd6-7cfd-4395-b1fa-2b710f6438aa", "name": "LEI record", "originalRequest": { "url": { "path": [ "lei", ":lei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) 20-character alphanumeric LEI, e.g. HWUPKR0MPOU8FGXBT394.", "type": "text/plain" }, "type": "any", "value": "", "key": "lei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"lei\": \"\",\n \"legal_name\": \"\",\n \"legal_form_code\": \"\",\n \"jurisdiction\": \"\",\n \"entity_status\": \"\",\n \"entity_category\": \"\",\n \"legal_address\": {\n \"lines\": [\n \"\",\n \"\"\n ],\n \"city\": \"\",\n \"region\": \"\",\n \"country\": \"\",\n \"postal_code\": \"\"\n },\n \"headquarters_address\": {\n \"lines\": [\n \"\",\n \"\"\n ],\n \"city\": \"\",\n \"region\": \"\",\n \"country\": \"\",\n \"postal_code\": \"\"\n },\n \"registration_status\": \"\",\n \"initial_registration_date\": \"\",\n \"last_update_date\": \"\",\n \"next_renewal_date\": \"\",\n \"managing_lou\": \"\",\n \"bic\": [\n \"\",\n \"\"\n ],\n \"source\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "relationships", "description": "", "item": [ { "id": "364d4421-636d-4b20-bdac-8021635d3683", "name": "GLEIF Level 2 ownership (who owns whom)", "request": { "name": "GLEIF Level 2 ownership (who owns whom)", "description": { "content": "Return the GLEIF Level 2 relationship graph for a 20-character LEI: its direct parent, ultimate parent, and direct children (up to 15), each with LEI, legal name, jurisdiction, status, and city/country. Reveals the accountable corporate-ownership chain behind an entity. Only relationships the entity has reported to GLEIF are returned (many report none). Costs 1 credit.", "type": "text/plain" }, "url": { "path": [ "lei", ":lei", "relationships" ], "host": [ "{{base_url}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "lei", "disabled": false, "description": { "content": "(Required) 20-character alphanumeric LEI, e.g. 5493001KJTIIGC8Y1R12.", "type": "text/plain" } } ], "raw": "{{base_url}}/lei/:lei/relationships" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "622eb7fe-9239-4db0-a936-c0b520d227d8", "name": "LEI relationship graph (direct parent, ultimate parent, direct children)", "originalRequest": { "url": { "path": [ "lei", ":lei", "relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) 20-character alphanumeric LEI, e.g. 5493001KJTIIGC8Y1R12.", "type": "text/plain" }, "type": "any", "value": "", "key": "lei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "search", "description": "", "item": [ { "id": "c7ca86e7-2185-4df1-a566-4f1eb68c6c21", "name": "Search the GLEIF LEI register by name", "request": { "name": "Search the GLEIF LEI register by name", "description": { "content": "Full-text search the GLEIF global LEI register by legal-entity name. Returns candidate LEIs with legal name, jurisdiction, status, and city/country — use to resolve a company name to its LEI before /lei/{lei}. Costs 1 credit. Records are ranked by `match_score` (0-100, as on company search: exact name, then leading words, then whole words, then parts of words; ties keep GLEIF's order), from the first 100 records GLEIF returns, so name=telefonica lists TELEFONICA SA first; a hit scoring under 22 (parts of words, trigram similarity under 0.45) is dropped, so name=siemens no longer lists an unrelated foundation, and a page can hold fewer than `limit` records.", "type": "text/plain" }, "url": { "path": [ "lei", "search" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Legal entity name to search for (min 2 characters).", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "Maximum candidates to return (1–25, default 10).", "type": "text/plain" }, "key": "limit", "value": "10" } ], "variable": [], "raw": "{{base_url}}/lei/search?name=&limit=10" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "91ad5961-1f77-4984-8acb-dc413da6dad5", "name": "Candidate LEI records", "originalRequest": { "url": { "path": [ "lei", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Legal entity name to search for (min 2 characters).", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "Maximum candidates to return (1–25, default 10).", "type": "text/plain" }, "key": "limit", "value": "10" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"lei\": \"\",\n \"legal_name\": \"\",\n \"jurisdiction\": \"\",\n \"entity_status\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"match_score\": \"\"\n },\n {\n \"lei\": \"\",\n \"legal_name\": \"\",\n \"jurisdiction\": \"\",\n \"entity_status\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"match_score\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "monitor", "description": "", "item": [ { "id": "4b081194-bab8-444e-b762-64190f606179", "name": "List monitored companies", "request": { "name": "List monitored companies", "description": { "content": "Returns the key's active company subscriptions plus the 50 most recent alerts. Monitored-company caps are per account and scale with the plan (free trial 3, Starter 25, Professional 250, Scale 2,500).", "type": "text/plain" }, "url": { "path": [ "monitor" ], "host": [ "{{base_url}}" ], "query": [], "variable": [], "raw": "{{base_url}}/monitor" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "ce529847-4719-4cc7-ab80-998271412aac", "name": "Monitors + recent alerts", "originalRequest": { "url": { "path": [ "monitor" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ecbf3d61-81a1-464f-b2a8-ab7309658e5a", "name": "Subscribe a company to monitoring", "request": { "name": "Subscribe a company to monitoring", "description": { "content": "Subscribe a company (by numeric company_id from /companies/search) to ongoing monitoring. Alerts fire on new corporate events, status changes, dissolution, and new sanctions matches. If webhook_url is set, alerts POST to it (HMAC-SHA256 signed via X-Prometiam-Signature using the returned webhook_secret) and appear in GET /monitor. A dissolution alert fires when the company gets a dissolution date or, where the register gives none (Canada, Israel, Singapore, Taiwan, Romania, many US registrations), when its status becomes closed; the latter is dated by the check that first sees the closure and carries `detail.date_basis` = `first_seen_closed` (`register` when the register's date is used). Available for ES, GB, IE, PL, NO, FI, SE, BE, HR, DK, EE, SK, CH, LV, CY, RO, LT, CA, AU, JP, IL, SG, CO, TW, BR, CZ, DE, NL, UA, RS, EC and US (every live country except FR and CL) — ES has the full corporate-event stream; GB alerts on status, dissolution, sanctions and corporate events (Companies House filings and Gazette notices); IE/PL/NO alert on register-change events (none before 14 Oct 2026) as well as status, dissolution and sanctions; FI/SE/BE/HR/DK/EE/SK/CH/LV/CY/RO/LT/CA/AU/JP/IL/SG/CO/TW/BR/CZ/DE/NL/UA/RS/EC/US alert on register-change events (dated when first seen in the register data (for the United States, the weekly read of the registers that first sees it)) as well as status, dissolution and sanctions.", "type": "text/plain" }, "url": { "path": [ "monitor" ], "host": [ "{{base_url}}" ], "query": [], "variable": [], "raw": "{{base_url}}/monitor" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"country\": \"ES\",\n \"webhook_url\": \"\",\n \"label\": \"\",\n \"events\": [\n \"status_change\",\n \"sanctions_match\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "response": [ { "id": "9fe415d3-a543-471e-ad27-a55e76daa330", "name": "Monitor created (webhook_secret shown once)", "originalRequest": { "url": { "path": [ "monitor" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"country\": \"ES\",\n \"webhook_url\": \"\",\n \"label\": \"\",\n \"events\": [\n \"status_change\",\n \"sanctions_match\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{id}", "description": "", "item": [ { "id": "095a117a-549a-44d2-b264-ee031ebcfca2", "name": "Get a monitor + alert history", "request": { "name": "Get a monitor + alert history", "description": { "content": "Returns one subscription with the company's current `status` (standard) and `local_status` (the register's own) and up to 100 recent alerts.", "type": "text/plain" }, "url": { "path": [ "monitor", ":id" ], "host": [ "{{base_url}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Monitor id (from POST /monitor or GET /monitor).", "type": "text/plain" } } ], "raw": "{{base_url}}/monitor/:id" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "84693502-ac91-4e71-aea0-4027c812a3c7", "name": "Monitor detail", "originalRequest": { "url": { "path": [ "monitor", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Monitor id (from POST /monitor or GET /monitor).", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "be527f4a-db94-4d0e-a1ed-624a15cf024a", "name": "Stop monitoring a company", "request": { "name": "Stop monitoring a company", "description": { "content": "Deactivates the subscription (alert history is preserved).", "type": "text/plain" }, "url": { "path": [ "monitor", ":id" ], "host": [ "{{base_url}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Monitor id (from POST /monitor or GET /monitor).", "type": "text/plain" } } ], "raw": "{{base_url}}/monitor/:id" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "response": [ { "id": "c174c39c-8b1e-4505-92d2-788e275e94ed", "name": "Deleted", "originalRequest": { "url": { "path": [ "monitor", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Monitor id (from POST /monitor or GET /monitor).", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "insolvency", "description": "", "item": [ { "name": "search", "description": "", "item": [ { "id": "7159d934-a5fd-4b95-83ec-deda79171510", "name": "Search cross-border CORPORATE insolvency notices", "request": { "name": "Search cross-border CORPORATE insolvency notices", "description": { "content": "Corporate insolvency notices from official gazettes and registers across FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV, EE and SG.\n\n**Corporate only.** Personal/consumer insolvency is deliberately excluded and is never returned.\n\n**Company-linked for FR/GB/NO and, by identifier, FI (business ID), DK (CVR number), HR (MBS), SE (organisationsnummer), CH (UID), LV (registration number), EE (registry code), ES (NIF) and SG (UEN).** `GET /companies/{id}?include=insolvency` on a Finnish, Danish, Croatian, Swedish, Swiss, Latvian, Estonian or Singapore company returns them; a Swiss notice is linked only where the SHAB notice names the debtor's UID, and one without a UID stays unlinked. DE, AT, US and NL notices are not linked to company records (German and US company records come from other sources and do not carry them). They stand alone, which is also why they are worth having: distress coverage in markets not otherwise available.\n\n**Denmark, Croatia and Sweden.** DK notices come from CVR credit information (konkurs and tvangsakkord): one notice per proceeding, dated by the decision that opened it, with the latest stage of the proceeding, with no court or case number. HR notices are court decisions from the Croatian court register (bankruptcy, shortened bankruptcy, pre-bankruptcy proceedings), with the court and case number where the register states them; only companies still on the register are covered. SE notices are Bolagsverket's procedure data (konkurs, företagsrekonstruktion, ackordsförhandling), updated weekly, with no court, case number or source link; proceedings that ended before collection are not included. Belgium is not an insolvency market: its bankruptcy shows in the company status and in its register-change events.\n\n**Spain, Latvia and Estonia.** ES notices are the concurso entries (declaration, opening of the liquidation phase, conclusion) the Registro Mercantil publishes in BORME since 2009, one per court resolution, linked by NIF and dated by the court's resolution date with the BORME publication date alongside (a median of about ten weeks later, sometimes more than a year); legal entities with a NIF only, judge and administrator never served, requests for a declaration and other resolutions are not notices, and an entry that cannot be tied to the company, or whose NIF is an administrator's, is withheld. LV notices are the Insolvency Register's insolvency and legal protection proceedings, an opening and a closing notice each, since 2008, with court and case number where stated, linked by registration number; legal persons of the commercial register only, a dismissed application is not served, no administrators, updated daily. EE notices are bankruptcy declarations from the e-Business Register, one per register entry, dated by the entry (a few days after the court's order), linked by registry code, with no court, case number, trustee or closing notice; companies still on the register, in liquidation or in bankruptcy only (a company deleted from the register leaves the source, so the count is a floor); sole traders never served. `GET /companies/{id}?include=insolvency` on a Latvian or Estonian company returns them.\n\n**Singapore.** SG notices are the corporate notices of the Singapore Government Gazette (egazette.gov.sg), back to September 1998: winding-up applications and orders, judicial management, and the steps of a creditors' voluntary or court-ordered liquidation (resolutions, meetings of creditors, claims and dividend notices), dated by the order, filing or resolution date where the notice prints it, else by its first publication, with the court and case number where it prints them. Members' voluntary (solvent) liquidations are not included, and no liquidator, judicial manager or other natural person is served. Notices are linked to the company record by the UEN (`GET /companies/{id}?include=insolvency` on a Singapore company returns them); a notice that prints no valid UEN stays unlinked. `notice_url` is a plain link to the notice in the Gazette.\n\nContains CVR data (Erhvervsstyrelsen), CC BY 4.0. Contains data from the Insolvency Register of the Republic of Latvia (Register of Enterprises), CC0. Contains data from the Estonian e-Business Register (RIK), CC BY 4.0. Spanish notices: based on data from the Agencia Estatal Boletín Oficial del Estado (BORME). Singapore notices: Source: Republic of Singapore Government Gazette, www.egazette.gov.sg. The e-Gazettes are subject to copyright of the Singapore Government and are reproduced here with the permission of the Singapore Government. You may check www.egazette.gov.sg for the latest e-Gazettes.\n\nName matching is a CONTAINS match on the normalised company name (trigram-indexed; minimum 2 characters).\n\nEach notice carries `status` (standard: insolvency-proceedings, liquidation, winding-up, restructuring, administration, receivership, forced-sale, concluded) and `local_status`, the original wording of the source (for example \"Konkurs: Dekret\").\n\n**Name search floor.** A hit whose `match_score` is under 22 (only parts of words match, trigram similarity under 0.45) is not returned: a search for \"Air Berlin\" no longer lists \"Panorama Fashion Fair Berlin\".", "type": "text/plain" }, "url": { "path": [ "insolvency", "search" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "Company name — matched anywhere in the normalised name. Best matches come first among the 300 most recent matching notices and every exact name match; the older matches follow by filing date, so every match is reachable by paging.", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "Registry number of the debtor, read in the register's own form (spaces and dots ignored; a SIRET gives its SIREN; a compact Y-tunnus or organisationsnummer, a short Companies House number a Croatian OIB, a Spanish NIF, an 11-digit Latvian registration number and an 8-digit Estonian registry code are accepted). For Germany an HRA/HRB number is only unique within its register court (`HRB12653` is held by five companies), so notices carry the number with the court, `HRB12653/FRANKFURT-AM-MAIN` (court city upper case, ä/ö/ü as AE/OE/UE, ß as SS, other runs of punctuation one hyphen); where the court is not known the bare number stays. Send `HRB 12653 Frankfurt am Main`, `Frankfurt am Main HRB 12653`, `Amtsgericht Frankfurt am Main, HRB 12653` or `HRB12653/FRANKFURT-AM-MAIN` to select one court; `HRB 12653` alone matches every court, and `meta.register_courts` and `meta.notice` then list them. Without `country` the number is read by its shape: a shape that fits one register selects it; one that fits several (9 digits: FR SIREN, NO organisation number or HR MBS; 8 digits: GB, DK, NL or FI) returns rows from each, labelled by source_country, and lists them in meta.number_countries.", "type": "text/plain" }, "key": "company_number", "value": "" }, { "disabled": false, "description": { "content": "Insolvency-coverage country. NOT the same set as the company-registry countries. (This can only be one of FR,DE,GB,AT,CH,NO,FI,US,NL,DK,HR,SE,ES,LV,EE)", "type": "text/plain" }, "key": "country", "value": "FR" }, { "disabled": false, "description": { "content": "e.g. insolvency, liquidation, winding_up, administration, receivership, restructuring, forced_sale. Corporate insolvency only: dissolutions and strike-offs are not insolvency and are not returned. A court-ordered liquidation (a UK winding-up order, a creditors' voluntary liquidation) is insolvency; liquidation is a voluntary or unclassified one; winding_up is a closing event (since 22 Oct 2026).", "type": "text/plain" }, "key": "event_type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "date_from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "date_to", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Keyset cursor from pagination.next_cursor", "type": "text/plain" }, "key": "cursor", "value": "" } ], "variable": [], "raw": "{{base_url}}/insolvency/search?name=&company_number=&country=FR&event_type=&date_from=&date_to=&limit=20&cursor=" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "response": [ { "id": "15791950-1393-4d3c-b1d4-25e3242dc031", "name": "Matching corporate insolvency notices", "originalRequest": { "url": { "path": [ "insolvency", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Company name — matched anywhere in the normalised name. Best matches come first among the 300 most recent matching notices and every exact name match; the older matches follow by filing date, so every match is reachable by paging.", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "Registry number of the debtor, read in the register's own form (spaces and dots ignored; a SIRET gives its SIREN; a compact Y-tunnus or organisationsnummer, a short Companies House number a Croatian OIB, a Spanish NIF, an 11-digit Latvian registration number and an 8-digit Estonian registry code are accepted). For Germany an HRA/HRB number is only unique within its register court (`HRB12653` is held by five companies), so notices carry the number with the court, `HRB12653/FRANKFURT-AM-MAIN` (court city upper case, ä/ö/ü as AE/OE/UE, ß as SS, other runs of punctuation one hyphen); where the court is not known the bare number stays. Send `HRB 12653 Frankfurt am Main`, `Frankfurt am Main HRB 12653`, `Amtsgericht Frankfurt am Main, HRB 12653` or `HRB12653/FRANKFURT-AM-MAIN` to select one court; `HRB 12653` alone matches every court, and `meta.register_courts` and `meta.notice` then list them. Without `country` the number is read by its shape: a shape that fits one register selects it; one that fits several (9 digits: FR SIREN, NO organisation number or HR MBS; 8 digits: GB, DK, NL or FI) returns rows from each, labelled by source_country, and lists them in meta.number_countries.", "type": "text/plain" }, "key": "company_number", "value": "" }, { "disabled": false, "description": { "content": "Insolvency-coverage country. NOT the same set as the company-registry countries. (This can only be one of FR,DE,GB,AT,CH,NO,FI,US,NL,DK,HR,SE,ES,LV,EE)", "type": "text/plain" }, "key": "country", "value": "FR" }, { "disabled": false, "description": { "content": "e.g. insolvency, liquidation, winding_up, administration, receivership, restructuring, forced_sale. Corporate insolvency only: dissolutions and strike-offs are not insolvency and are not returned. A court-ordered liquidation (a UK winding-up order, a creditors' voluntary liquidation) is insolvency; liquidation is a voluntary or unclassified one; winding_up is a closing event (since 22 Oct 2026).", "type": "text/plain" }, "key": "event_type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "date_from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "date_to", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Keyset cursor from pagination.next_cursor", "type": "text/plain" }, "key": "cursor", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"source_country\": \"AT\",\n \"source_provider\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"event_type\": \"\",\n \"status\": \"\",\n \"local_status\": \"\",\n \"filing_date\": \"\",\n \"bankrupt_city\": \"\",\n \"notice_url\": \"\",\n \"match_score\": \"\",\n \"court\": \"\",\n \"case_number\": \"\",\n \"notice_text\": \"\"\n },\n {\n \"id\": \"\",\n \"source_country\": \"US\",\n \"source_provider\": \"\",\n \"company_name\": \"\",\n \"company_number\": \"\",\n \"event_type\": \"\",\n \"status\": \"\",\n \"local_status\": \"\",\n \"filing_date\": \"\",\n \"bankrupt_city\": \"\",\n \"notice_url\": \"\",\n \"match_score\": \"\",\n \"court\": \"\",\n \"case_number\": \"\",\n \"notice_text\": \"\"\n }\n ],\n \"pagination\": {\n \"count\": \"\",\n \"has_more\": \"\",\n \"next_cursor\": \"\"\n },\n \"meta\": {\n \"query_ms\": \"\",\n \"countries\": [\n \"\",\n \"\"\n ],\n \"coverage_note\": \"\",\n \"name_match\": \"\",\n \"key_0\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "check", "description": "", "item": [ { "id": "78e5e6fc-fbf1-4e69-a83b-5c8a73dfbccf", "name": "Check up to 100 counterparties for corporate insolvency notices", "request": { "name": "Check up to 100 counterparties for corporate insolvency notices", "description": { "content": "Batch form of `GET /insolvency/search`: for each item returns up to 5 matching notices (newest first) and the latest filing date. Corporate insolvency only, sixteen markets (FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV, EE, SG). Every item costs 2 credits against the plan's per-minute, daily and monthly limits; a batch that does not fit is refused up front with 429 `batch_exceeds_quota` and `max_items_now`. Supports an optional `Idempotency-Key` header (see the parameter) for safe replay of the whole batch.", "type": "text/plain" }, "url": { "path": [ "insolvency", "check" ], "host": [ "{{base_url}}" ], "query": [], "variable": [], "raw": "{{base_url}}/insolvency/check" }, "header": [ { "disabled": false, "description": { "content": "Optional, per draft-ietf-httpapi-idempotency-key-header. 1-255 printable ASCII characters, else 400 `validation_error`. Scoped to the API key. A replay of the same key with the same request (method + path + a canonical, sorted-key hash of the body) within 24 hours returns the original 2xx response with `Idempotent-Replayed: true` and writes no new usage row (it costs no credits). The same key with a different body is 422 `idempotency_key_reuse`. A replay while the first attempt is still running is 409 `idempotency_key_in_progress` with `Retry-After`. Only 2xx results are stored — a 4xx/5xx (or an internal timeout) releases the key so the client can retry; a 2xx body over ~200 KB also releases the key (nothing is stored) rather than fail the request. Omitting the header changes nothing about the request.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"country\": \"AT\",\n \"company_number\": \"\",\n \"siren\": \"\",\n \"name\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "response": [ { "id": "3409a334-6b28-4e49-b0f9-d3e145f605eb", "name": "Results in request order", "originalRequest": { "url": { "path": [ "insolvency", "check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Optional, per draft-ietf-httpapi-idempotency-key-header. 1-255 printable ASCII characters, else 400 `validation_error`. Scoped to the API key. A replay of the same key with the same request (method + path + a canonical, sorted-key hash of the body) within 24 hours returns the original 2xx response with `Idempotent-Replayed: true` and writes no new usage row (it costs no credits). The same key with a different body is 422 `idempotency_key_reuse`. A replay while the first attempt is still running is 409 `idempotency_key_in_progress` with `Retry-After`. Only 2xx results are stored — a 4xx/5xx (or an internal timeout) releases the key so the client can retry; a 2xx body over ~200 KB also releases the key (nothing is stored) rather than fail the request. Omitting the header changes nothing about the request.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"country\": \"AT\",\n \"company_number\": \"\",\n \"siren\": \"\",\n \"name\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replayed", "value": "" } ], "body": "{\n \"data\": [\n {\n \"index\": \"\",\n \"input\": {\n \"key_0\": true,\n \"key_1\": true\n },\n \"error\": \"\",\n \"status\": \"timeout\",\n \"notices\": [\n {\n \"key_0\": 4300,\n \"key_1\": 6915\n },\n {\n \"key_0\": 3235,\n \"key_1\": 2121.254623080575\n }\n ],\n \"latest_filing_date\": \"\"\n },\n {\n \"index\": \"\",\n \"input\": {\n \"key_0\": 3621\n },\n \"error\": \"\",\n \"status\": \"none\",\n \"notices\": [\n {\n \"key_0\": 2701.3969599380725,\n \"key_1\": false,\n \"key_2\": false\n },\n {\n \"key_0\": \"string\",\n \"key_1\": 7401,\n \"key_2\": \"string\",\n \"key_3\": true,\n \"key_4\": \"string\"\n }\n ],\n \"latest_filing_date\": \"\"\n }\n ],\n \"meta\": {\n \"items\": \"\",\n \"errors\": \"\",\n \"query_ms\": \"\",\n \"note\": \"\",\n \"rate_limit\": {\n \"key_0\": true,\n \"key_1\": false,\n \"key_2\": true,\n \"key_3\": true\n },\n \"found\": \"\",\n \"none\": \"\",\n \"countries\": [\n \"\",\n \"\"\n ]\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "procurement", "description": "", "item": [ { "name": "buyer", "description": "", "item": [ { "name": "{id}", "description": "", "item": [ { "id": "8610bee8-0231-45fa-abe1-458df9448f1e", "name": "Public-buyer risk profile (beta, ES + FR)", "request": { "name": "Public-buyer risk profile (beta, ES + FR)", "description": { "content": "The risk profile of a contracting body: two calibrated scores about the BUYER, its behaviour ratios, the awards a reviewer would open first and its five largest supplier relationships. **Never a score for a supplier or a tender.** `competition` = probability that the buyer's next award receives a single bid, against what comparable tenders attract; `counterparty` = probability that a supplier it awards to enters insolvency within 24 months (a weak signal: about twice the base rate at the top). Risk block per model: `score` (1-10, ladder on the log-odds of `probability`; 1 = 1st percentile of the country's scored buyers, 10 = 99th, anchors frozen), `probability` (the buyer's calibrated rate for the outcome on its next award: observed count shrunk toward the model expectation with a 30-award prior, calibrated out of time), `base_rate`, `relative_risk` (= probability / base_rate), `log_odds`, `percentile` (of the residual observed minus expected, the peer comparison), `observed_rate`, `expected_rate`, `excess`, `awards_scored`, `confidence` (high/medium/low by awards scored). A body is scored once it has at least 20 awards in the period. Beta; Spain and France; a score is a prompt to look, not a finding of wrongdoing.", "type": "text/plain" }, "url": { "path": [ "procurement", "buyer", ":id" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of ES,FR)", "type": "text/plain" }, "key": "country", "value": "ES" } ], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) National identifier of the contracting body: DIR3 code or NIF (Spain), SIRET (France). Find it with /procurement/buyers?name=.", "type": "text/plain" } } ], "raw": "{{base_url}}/procurement/buyer/:id?country=ES" }, "method": "GET", "body": {}, "header": [ { "key": "Accept", "value": "application/json" } ] }, "response": [ { "id": "d3c701ec-3d65-4bf7-87e6-e43d22629228", "name": "buyer, as_of, coverage (awards, contracts, distinct_suppliers, first/last award, awarded_value_eur, framework_ceilings_eur), risk {competition, counterparty}, behaviour (single_bid_rate, direct_award_rate, framework_rate, modification_rate, bids_disclosed_rate, top_supplier_value_share, supplier_hhi, average_bids), evidence[] (up to three awards), top_suppliers[] (five pairs), limits[]", "originalRequest": { "url": { "path": [ "procurement", "buyer", ":id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of ES,FR)", "type": "text/plain" }, "key": "country", "value": "ES" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) National identifier of the contracting body: DIR3 code or NIF (Spain), SIRET (France). Find it with /procurement/buyers?name=.", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "buyers", "description": "", "item": [ { "id": "02e4b2fd-539b-4067-a029-991bfcc235bc", "name": "List scored public buyers by risk (beta, ES + FR)", "request": { "name": "List scored public buyers by risk (beta, ES + FR)", "description": { "content": "Contracting bodies ordered by one of the two buyer scores, highest first, with keyset pagination: a portfolio screen (`min_score=8`), a region view or a name lookup to find a buyer's identifier. Each row carries the buyer, its coverage and both risk blocks; the full profile (behaviour, evidence, top suppliers) is on /procurement/buyer/{id}. Beta; Spain and France.", "type": "text/plain" }, "url": { "path": [ "procurement", "buyers" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of ES,FR)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "Which score orders the list and min_score applies to. (This can only be one of competition,counterparty)", "type": "text/plain" }, "key": "model", "value": "competition" }, { "disabled": false, "description": { "content": "Keep buyers whose score for `model` is at least this.", "type": "text/plain" }, "key": "min_score", "value": "" }, { "disabled": false, "description": { "content": "Buyer name, matched anywhere in the normalised name.", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "Region name, matched anywhere (e.g. Andalucía, Grand Est).", "type": "text/plain" }, "key": "region", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Keyset cursor from pagination.next_cursor (_).", "type": "text/plain" }, "key": "cursor", "value": "" } ], "variable": [], "raw": "{{base_url}}/procurement/buyers?country=ES&model=competition&min_score=&name=®ion=&limit=20&cursor=" }, "method": "GET", "body": {}, "header": [ { "key": "Accept", "value": "application/json" } ] }, "response": [ { "id": "adb14473-8e75-49d3-b126-9937db8f3ab6", "name": "Buyers ordered by the chosen score", "originalRequest": { "url": { "path": [ "procurement", "buyers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of ES,FR)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "Which score orders the list and min_score applies to. (This can only be one of competition,counterparty)", "type": "text/plain" }, "key": "model", "value": "competition" }, { "disabled": false, "description": { "content": "Keep buyers whose score for `model` is at least this.", "type": "text/plain" }, "key": "min_score", "value": "" }, { "disabled": false, "description": { "content": "Buyer name, matched anywhere in the normalised name.", "type": "text/plain" }, "key": "name", "value": "" }, { "disabled": false, "description": { "content": "Region name, matched anywhere (e.g. Andalucía, Grand Est).", "type": "text/plain" }, "key": "region", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Keyset cursor from pagination.next_cursor (_).", "type": "text/plain" }, "key": "cursor", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "relationship", "description": "", "item": [ { "id": "046ad92b-54d5-41fa-9b75-22a71256716e", "name": "Buyer-supplier relationship (beta, ES + FR)", "request": { "name": "Buyer-supplier relationship (beta, ES + FR)", "description": { "content": "How dependent a buyer and one of its five largest suppliers are on each other: awards, awarded value, the supplier's share of the buyer's awarded value, first and last award, single-bid awards and average bids, plus the supplier's activity code and insolvency date when it failed. Only the buyer's five largest supplier relationships by awarded value are held; the full award list for any supplier is on /procurement/awards (Spain).", "type": "text/plain" }, "url": { "path": [ "procurement", "relationship" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of ES,FR)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "(Required) National identifier of the contracting body (DIR3 or NIF for Spain, SIRET for France).", "type": "text/plain" }, "key": "buyer", "value": "" }, { "disabled": false, "description": { "content": "(Required) Supplier tax id (NIF for Spain, SIREN for France).", "type": "text/plain" }, "key": "supplier", "value": "" } ], "variable": [], "raw": "{{base_url}}/procurement/relationship?country=ES&buyer=&supplier=" }, "method": "GET", "body": {}, "header": [ { "key": "Accept", "value": "application/json" } ] }, "response": [ { "id": "15473e4b-3c0d-4e7b-8ba7-5a6f65857493", "name": "buyer, supplier, as_of, relationship, limits", "originalRequest": { "url": { "path": [ "procurement", "relationship" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of ES,FR)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "(Required) National identifier of the contracting body (DIR3 or NIF for Spain, SIRET for France).", "type": "text/plain" }, "key": "buyer", "value": "" }, { "disabled": false, "description": { "content": "(Required) Supplier tax id (NIF for Spain, SIREN for France).", "type": "text/plain" }, "key": "supplier", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "awards", "description": "", "item": [ { "id": "919a6c6d-d2b7-4564-9935-73c78a06d3a8", "name": "List public-procurement awards (six countries)", "request": { "name": "List public-procurement awards (six countries)", "description": { "content": "Public-contract awards as published by each contracting body: Spain from the Plataforma de Contratación del Sector Público (PLACSP), open tenders and minor contracts alike; France from the consolidated DECP; the United Kingdom from Contracts Finder and Find a Tender; Ireland, Poland and Norway from TED eForms, above the EU thresholds only. Lists awards by supplier, buyer, supplier identifier, CPV code and date, newest first, with keyset pagination; pass `country` to restrict to one country or omit it for all six. One row per award to one supplier: amount_eur is that supplier's share as published, before VAT where the source distinguishes it; amount_contract_eur is the whole contract, counted once however many suppliers hold it; a framework or dynamic-purchasing ceiling is flagged amount_is_ceiling and a form-default figure amount_suspect. Amounts published in pounds, złoty or krone are converted at the ECB annual average rate for the award year (currency keeps the published one). company_id is set when the supplier identifier resolves to a company record (Spain, France, United Kingdom); the award is returned either way. Awards to natural persons are never returned.", "type": "text/plain" }, "url": { "path": [ "procurement", "awards" ], "host": [ "{{base_url}}" ], "query": [ { "disabled": false, "description": { "content": "Prometiam company id of the supplier, from /companies/search.", "type": "text/plain" }, "key": "company_id", "value": "" }, { "disabled": false, "description": { "content": "Supplier identifier as published, exact match: NIF/CIF (Spain), SIRET (France), Companies House number (United Kingdom), CRO number (Ireland), NIP or KRS (Poland), organisasjonsnummer (Norway); supplier_id_scheme says which.", "type": "text/plain" }, "key": "nif", "value": "" }, { "disabled": false, "description": { "content": "Supplier name, matched anywhere in the published name (min 3 characters).", "type": "text/plain" }, "key": "supplier", "value": "" }, { "disabled": false, "description": { "content": "Contracting body (órgano de contratación), matched anywhere in the published name (min 3 characters).", "type": "text/plain" }, "key": "buyer", "value": "" }, { "disabled": false, "description": { "content": "CPV code or prefix, 2 to 8 digits (45 = construction works, 45233 = road works).", "type": "text/plain" }, "key": "cpv", "value": "401" }, { "disabled": false, "description": { "content": "Award date on or after (YYYY-MM-DD).", "type": "text/plain" }, "key": "date_from", "value": "" }, { "disabled": false, "description": { "content": "Award date on or before (YYYY-MM-DD); clamped at today.", "type": "text/plain" }, "key": "date_to", "value": "" }, { "disabled": false, "description": { "content": "Minimum awarded amount in EUR.", "type": "text/plain" }, "key": "min_amount", "value": "" }, { "disabled": false, "description": { "content": "Restrict to one country. Omit for all six. (This can only be one of ES,FR,GB,IE,PL,NO)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Keyset cursor from pagination.next_cursor (YYYY-MM-DD_).", "type": "text/plain" }, "key": "cursor", "value": "" } ], "variable": [], "raw": "{{base_url}}/procurement/awards?company_id=&nif=&supplier=&buyer=&cpv=401&date_from=&date_to=&min_amount=&country=ES&limit=20&cursor=" }, "method": "GET", "body": {}, "header": [ { "key": "Accept", "value": "application/json" } ] }, "response": [ { "id": "4225633f-0051-4002-985a-e3289db4a73a", "name": "Awards, newest first. Each row: id, country, company_id, supplier_name, supplier_tax_id, supplier_id_scheme, buyer, buyer_id, subject, amount_eur, amount_contract_eur, amount_estimated_eur, amount_is_ceiling, amount_suspect, currency, award_date, last_change_date, nature, is_framework, n_suppliers, n_modifications, contract_type, procedure, cpv, bids_received, sme, duration_months, file_reference, source, source_url.", "originalRequest": { "url": { "path": [ "procurement", "awards" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Prometiam company id of the supplier, from /companies/search.", "type": "text/plain" }, "key": "company_id", "value": "" }, { "disabled": false, "description": { "content": "Supplier identifier as published, exact match: NIF/CIF (Spain), SIRET (France), Companies House number (United Kingdom), CRO number (Ireland), NIP or KRS (Poland), organisasjonsnummer (Norway); supplier_id_scheme says which.", "type": "text/plain" }, "key": "nif", "value": "" }, { "disabled": false, "description": { "content": "Supplier name, matched anywhere in the published name (min 3 characters).", "type": "text/plain" }, "key": "supplier", "value": "" }, { "disabled": false, "description": { "content": "Contracting body (órgano de contratación), matched anywhere in the published name (min 3 characters).", "type": "text/plain" }, "key": "buyer", "value": "" }, { "disabled": false, "description": { "content": "CPV code or prefix, 2 to 8 digits (45 = construction works, 45233 = road works).", "type": "text/plain" }, "key": "cpv", "value": "401" }, { "disabled": false, "description": { "content": "Award date on or after (YYYY-MM-DD).", "type": "text/plain" }, "key": "date_from", "value": "" }, { "disabled": false, "description": { "content": "Award date on or before (YYYY-MM-DD); clamped at today.", "type": "text/plain" }, "key": "date_to", "value": "" }, { "disabled": false, "description": { "content": "Minimum awarded amount in EUR.", "type": "text/plain" }, "key": "min_amount", "value": "" }, { "disabled": false, "description": { "content": "Restrict to one country. Omit for all six. (This can only be one of ES,FR,GB,IE,PL,NO)", "type": "text/plain" }, "key": "country", "value": "ES" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Keyset cursor from pagination.next_cursor (YYYY-MM-DD_).", "type": "text/plain" }, "key": "cursor", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{api_key}}", "type": "string" } ] }, "variable": [ { "key": "base_url", "value": "https://api.prometiam.com/functions/v1/risk-api", "type": "string" }, { "key": "api_key", "value": "", "type": "string", "description": "Your Prometiam API key (rk_live_...). 14-day free trial (card required, nothing charged for 14 days, 500 credits): https://www.prometiam.com/signup" } ] }