Prometiam Risk Intelligence MCP Server

List additions, removals and amendments detected on the sanctions lists, newest first. Use this to answer "what changed recently" without re-screening a whole book of business — each change carries the entity it affects, so a hit can be joined back to sanctions_entity.

Fetch full detail for a single sanctions entity by Prometiam internal ID: all aliases, the issuing programme/list, listing date, and identifying data. Get an ID from a sanctions_screen match.

Screen a person or entity name against 44,000+ active sanctions and export-control designations with trigram fuzzy match. Covers six sanctions lists — EU consolidated, UN, OFAC, the UK Sanctions List (FCDO), the French Registre des gels, and the Australian DFAT Consolidated List (Department of Foreign Affairs and Trade website – www.dfat.gov.au, CC BY 4.0) — plus 11 US export-control lists (BIS Entity List, Denied Persons, Unverified, Military End User; State ITAR-Debarred and Nonproliferation; OFAC SSI, CMIC, MBS, PLC, CAPTA). Refreshed daily. Returns matches with a match score (0–100, by match type as on company search: 100 the name is the query, 80–99 it starts with it, 50–79 it holds the words, under 50 only parts of words), source list, aliases and the country as an ISO code (country_as_listed keeps the spelling as listed); the same entity on several lists is one row per list unless group is entity. 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 in its own script and in Latin spelling match the same entity. Use threshold to control match strictness. BETA.

Screen up to 50 names against the sanctions lists in ONE call (POST /sanctions/screen). Requires the sanctions scope (batch calls do not use the free trial allowance); every item costs 3 credits. Per-item status: match / clear / error / timeout. "clear" means no hit at or above the threshold on the active lists, not a certification. Optional idempotency_key: replaying the same key with the same items within 24h returns the original response for free (409 if still running, 422 if the items differ).

Remove one of your sanctions watchlist entries by id (from sanctions_watchlist).

Add a name to your sanctions watchlist (sanctions_watch scope, Starter and above): the API re-screens it against every list update and reports new hits on sanctions_watchlist, or calls webhook_url when set.

Return your sanctions watchlists and any recent hits against them. Requires the sanctions_watch scope; the number of entries allowed depends on your tier. Add entries with sanctions_watch and remove them with sanctions_unwatch.

Check up to 100 counterparties for CORPORATE insolvency notices in ONE call (POST /insolvency/check) across FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV, EE and SG. Each item: country plus company_number (alias siren; exact, as printed on the notice) or name. Returns up to 5 notices per item, newest first, plus latest_filing_date; status found / none / error / timeout. "none" is not proof of solvency. Every item costs 2 credits. Optional idempotency_key: replaying the same key with the same items within 24h returns the original response for free (409 if still running, 422 if the items differ).

