All servers / Data / Prometiam Risk MCP server
Prometiam Risk MCP server
Prometiam Risk Intelligence as a Model Context Protocol server for company data and KYB: official company-register data for 41 countries (ES, FR, GB, IE, PL, NO
Tested by ConnectATDScore 86 out of 100. Tested 2026-11-19 on package version 0.4.67. Package: prometiam-risk-mcp
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 20 / 20 | |
| Package safety | 16 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 12 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (3.0 seconds including download)
- Tools offered: 38
- Last published: 2026-11-18
- Weekly downloads (npm): 1,250
- License: MIT · Direct dependencies: 2
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
companies_search26 of 26 parameters describedSearch companies in official registries by name or identifier. Every company is one standard object with the same keys in every country (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; SK from the Financial Administration’s list of VAT payers; LT from the State Tax Inspectorate’s list; JP the T-number from the register of qualified invoice issuers kept by the National Tax Agency, while the registration is in force; 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`, GR `EL`+AFM): 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, where a Slovak company is not on the Financial Administration’s list of VAT payers, where a Japanese company is not a qualified invoice issuer or its registration was cancelled or has expired, and where no rule exists (GB, IE, CY, US, CA, IL, BR, CO, SG, CZ, DE, IT, IN, AT, LU, HU, PT, JE, MX, SI, and EE without a published KMKR).), lei with lei_status (the LEI's registration status as GLEIF writes it, upper case: ISSUED, LAPSED, RETIRED, MERGED, ANNULLED ...; LAPSED is an unpaid or unconfirmed annual renewal, not a sign of distress, and a lapsed LEI can be renewed at any time), lei_next_renewal (the day the next renewal falls due) and lei_renewal_overdue_days (days since an ISSUED or LAPSED LEI's renewal fell due, computed when you ask; null while not yet due); all three are null where the company has no LEI link (GLEIF golden copy, CC0, read daily), the standard legal_form abbreviation, legal_form_family and legal_form_elf (the ISO 20275 code from GLEIF's list, CC0 1.0: one code per form where the list names the form, null where it has no single code - branches, public bodies, variants and forms that could be several codes; the US by state of formation; an LEI-registered entity serves the code its LEI record states) beside the register's local_legal_form and local_legal_form_name, a standard status and stage, status_group (active or inactive) and status_qualifier (rescue_plan, insolvency_proceedings, administratively_non_compliant, bankruptcy, in_liquidation, dissolved, dissolved_merger, dissolved_demerger, administratively_suspended, inactive) beside the register's own local_status (both are read from the register's own status and never inferred from silence: the qualifier is null for an ordinary active company and wherever the register does not say; a rescue plan only where the stored status says so; administratively_suspended only for Brazil's suspended registrations, not a pause the company asked for; Australia's external administration serves no group; dormant, reorganization, default of payment and a dissolution that followed a bankruptcy or a liquidation are not served), 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 o…
company_detail4 of 4 parameters describedFetch 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, CZ and CO; Colombia: the legal representative the Chamber of Commerce registration names, name only, never an identification number, no dates, no person record or director network; 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 Latin name of a company whose register writes its name in another script (name_latin, name_latin_basis; the rules and limits are those of companies_search), 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 and legal_form_elf, the ISO 20275 code, null where GLEIF's list has no single code for the form), identifiers, the NUTS 2024 regions (nuts1, nuts2, nuts3 with Eurostat’s names, nuts_version, lau_code; the same limits as companies_search: each level only where the register’s stated place is exactly one region, else null) 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). Also change_activity: events counted (not people; a kind once a day, a rewrite of an address or name with the same words not at all) of address, name, capital and management changes in the last 12 and 36 months, with history_from and window_complete (a window that begins before the feed does is a floor); null for GB and where the feed does not record a kind; see companies_search for the limits. 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; Colombia: procurement_fine; Spain also public grants as informational `subsidy` flags from the national grants database BDNS, concessions from 26 Sep 2026, legal entities only, never counted by has_risk_flag) 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. bic (every company that has an lei, no extra credit): the BIC codes that the GLEIF BIC-to-LEI mapping, built by SWIFT and updated monthly, lists for the LEI ([] when it has none, null when the company has no lei); an answer that carries a BIC carries SWIFT notice in meta.attribution, keep it with the codes. mic (same rule): the m…
company_financials8 of 8 parameters describedAnnual 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 (and with convert_to in any currency with an ECB annual average rate, or EUR: figures_converted, ratios_converted and fx_converted, the nearest year's rate where the fiscal year is missing), 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 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 no Polish report has been added since July 2024; 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; no LV report added since July 2024); credit: Contains annual financial reports published by the issuers (ESEF, IFRS), collected by XBRL International (filings.xbrl.org). Adapted by Prometiam. A report collected there carries the day the repository added it as filing_date. 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 o…
company_group5 of 5 parameters describedThe corporate group a company belongs to, from the relationship records companies report to GLEIF (Level 2, CC0): the group head (the ultimate parent), every country the group reaches with its number of companies and the company that leads it (its country head, the top group company there; in the country of the group head the lead is the group head itself, role group_head, not a second country head), and a page of the group companies sorted by country, then depth below the head, then name. role says where the company stands: group_head, country_head or member. Costs 2 credits; an answer with no group, or a page with no company, costs nothing. Scope limits: only companies with an LEI that report their parent, and the parents they name, appear, so most companies have no group (data.group is null with a notice: null means GLEIF holds none, not that none exists); the relationships are accounting consolidation as GLEIF holds them, not an ownership register; a company that reports no direct parent inside the group hangs under the group head (parent_in_group false); funds, branches and inactive entities are included as reported; company_id and company_country link a group company to a Prometiam record only where we serve its LEI and the key may open that country, else null. Source: GLEIF Level 2 relationship records (CC0); meta.data_as_of is the date of the golden copy, refreshed daily.
events_search9 of 9 parameters describedSearch 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, Slovenia, South Korea, Malta, 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.
events_timeline5 of 5 parameters describedReturns 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.
event_detail2 of 2 parameters describedFetch 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.
people_search4 of 4 parameters describedSearch 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, Czech and Colombian officers are on the company record only; Colombia gives the legal representative by name, no identification number: 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.
person_detail1 of 1 parameter describedFetch 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.
directors_network6 of 6 parameters describedList 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.
sanctions_screen5 of 6 parameters describedScreen 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) — national lists: the Dutch national terrorism list (CC0), the Japanese Ministry of Finance asset-freeze list (its own and autonomous measures, not those of the UN; Source: Ministry of Finance, Japan, PDL1.0, edited by Prometiam), the New Zealand Russia Sanctions Register (Crown copyright, CC BY 4.0), the Polish MSWiA list (CC BY-SA 4.0, offered under the same licence, personal identification numbers dropped), the Monaco national asset-freeze list (Liste nationale de gel des fonds, Direction du Budget et du Trésor, used with the Government's permission; entries as published, a hit is a possible match to review) and the US DHS UFLPA, FinCEN section 311, State FTO and Terrorist Exclusion and Department of Defense section 1260H lists (public domain) — 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.
sanctions_entity1 of 1 parameter describedFetch 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.
insolvency_search11 of 11 parameters describedSpain only: search Spanish insolvency and risk notices (bankruptcies, liquidations, court judgments) by company name or NIF (vat). Another country returns no rows: use insolvency_notices_search for corporate insolvency notices in the countries it lists, or events_search for the register and gazette events of a company. Scope with a date range.
insolvency_notices_search7 of 7 parameters describedSearch 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 r…
procurement_awards11 of 11 parameters describedList 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, Public Contracts Scotland: Scottish awards published from January 2019, Open Government Licence v3.0), Colombia (SECOP II, Colombia Compra Eficiente, CC BY-SA 4.0: contracts to companies by NIT, in pesos with no euro amount), Australia (AusTender, Department of Finance, CC BY 3.0 AU: contracts from AUD 10,000 to suppliers by ABN, only suppliers with a company or public-body marker, converted at the ECB annual average), Chile (Mercado Publico, Direccion ChileCompra, no licence stated: tenders to legal entities by RUT, in pesos with no euro amount) and, from TED (Tenders Electronic Daily), Ireland, Poland, Norway, Finland, Sweden, Denmark, Estonia, Latvia, Lithuania, Slovakia, the Czech Republic, Croatia, Romania and Belgium: above the EU thresholds only (contracts below them are not in TED, so not here), and for Finland to Belgium only awards published since November 2023, and for Colombia only awards dated from June 2015 (few before 2018), and for Australia and Chile only awards dated from 1 January 2025; 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. Every row carries amount_original (as published) and currency; a Colombian or Chilean contract has amount_eur null (no ECB peso rate), so min_amount never matches it: read amount_original and currency. 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; for the TED countries the published supplier name must also match the register, otherwise company_id is null and the award is still returned). Spain: contracts that public bodies publish only on the regional platforms of Catalonia, the Basque Country, Navarre, Madrid, Andalusia, Galicia and La Rioja are not included. Amounts are awarded amounts as published, not payments. 2 credits a call. Natural-person suppliers are never returned. Requires at least one of company_id, nif, supplier, buyer, cpv or date_from.
procurement_buyer2 of 2 parameters describedRisk profile of a PUBLIC BUYER (a contracting body) in Spain, France or Romania — 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. Romania: the competition score only, on TED awards above the EU thresholds from November 2023. A score is a prompt to look, not a finding of wrongdoing.
procurement_buyers7 of 7 parameters describedList scored public buyers (contracting bodies) in Spain, France or Romania 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).
procurement_relationship3 of 3 parameters describedHow dependent a public buyer and one of its five largest suppliers are on each other (Spain, France or Romania, 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).
sanctions_watch2 of 3 parameters describedAdd 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.
sanctions_unwatch1 of 1 parameter describedRemove one of your sanctions watchlist entries by id (from sanctions_watchlist).
company_by_identifier4 of 4 parameters describedFind 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.
companies_lookup2 of 2 parameters describedResolve 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).
sanctions_screen_batch7 of 7 parameters describedScreen 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).
insolvency_check2 of 2 parameters describedCheck 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).
insolvency_record1 of 1 parameter describedFetch a single insolvency / risk notice by Prometiam internal ID, with related corporate events. Get an ID from insolvency_search.
coverageno parametersReturns 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?".
accountno parametersReturns 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?".
vat_validate1 of 1 parameter describedValidate 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.
einvoicing_check5 of 5 parameters describedCheck an e-invoicing reference, or give the e-invoicing identifiers of a company. Two modes. (1) type and reference: an OFFLINE check of one reference, such as a party identifier (a VAT or tax number), a routing code (de_leitweg_id, it_sdi_code) or an invoice identifier (pl_ksef_number, br_nfe_key). The answer says whether it is well formed: basis check_digit means it has the form its publisher defines and its check characters match; basis format means only the form was checked; parts decodes a structured value as written in it. Neither basis means the reference was issued, is registered or active, or that a tax authority accepts an invoice that carries it; no live status from a national tax authority is served. type peppol_id also looks the participant up live in the Peppol network (registered at the time of the check; registered does not mean it receives invoices: receives_invoices, receives_credit_notes and document_types come from its SMP, and where the SMP is not read, for example when its robots.txt disallows it, they are null and document_types_unread says why). (2) country and company_number, or vat: for a company the API serves, its own e-invoicing identifiers (party_ids), its Peppol participant IDs looked up live (only those its company number and VAT number give: a company not found under them may be registered under another ID or receive e-invoices outside Peppol; the Peppol Directory is not read), and for Estonia the e-invoice recipients register (Contains data from the Estonian e-Business Register (RIK), CC BY 4.0). Prometiam is not a Peppol access point: it does not send, receive or validate invoices. 1 credit a call, errors free. The full list of types, by country, is on https://www.prometiam.com/risk-api/docs#einvoicing-check.
lei_lookup1 of 1 parameter describedLook 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, and the ISINs GLEIF links to the LEI (identifiers.isin, at most 100, with isin_count; CC0). Use to validate or enrich a counterparty that publishes an LEI.
lei_search2 of 2 parameters describedSearch 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.
lei_relationships1 of 1 parameter describedGLEIF 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).
monitor_listno parametersList 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, SI, MT, 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/SI/MT/EC/IT/IN/AT/GR/LU/HU/PT/US, corporate events to a webhook. On request (events: lei_lapsed) it also alerts when the LEI of a company goes from renewed to LAPSED: an unpaid renewal, not a sign of distress. On request too (events: financial_flag, Scale plan and above, for GB, RO, FR, SE, NO, DK, EE, LV, LT and FI) it alerts when a warning flag of the latest annual accounts turns on: an indicator, never a rating.
monitor_get1 of 1 parameter describedGet one monitored company by its monitor ID, including its alert history (events/status/sanctions matches, new public-contract awards and public grants detected since subscription).
monitor_subscribe5 of 5 parameters describedSubscribe 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/SI/MT/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, Chile, South Korea, New Caledonia, Peru, Honduras and Guatemala. 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). Two more alert types, contract_awarded and grant_received, are opt-in and sent only when listed in events: contract_awarded is a public-contract award newly published with the company as supplier (the monitored countries of procurement_awards: not France or Chile), dated by the award date the buyer published, else the day it was first seen (detail.date_basis award_date or first_seen), with buyer, amount awarded (not a payment), currency and source; Spanish contracts published only on a regional platform (Catalonia, the Basque Country, Navarre, Madrid, Andalusia, Galicia, La Rioja) are not covered. grant_received is a public grant newly published for the company (Spain only, legal entities, concessions from 26 Sep 2026), dated by the concession date; a grant registered late is alerted late, and a grant is never a risk. This creates a persistent subscription, active until it is stopped with monitor_stop.
monitor_stop1 of 1 parameter describedStop monitoring a company and delete its subscription by monitor ID. This is irreversible — the alert history is removed.
sanctions_changes4 of 4 parameters describedList 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.
sanctions_watchlistno parametersReturn 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.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.