Search CORPORATE insolvency notices published in official gazettes and registers across France, Germany, the UK, Austria, Switzerland, Norway, Finland, the US, the Netherlands, Denmark, Croatia, Sweden, Spain, Latvia, Estonia and Singapore. Use this for distress coverage in all sixteen markets. DE, AT, US and NL notices stand alone: they are not linked to company records (German and US company records come from other sources and do not carry them). FR, GB, NO and ES notices are linked by company number or NIF, and the notices of the other registry countries can be cross-referenced against companies_search with the same country code (for FI, DK, HR, SE and CH the notices are linked by business ID, CVR number, MBS, organisationsnummer and UID: a company record with include=insolvency returns them; a Swiss notice is linked only where the SHAB notice names the debtor's UID, and one without a UID stays unlinked). 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; no court or case number); HR notices are court decisions from the Croatian court register (only companies still on the register); SE notices are Bolagsverket's procedure data (konkurs, företagsrekonstruktion, ackordsförhandling), updated weekly, with no court, case number or link, and proceedings that ended before collection are not included. Belgium and Slovakia are not insolvency markets (their bankruptcy shows in the company status). Spanish notices are the concurso entries (declaration, opening of the liquidation phase, conclusion) published 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, and an entry that cannot be tied to the company, or whose NIF is an administrator's, is withheld. Latvian notices are the Insolvency Register's insolvency and legal protection proceedings, an opening notice 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, updated daily. Estonian 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, for companies still on the register, in liquidation or in bankruptcy only (a floor), sole traders (FIE) never served. Singapore 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; linked to the company record by the UEN (a company record with include=insolvency returns them), and a notice that prints no valid UEN stays unlinked. Spanish notices: based on data from the Agencia Estatal Boletín Oficial del Estado (BORME). 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. 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. US notices are not linked to the US company records. Personal/consumer insolvency is deliberately excluded and is never returned. Distinct from insolvency_search, which covers the linked ES/FR/GB risk-notice corpus. Contains CVR data (Erhvervsstyrelsen), CC BY 4.0.

Fetch a single insolvency / risk notice by Prometiam internal ID, with related corporate events. Get an ID from insolvency_search.

Search insolvency and risk notices (bankruptcies, liquidations, court judgments) by company name or identifier. Complements company registry data with distress signals. Scope with country and date range.

Get one monitored company by its monitor ID, including its alert history (events/status/sanctions matches detected since subscription).

List the companies currently subscribed to ongoing monitoring for this API key, with their labels and last-alert timestamps. Company monitoring (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, IT, IN, AT, GR, LU, HU, PT, JE, MX, NL, AR, UA, RS, EC, IT, IN, AT, GR, LU, HU, PT, US) emits status changes, dissolutions, sanctions matches and, for ES, GB, IE/PL/NO (the last three from 14 Oct 2026) and FI/SE/BE/HR/DK/EE/SK/CH/LV/CY/RO/LT/CA/AU/JP/IL/SG/CO/TW/BR/CZ/DE/IT/IN/AT/GR/LU/HU/PT/JE/MX/NL/AR/UA/RS/EC/IT/IN/AT/GR/LU/HU/PT/US, corporate events to a webhook.

Stop monitoring a company and delete its subscription by monitor ID. This is irreversible — the alert history is removed.

Subscribe a company to ongoing monitoring. Status changes, dissolutions, sanctions matches and corporate events (ES, GB, IE/PL/NO (the last three from 14 Oct 2026) and FI/SE/BE/HR/DK/EE/SK/CH/LV/CY/RO/LT/CA/AU/JP/IL/SG/CO/TW/BR/CZ/DE/IT/IN/AT/GR/LU/HU/PT/JE/MX/NL/AR/UA/RS/EC/IT/IN/AT/GR/LU/HU/PT/US) are checked every 30 minutes from 05:00 to 22:30 UTC and POSTed to your webhook_url (HMAC-SHA256 signed). Returns the monitor ID and a webhook_secret (shown once). Available for Spain (ES), the United Kingdom (GB), Ireland (IE), Poland (PL), Norway (NO), Finland (FI), Sweden (SE), Belgium (BE), Croatia (HR), Denmark (DK), Estonia (e-Business Register), Slovakia (RPO), Switzerland (Zefix), Latvia (Register of Enterprises), Cyprus (DRCOR), Romania (ONRC), Lithuania (JAR), Canada (federal corporations), Australia (ASIC and ABR), Japan (NTA), Israel (Corporations Authority), Singapore (ACRA), Colombia (RUES), Taiwan (GCIS), Brazil (CNPJ), Argentina (RNS, read monthly: no events before 28 Oct 2026, and no dissolution alert), the Czech Republic, Germany (LEI-registered entities and energy-market register companies, sanctions matches only for the latter), the Netherlands (LEI-registered entities with a KVK number) and Mexico (LEI-registered entities; a company only INEGI's DENUE directory lists raises sanctions matches only), that is every live country except France and Chile. A dissolution alert fires on the dissolution date the register gives or, where the register gives none (Canada, Israel, Singapore, Taiwan, Romania, many US registrations), when the status first shows closed (detail.date_basis first_seen_closed, else register). This creates a persistent subscription, active until it is stopped with monitor_stop.

List public-contract awards by supplier, buyer, supplier tax id, CPV code and date, newest first. Spain (PLACSP, including minor contracts), France (DECP), the United Kingdom (Contracts Finder, Find a Tender) and Ireland, Poland and Norway (TED, above the EU thresholds only); pass country to restrict, omit it for all countries. One row per award to one supplier: amount_eur is that supplier's share as published, before VAT where the source distinguishes; amount_contract_eur is the whole contract; amount_is_ceiling marks a framework or dynamic-purchasing ceiling that is not spend; amount_suspect marks a form default rather than a price. bids_received is the competition signal where the source publishes it. company_id is set when the supplier resolves to a company record in that country (use company_detail on it). Natural-person suppliers are never returned. Requires at least one of company_id, nif, supplier, buyer, cpv or date_from.

Risk profile of a PUBLIC BUYER (a contracting body) in Spain or France — BETA. Two calibrated scores about the buyer, never about a supplier or a tender: competition = probability that its next award receives a single bid; counterparty = probability that a supplier it awards to enters insolvency within 24 months (weak signal). Each carries score 1-10 (log-odds ladder, 1 = 1st percentile of the country's buyers, 10 = 99th), probability, base_rate, relative_risk, percentile of the residual, observed/expected rates, awards_scored, confidence; plus behaviour ratios, up to three evidence awards and the five largest supplier relationships. Find the id with procurement_buyers. A score is a prompt to look, not a finding of wrongdoing.

List scored public buyers (contracting bodies) in Spain or France ordered by one buyer score, highest first — BETA. Use it to screen a portfolio (min_score), to see a region, or to find a buyer's identifier by name before calling procurement_buyer. Rows carry the buyer, its coverage and both risk blocks (score 1-10, probability, base_rate, relative_risk).

How dependent a public buyer and one of its five largest suppliers are on each other (Spain or France, BETA): awards, awarded value, the supplier's share of the buyer's awarded value, first/last award, single-bid awards, average bids, and the supplier's insolvency date when it failed. Only the five largest relationships per buyer are held; a supplier outside them returns 404 — use procurement_awards for its full award list (Spain).

Find ONE company from an identifier, the country worked out for you (GET /companies/by-identifier, 1 credit, answered like company_detail with the same include). type=vat: the prefix names the country (ES, FR, ... EL is Greece, XI Northern Ireland, CHE Switzerland), then that country VAT search runs; a number without a prefix needs country; countries whose registers publish no VAT number answer 400. type=lei: our GLEIF links first, else GLEIF own record (legal-address country plus registered-as number). type=company_number: needs country. meta.resolved_by says which rule found it (vat_prefix, vat_with_country, lei_link, gleif_registration, company_number). No match is a 404; several records (a US number repeated across states) a 409 with candidates.

Fetch a single company by Prometiam internal ID, or by the register's own number: give country and company_number (NIF, SIREN or SIRET, CRN, KRS, CVR, ...; GET /companies/{country}/{company_number}, 1 credit, same answer and same include). No company with that number is a 404; a number several companies carry (US registers, a German commercial-register entry) is a 409 ambiguous_company_number whose error.candidates list the ids. Returns full profile including officers (appointments for ES, FR, GB, NO, PL and CZ; Czech Republic: the members the register lists today, natural persons as the name and the month and year of birth only, a company member's foreign register number left out when it has the shape of a personal number, no officer history, no person records; null with a notice when they could not be read, which means unknown, not none), registry coordinates, founding date and the age fields (age_years, age_band, age_basis), the NACE class with its English title and the same industry as NACE Rev. 2 and Rev. 2.1, ISIC Rev. 4 and NAICS 2022 codes (the rules and limits are those of companies_search), capital, current standard status (with stage and the register's local_status), standard legal form (with local_legal_form), identifiers and registry_details, and advertising_protected (Denmark: the CVR register mark that the company asked not to be contacted for direct marketing, CVR act s.19; true means do not use the record for direct marketing, false means the register states no protection, null for other countries and where the register holds no mark yet; the company is served either way). include=lei (Spain) adds lei_record, the GLEIF record; lei is the code string. recent_events (ES/FR/GB) carries the same served event_type + raw act_type as events_search. Get an ID from companies_search first. Pass include to attach extra blocks — notably risk_flags (published tax-debt / debarment signals) and insolvency. 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. eu_size_class, eu_size and fiscal_year_end_month (every plan, no extra credit): an INDICATIVE EU size class (micro, small, medium or large of Commission Recommendation 2003/361/EC: staff under 10, 50 and 250, and turnover or balance sheet total up to EUR 2m, 10m and 50m, 43m for the balance sheet total) read from the latest annual accounts held (fiscal year 2022 or later) and the register head count; a class, never the figures, with eu_size.range (the classes still possible when the class is null), eu_size.basis, eu_size.autonomy (unverified, or group_member_known) and indicative true. Not a determination that a company is or is not an SME: the partner and linked-enterprise test cannot be applied (a known parent only floors the class; France INSEE category ETI or GE means large, PME at most medium), one year is read, the head count is the accounts average or the register, not annual work units. GB, RO, FR, EE, SE, DK, LV and NO give a class; LT and FI (no head count) a range, or large; null for sole proprietorships (ENK, EI), Brazil, Colombia and every other country. fiscal_year_end_month (1-12) is the month the latest annual accounts end, for every company of those countries with annual accounts held, whatever the fiscal year.

Annual financial statements of a company as filed with the official registers, mapped to one standard chart (revenue, gross profit, operating profit, net profit, assets, cash, equity, liabilities, employees), in the filing currency and in euro, up to ten fiscal years. A null figure was not stated in the filing, never zero. Annual accounts as filed, for GB, FR, DK, SE and NO, plus FI (statements filed digitally with PRH, the Finnish Patent and Registration Office: XBRL, the company own accounts, about one filer in twenty, registered since July 2023, no employee count, profit before tax before appropriations; plus listed groups), US SEC filers (annual reports 10-K, 20-F and 40-F from EDGAR XBRL, consolidated, US GAAP or IFRS, fiscal years from 2023, in the filing currency (mostly USD) plus euro; no statements for other US companies) and consolidated annual reports of listed groups in GB, DK, SE, LV and LT (ESEF, IFRS, beside the individual accounts, fiscal years from 2022; the latest is fiscal 2024 for SE and 2023 for LV), and listed companies only in ES, PL, HR and BE (their ESEF annual financial reports, IFRS, mostly consolidated; the report of every listed company is not held, and Polish reports arrive more than a year late; reports of Spanish listed companies are available free of charge on the CNMV website). 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 only digitally filed accounts: GB electronic (iXBRL) filings, about three in four, where 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 in the accounts. 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 filings.xbrl.org (XBRL International) 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 in the filing currency plus euro at the ECB annual average of the fiscal year (for comparison, not an accounting translation). 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 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. Finnish companies also return data.tax_records (newest tax year first, from tax year 2020; Finnish Tax Administration public corporate income tax data, CC BY 4.0; 0 means none, not unknown; null when the read failed) and meta.tax_note. Contains data from the Finnish Patent and Registration Office (PRH), CC BY 4.0. Other companies in ES, PL, HR, BE and BR (meta.availability listed_companies_only), other US (sec_filers_only) and Colombian (supersociedades_filers_only) companies, Australian companies (tax_records_only: no statements), Finnish companies without a digital filing (no_statement_held) and IE (PDF images) answer with empty statements and meta.availability. Needs the Scale plan or above (Starter, Professional and free trial keys get 10 calls a month, then upgrade_required). A call that returns statements costs 25 credits; an answer with no statement held costs 0 and uses none of the 10 calls. Every null figure is explained in statements[].quality.missing ({field: reason}: confidential, not_filed, reported_as_gross_profit, not_published_by_register, not_stated, not_collected_for_source); also in figures and figures_eur: operating_cash_flow, capital_expenditure, free_cash_flow (operating cash flow less capital expenditure, where both are filed), dividends_paid (cash paid out as positive amounts; DK and SE: the dividends distributed in the year), cost_of_sales, tax_expense, retained_earnings, financial_debt_long_term, financial_debt_short_term, trade_payables and provisions, each read only where the country's source gives it (cash flow: US SEC filers, listed companies in ES, PL, HR, BE and FI, and BR; none for GB, DK, SE, NO), and what the filing declares: accounts_type (GB, DK, NO, US), audit.status (GB, DK, NO), audit.opinion (BR: unqualified, qualified, adverse, disclaimer) and audit.auditor_name (DK), each null where nothing is stated; for Norway the latest statement of the company itself carries the head count of the register record when the accounts have none (quality.notes employees_from_register, today's figure); company.employee_band is France only (INSEE size band today). A statement that carries ratios also carries ratio_benchmarks: per ratio {percentile (5 to 95; higher means a higher ratio, not a better one), cell {country, nace_division, size_band, year, companies}} among peers of the same country, NACE division, size band (total assets in euro) and statement type, in cells of at least 30 companies (a year with fewer is pooled with the year before, cell.pooled), or null where no cell exists. 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 only, and not for a company without a NACE-based activity code. A percentile is descriptive, not a rating.

Look up a Legal Entity Identifier (LEI) in the GLEIF global register by its 20-character ISO 17442 code. Returns 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.

GLEIF Level 2 corporate ownership ("who owns whom") for a 20-character LEI: its direct parent, ultimate parent, and direct children — each with LEI, legal name, jurisdiction, status, and city/country. Reveals the accountable ownership chain behind an entity. Only relationships reported to GLEIF are returned (many entities report none).

Search the GLEIF global LEI register by legal-entity name (full-text). Returns candidate LEIs with legal name, jurisdiction, status, and city/country — use to resolve a company name to its LEI before lei_lookup. Ranked by match_score (exact name, then names starting with yours, then names holding the words), so name=telefonica lists TELEFONICA SA first.

Resolve up to 100 companies in ONE call (POST /companies/lookup). Each item needs country plus an identifier (company_number; aliases nif, siren, vat) or a name (best fuzzy match with match_score; exact only: no similar-spelling fallback and no other-letter NIF). Results come back in request order with status found / not_found / error / timeout and the same company object companies_search returns. Every item costs 1 credit; a batch that does not fit is refused with 429 batch_exceeds_quota and max_items_now. Optional idempotency_key: replaying the same key with the same items within 24h returns the original response for free (409 if still running, 422 if the items differ).

Search companies in official registries by name or identifier. Every company is one standard object with the same keys in all 36 countries (null where the register publishes no value): identifiers [{type, value}], vat_number and vat_number_source (register or rule; also in identifiers as type vat; `register`: published by the register (EE; LV from the State Revenue Service’s list of VAT payers; LT from the State Tax Inspectorate’s list; AU the ABN while GST-registered; TW the unified business number where the company is in the tax file) or the register confirms VAT registration and the number is the legal format of its identifier (NO, FI, BE). `rule`: built from the company identifier (ES `ES`+NIF, FR `FR`+key+SIREN, PL `PL`+NIP, NO `NO`+number+`MVA`, FI, SE `SE`+number+`01`, BE, HR `HR`+OIB, DK, RO `RO`+CUI, CH `CHE`+UID+`MWST`): the format is right, the registration is not confirmed (check an EU number with `GET /vat/{number}`; VIES has no NO or CH). Null where the register says the company is not VAT-registered (NO, FI), where a Latvian company is not on the State Revenue Service’s list of VAT payers, and where no rule exists (GB, IE, SK, CY, US, CA, JP, IL, BR, CO, SG, CZ, DE, IT, IN, AT, GR, LU, HU, PT, JE, MX, and EE without a published KMKR).), the standard legal_form abbreviation and legal_form_family beside the register's local_legal_form and local_legal_form_name, a standard status and stage beside the register's own local_status, one main activity_code with its scheme, label and NACE class (nace_class, nace_version, nace_division, nace_derived, and nace_title, its English title), the same industry as a NACE Rev. 2 and a NACE Rev. 2.1 class or division (nace_rev2_class, nace_rev2_division, nace_rev21_class, nace_rev21_division), the ISIC Rev. 4 class (isic4_class) and the US NAICS 2022 sector and subsector (naics_sector, naics_subsector) through the official correspondence tables of Eurostat, the United Nations and the US Census Bureau (a class only where the table links exactly one, the division where the linked classes share one, otherwise null, never a guess and never read from the name; ES and PL mix two editions of their classification, so a class that exists in both revisions with changed content is served only when both readings give it; BR, CO and SG derive from ISIC Rev. 4), and the age of the company: age_years (whole years on the day of the answer), age_band (under_1y, 1_3y, 3_5y, 5_10y, 10_20y, 20y_plus) and age_basis (founding_date, else registration_date; null for CH and JP, which publish no founding date, and for DE, which serves no founding date; in an LEI layer the date is the entity creation date GLEIF holds, which can be later than the start of the company), address with region, capital_amount and capital_eur, and registry_details for what only one register has (null when the dictionary does not recognise a stored value — never a guess), and advertising_protected (Denmark: the CVR register mark that the company asked not to be contacted for direct marketing, CVR act s.19; true means do not use the record for direct marketing, false means the register states no protection, null for other countries and where the register holds no mark yet; the company is served either way). Use country to scope the search to Spain (BORME), France (BODACC), the UK (Companies House), Ireland (CRO), Poland (KRS), Norway (Brønnøysundregistrene), Finland (Kaupparekisteri), Sweden (Bolagsverket), Croatia (Sudski registar), Belgium (KBO/BCE), Denmark (CVR), Estonia (e-Business Register), Slovakia (RPO), Switzerland (Zefix), Latvia (Register of Enterprises), Cyprus (DRCOR), Romania (ONRC), Lithuania (JAR), Canada (Corporations Canada), Australia (ASIC and the ABR), Japan (National Tax Agency), Israel (Corporations Authority), Brazil (CNPJ), Colombia (RUES), Singapore (ACRA), Taiwan (GCIS), the Czech Republic (public register, Ministry of Justice, and RES), Germany (LEI-registered entities and energy-market register companies), Mexico (LEI-registered entities and the companies of INEGI's DENUE directory, not the company register), or the United States (state registers, SEC EDGAR and GLEIF). Fuzzy name results carry a match_score (0–100) and are ranked by relevance, best first. NOTE: "dissolved" means different things by country — ES/FR still exists pending liquidation, GB/IE/PL/NO/FI no longer exists — read status (the standard value), not local_status, to compare across countries. Norway and France include sole proprietorships (ENK, EI) as the register publishes them; a French company that opted out of publication (INSEE non-diffusible) has company_name null, status withheld and registry_details.non_diffusible true, is left out of name searches, the founding-date feed and event searches by name, and is found by SIREN or SIRET. Every French company carries registry_details.diffusion_status, the Sirene status of the company: O diffusible, P partially diffusible (the company or its owner restricted the diffusion of its data, art. A.123-96 of the Code de commerce), null while not read yet; a P company has no address and no postal code, and a sole proprietorship that INSEE lists without a name is served like a non-diffusible company. A Spanish company closed by a merger is served as closed (local_status absorbed). A malformed identifier (a Spanish NIF must pass its control character), or a limit outside the documented range, is a 400 validation_error. A name search ranks a pool of up to about 700 candidates and pages through it: when has_more is true, pass next_cursor (o:<n>) back as cursor (offset=<n> is the same), 1 credit a page; a page past the pool is empty. match_score (0-100) means the same in every country: 100 the name is the query, 80-99 it starts with the words of the query, 50-79 it holds every word, below 50 parts of words. match_type on every result says what it matched on: exact (the identifier, the whole name, or a listing with no name), partial (the name starts with or holds the words) or, only when the usual search found nothing, fuzzy (a similar spelling, any country: similarity 0.6 or more, 0.45 in Spain, at most 10 companies, meta.search_mode name_fuzzy, approximate) or nif_other_letter (Spain only: a NIF with entity letter A or B that finds nothing returns the company holding the same digits under the other letter, which may be another company: confirm the name; meta.search_mode nif_other_letter). Both fallbacks cost the same credits as a normal search and are never applied by companies_lookup, which stays exact. To fetch one company by its register number (NIF, SIREN, CRN, KRS, CVR) use company_detail with country and company_number. eu_size_class, eu_size and fiscal_year_end_month (every plan, no extra credit): an INDICATIVE EU size class (micro, small, medium or large of Commission Recommendation 2003/361/EC: staff under 10, 50 and 250, and turnover or balance sheet total up to EUR 2m, 10m and 50m, 43m for the balance sheet total) read from the latest annual accounts held (fiscal year 2022 or later) and the register head count; a class, never the figures, with eu_size.range (the classes still possible when the class is null), eu_size.basis, eu_size.autonomy (unverified, or group_member_known) and indicative true. Not a determination that a company is or is not an SME: the partner and linked-enterprise test cannot be applied (a known parent only floors the class; France INSEE category ETI or GE means large, PME at most medium), one year is read, the head count is the accounts average or the register, not annual work units. GB, RO, FR, EE, SE, DK, LV and NO give a class; LT and FI (no head count) a range, or large; null for sole proprietorships (ENK, EI), Brazil, Colombia and every other country. fiscal_year_end_month (1-12) is the month the latest annual accounts end, for every company of those countries with annual accounts held, whatever the fiscal year.

Search normalized corporate-event records (capital changes, director changes, dissolutions, mergers, insolvency, name changes, etc.) by company, or, with neither company_name nor company_number, as the country event feed (every event of that country, country then required, newest first, from date_from: default 7 days ago, at most 31 days back), for Spain, France and the UK (from their gazettes) and, as register-change events, for Ireland, Poland, Norway, Finland, Sweden, Belgium, Croatia, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus, Romania, Lithuania, Canada, Australia, Japan, Israel, Singapore, Colombia, Taiwan, Czech Republic, Germany, the Netherlands, Ukraine, Serbia, Ecuador, Brazil, Mexico (LEI-registered entities only: a company only INEGI's DENUE directory lists has none) and the United States. Returns events with a served event_type matching this enum for each of those countries (each row also carries act_type, the raw BORME/BODACC/Companies House code it was derived from, or null when not yet covered), event date, before/after values, and source notice URL. The register-change events of the five (name, status, legal form and registered address; share capital for HR, EE, SK, CH, LV, LT, TW, BR and CZ; for Ukraine name, status, legal form and share capital, no registered address; for Serbia the address is the municipality; for Ecuador the address is the canton) are dated when the change first appears in the register data (for the United States, the weekly read of the registers that first sees it), are not gazette notices and start on 2026-09-30 (Ecuador and Mexico: none before their launch). Ireland, Poland and Norway publish no gazette either; their register-change events are dated the same way and none are before 14 Oct 2026. Every event carries advertising_protected: for a Danish company the CVR advertising-protection mark (CVR act s.19; true means do not use the event for direct marketing, and pass the company name or address on only with the mark), null otherwise.

Returns the event history for one company, newest first. Useful for building lifecycle timelines from incorporation through capital changes, director appointments, and dissolution. One of company_number or company_name is required. Every event carries advertising_protected: for a Danish company the CVR advertising-protection mark (CVR act s.19; true means do not use the event for direct marketing, and pass the company name or address on only with the mark), null otherwise.

Returns the calling API key's account info and current usage: plan tier, rate limits (per minute in requests, per day / month in credits), credits used and left, and enabled scopes. It also returns the purposes declared for the account and for this key (declared_purposes, key_purposes; null until declared) and the legal documents the account accepted (accepted_documents: document, version, day, link). Costs no credits. Use this to check "how many credits do I have left?".

Returns dataset coverage statistics: per-country company count, event count, person count, latest filing date, and data sources. Use this when a user asks "what countries does Prometiam cover?" or "how fresh is the data?".

List directors/officers who sit on many companies (cross-directorship rollup), optionally filtered by name. Useful for spotting nominee directors and network hubs in due diligence. Currently Spain (ES) only; other countries return an empty set with a notice.

Fetch a single corporate-event record by Prometiam internal ID, with its full before/after values and, with include=notice, the source publication (BORME, BODACC or Companies House; null for other countries). Get an ID from events_search or events_timeline first.

Search officers / directors / shareholders by name across EU + UK registries. Returns matching people with their appointment counts, ranked by a fuzzy-match match_score (0–100), best first. Use person_detail for a full appointment history. Scope with country — officer-level data is held for Spain, France, the UK and Norway (Polish and Czech officers are on the company record only: the KRS masks natural persons and the Czech register lists its members without a person id, so there are no person records for either and no search by officer name); Ireland, Finland, Sweden, Croatia, Belgium, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus and Romania are company-level only.

Fetch a single person (officer / director) by Prometiam internal ID. Returns the person's full appointment history across all companies. Useful for director-network analysis and counterparty due diligence. Get the ID from a company_detail or people_search response. 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.

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 check — returns a retryable error when a member-state registry is temporarily down (not a false "invalid"). 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.