prometiam-risk-api (Python)

Official Python client for the Prometiam Risk Intelligence API: company registry data for Spain, France, the UK, Ireland, Poland, Norway, Finland, Sweden, Croatia, Belgium, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus, Romania, Lithuania, the Czech Republic, Germany, Canada, Brazil, Argentina, Colombia, Australia, Japan, Singapore, Taiwan, Israel and the United States (state registers, SEC EDGAR, GLEIF): 31 countries, corporate insolvency notices across fifteen markets, sanctions screening, VAT and LEI lookups.

pip install prometiam-risk-api

Quick start

import os
from prometiam_risk_api import Client

api = Client(api_key=os.environ["PROMETIAM_API_KEY"])

page = api.companies_search(name="Inditex", country="ES")   # fuzzy, best match first (match_score 0-100)
first = page["data"][0]
print(first["company_name"], first["company_number"])

detail = api.company(first["id"], include="risk_flags,insolvency")

Every method returns the API envelope {"data": ..., "pagination": ..., "meta": ...} exactly as documented.

Batch calls

One HTTP call for a whole list. Every item counts as one request against your plan limits; a batch that does not fit raises RateLimitError whose max_items_now says how many items would fit.

lookup = api.companies_lookup([
    {"country": "ES", "company_number": "A46103834"},
    {"country": "FR", "siren": "552032534"},
    {"country": "ES", "name": "Inditex"},          # best fuzzy match, with match_score
])
for r in lookup["data"]:
    print(r["status"], (r["company"] or {}).get("company_name"))

screen = api.sanctions_screen_batch(["Vladimir Putin", "Acme Trading Ltd"], group="entity")
flagged = [r for r in screen["data"] if r["status"] == "match"]

distress = api.insolvency_check([
    {"country": "FR", "company_number": "917499519"},
    {"country": "DE", "name": "Wirecard"},
])

Pagination

for page in api.paginate("/people/search", {"name": "garcia", "country": "ES", "limit": 50}):
    for person in page:
        print(person["full_name"])

Errors

Options

Client(api_key, base_url="https://api.prometiam.com/functions/v1/risk-api", timeout=30.0, max_retries=2, transport=None)

Use with Client(...) as api: to close the connection pool, and api.request("GET", "/coverage") for anything not wrapped.

Rate limits

Per-key limits by plan (requests/minute; the daily and monthly figures are credits: every successful call costs credits, 1 for a company record, 2 for events, people and insolvency, 3 for a sanctions screen per name, 25 for a company's financial statements, errors are free; each response carries its cost in X-Credits-Cost):

api.account() returns your key's current limits and usage (rate_limit.rpm_remaining, daily_remaining, monthly_remaining; daily and monthly are credits, rate_limit.unit is credits). A 429 raises RateLimitError, retried automatically up to max_retries honouring Retry-After. Batch calls (companies_lookup, sanctions_screen_batch, insolvency_check) cost every item what the same single call costs against these limits; a batch that would not fit in the remaining credits raises RateLimitError up front (code == "batch_exceeds_quota", max_items_now set).

Scope limits

The API's coverage has real edges — every method above reflects them, not a marketing claim:

• Company registry (companies_search, company, people_search, events_*, directors_network): Spain, France, the UK, Ireland, Poland, Norway, Finland, Sweden, Croatia, Belgium, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus, Romania, Lithuania, the Czech Republic, Germany, Canada, Brazil, Colombia, Australia, Japan, Singapore, Taiwan, Israel, the United States. Ireland is company-level today (no officers yet). Poland has the management and supervisory boards, proxies and the representation rule on the company record (natural persons masked by the register itself, no person records or director network, filled progressively). Finland, Sweden, Croatia, Belgium, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus, Romania, Lithuania, the Czech Republic, Germany, Canada, Brazil, Colombia, Australia, Japan, Singapore, Taiwan, Israel and the United States are company records only (their own bullets below carry the details), with register-change events (name, status, legal form and registered address; share capital for Croatia, Estonia, Slovakia, Switzerland, Latvia, Lithuania, Taiwan, Brazil and the Czech Republic; dated when the change first appears in the register data (for the United States, the weekly read of the registers that first sees it), not gazette notices, none before 2026-09-30) and monitoring, but no officers and no registry-compliance signal. Corporate insolvency notices are linked by business ID (Finland), organisationsnummer (Sweden), MBS (Croatia), CVR number (Denmark) and UID (Switzerland), registration number (Latvia) and registry code (Estonia); Belgium and Slovakia have none (their bankruptcy shows in the company status and in their register-change events). Sole traders (enskild näringsverksamhet, trgovac pojedinac), enterprises of natural persons (eenmanszaak / entreprise individuelle), sole proprietorships (enkeltmandsvirksomhed) and estates are never served. Denmark has no share capital, and its status includes the register's bankruptcy state.
• Financial statements (company_financials(company_id, **params)): annual accounts as filed for GB, FR, DK, SE and NO, FI (statements filed digitally with PRH, about one filer in twenty, and listed groups; Finnish companies also return tax_records) US SEC filers (EDGAR XBRL annual reports, fiscal years from 2023, USD plus euro) and the consolidated reports of listed groups in GB, DK, SE, LV and LT (ESEF, beside the individual accounts; SE to fiscal 2024, LV to 2023), and listed companies only in ES, PL, HR and BE (their ESEF reports); 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, 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. None for IE or for unlisted companies in ES, PL, HR and BE. Outside France digitally filed accounts only; none for French companies that declare their accounts confidential. Scale plan and above; Starter, Professional and free trial keys get 10 calls a month. Contains CVR data (Erhvervsstyrelsen), CC BY 4.0. Contains data from the Finnish Patent and Registration Office (PRH), CC BY 4.0.
• Insolvency (insolvency_search, insolvency_check): corporate only, fifteen markets (FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV, EE). Personal/consumer insolvency is never returned. 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. Contains 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).
• Monitoring (monitors, monitor, monitor_create, monitor_delete): ES, GB, IE, PL, NO, FI, SE, BE, HR, DK, EE, SK, CH, LV, CY, RO, US, LT, CA, AU, JP, IL, SG, CO, TW, BR, CZ, DE, UA; alerts on status changes, dissolutions (on the register's dissolution date or, where it gives none, when the status first shows closed: detail.date_basis is register or first_seen_closed), sanctions matches and corporate events (ES, GB, IE/PL/NO from 14 Oct 2026, and FI/SE/BE/HR/DK/EE/SK/CH/LV/CY/RO/US/LT/CA/AU/JP/IL/SG/CO/TW/BR/CZ/DE/UA).
• Sanctions screening (sanctions_screen*): beta; the EU consolidated list, the UN list, OFAC, the UK Sanctions List, the Australian DFAT Consolidated List and the French national asset-freeze register, plus the US export-control lists.
• PEP hits (sanctions_screen(name, include_pep=True)): beta, Spain only.
• Norway, Ireland and Poland: register-change events only (name, status, legal form, registered address), none before 14 Oct 2026; no gazette (events_* returns an empty list until a change is seen).
• Finland: company records only (people_search returns empty for FI; events_* returns 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) and none before 2026-09-30; monitor_create accepts it). Its insolvency notices are linked by business ID.
• Sweden: company records only (people_search returns empty for SE; events_* returns register-change events; monitor_create accepts it). Corporate insolvency notices (konkurs, företagsrekonstruktion, ackordsförhandling; updated weekly, no court, case number or source link, proceedings that ended before collection not included) are on insolvency, linked by organisationsnummer.
• Croatia: company records only (people_search returns empty for HR; events_* returns register-change events, including share capital; monitor_create accepts it). Corporate insolvency notices (court decisions on bankruptcy, shortened bankruptcy and pre-bankruptcy proceedings, with court and case number where the register states them; only companies still on the register) are linked by MBS. A Croatian company is found by MBS (company_number), OIB (oib) or the VAT alias (vat=HR plus the OIB).
• Belgium: company records only (people_search returns empty for BE; events_* returns register-change events; monitor_create accepts it). Belgium is not one of the fifteen insolvency markets: its bankruptcy shows in the company status and in its register-change events. A Belgian company is found by enterprise number (company_number, the dots and spaces optional) or the VAT alias (vat=BE plus the ten digits).
• Denmark: company records only (people_search returns empty for DK; events_* returns register-change events; monitor_create accepts it). Corporate insolvency notices (konkurs and tvangsakkord from CVR credit information: one notice per proceeding, dated by the decision that opened it, with the latest stage of the proceeding; no court or case number) are linked by CVR number. Contains CVR data (Erhvervsstyrelsen), CC BY 4.0. A Danish company is found by CVR number (company_number, spaces and hyphens optional; the mod-11 check is advisory) or the VAT alias (vat=DK plus the eight digits).
• Estonia: company records only (people_search returns empty for EE; events_* returns register-change events; monitor_create accepts it). Register bankruptcy declarations are served as insolvency notices (linked by registry code; no court, case number or trustee; companies still on the register only); liquidation and bankruptcy also show in the company status. Contains data from the Estonian e-Business Register (RIK), CC BY 4.0. An Estonian company is found by registry code (company_number, eight digits, the check digit is enforced) or the VAT alias (vat=EE plus nine digits, the KMKR number, where the register publishes it). Sole traders (FIE) are never served.
• Slovakia: company records only (people_search returns empty for SK; events_* returns register-change events; monitor_create accepts it). There are no insolvency notices: bankruptcy (konkurz) and restructuring show in the company status. Contains data from the Register of Legal Entities (RPO), Ministry of Interior and Statistical Office of the Slovak Republic, CC BY 4.0. A Slovak company is found by IČO (company_number, eight digits, a six or seven digit number is read with leading zeros; the mod-11 check is advisory); there is no VAT alias, because the register carries no VAT number. Commercial legal persons only: associations, foundations, sole traders and other natural persons are never served.
• Switzerland: company records only (people_search returns empty for CH; events_* returns register-change events; monitor_create accepts it). Corporate insolvency notices (SHAB) are linked by UID where the notice names the debtor's UID; a notice without one stays unlinked. Status includes liquidation. Source: Zefix, Federal Office of Justice, Federal Commercial Registry Office (open use, source required); restructured by Prometiam, not a certified register extract. A Swiss company is found by UID (company_number, CHE plus nine digits; separators and a MWST, TVA or IVA suffix are optional and the check digit is enforced) or by its VAT number (vat, the UID followed by MWST, TVA or IVA). The register publishes no activity code. Legal entities and branches only: sole proprietorships and other natural persons are never served.
• Latvia: company records only (people_search returns empty for LV; events_* returns register-change events; monitor_create accepts it). Insolvency Register proceedings are served as insolvency notices (an opening and a closing notice, linked by registration number); status includes liquidation, insolvency and legal protection. Contains data from the Register of Enterprises of the Republic of Latvia and the State Revenue Service (CC0). A Latvian company is found by registration number (company_number, 11 digits; an LV prefix is optional and the mod-11 check is enforced) or by its VAT number (vat, LV plus the registration number). The register publishes no activity code. Individual merchants and other natural persons are never served.
• Cyprus: company records only (people_search returns empty for CY; events_* returns register-change events; monitor_create accepts it). No insolvency notices; status includes strike-off pending, liquidation and administration. Contains data from the Department of the Registrar of Companies and Intellectual Property (DRCOR), Republic of Cyprus, via data.gov.cy, CC BY 4.0. A Cypriot company is found by registration number (company_number, HE for a company or AE for an overseas company and up to nine digits; bare digits mean HE; no check digit). The register publishes no VAT number (a vat search is refused), no activity code and no share capital. Trade names and partnerships are never served.
• Romania: company records only (people_search returns empty for RO; events_* returns register-change events; monitor_create accepts it). No insolvency notices or share capital; status includes dissolution, liquidation, insolvency, reorganisation and bankruptcy. Contains data from the National Trade Register Office (ONRC), CC BY 4.0. A Romanian company is found by CUI (company_number, 2 to 10 digits; an RO prefix is optional; the check digit is advisory) or by its VAT number (vat, RO plus the CUI, built by rule). Activity codes are CAEN (caen_codes). Natural persons and sole traders are never served. Updated monthly.
• Lithuania: company records only, updated every working day; status includes liquidation, bankruptcy and restructuring (no insolvency notices); activity code NACE Rev. 2.1; share capital for UAB and AB only; sole proprietorships, partnerships, branches and non-commercial bodies are never served.
• Czech Republic: company records only (commercial legal persons of the public register), updated every working day; status includes liquidation, insolvency, bankruptcy and restructuring (no insolvency notices); activity code CZ-NACE 2025; share capital is served; no VAT number; sole traders and other natural persons are never served.
• Canada: federal corporations only, company records only (no activity code, share capital, VAT number, insolvency status or insolvency notices), updated every working day; provincial, territorial and not-for-profit corporations are never served.
• Brazil: company records only (commercial legal persons, one record per CNPJ root with the head office's CNPJ), updated monthly; no officers, partners, contacts or VAT number; the activity code is CNAE, not NACE (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); sole proprietors (MEI included), non-profits and branches are never served.
• Colombia: company records only (companies of the commercial register), updated every working day; no address, share capital or VAT number; liquidation and reorganisation are read from the company name; the activity code is CIIU, not NACE (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 Colombian records are offered under CC BY-SA 4.0.
• Australia: company records only (proprietary, public and foreign companies), updated weekly; the register gives the state and postcode, not a street address; no activity code, share capital or insolvency notices; the VAT number is the ABN while it is registered for GST.
• Japan: company records only, updated every working day; no founding date, activity code, share capital or VAT number; status is active, deregistered or merged; names are in Japanese, with the English and romanised names in the registry details.
• Singapore: company records only (local companies, limited liability partnerships and foreign company branches), updated monthly; no share capital, region or GST number; the activity code is SSIC 2020, not NACE (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); sole proprietorships and partnerships are never served.
• Taiwan: company records only, updated every working day; names and addresses are in Chinese; the activity code is the tax industry code, not NACE; the VAT number is the unified business number where the company is in the tax file; sole proprietorships, partnerships and domestic branches are never served.
• Germany: company records only, German companies that hold a Legal Entity Identifier plus a partial set of energy-market actors; not an extract of the German commercial register and not every German company; no officers, shareholders, share capital, activity code or VAT number (a VAT search is refused); sole traders, civil-law partnerships, associations, foundations, public bodies, funds and branches are never served; updated daily.
• Israel: company records only (Israeli and registered foreign companies), updated every working day; names are in Hebrew, with the English name where the register holds one; no activity code, share capital or VAT number; liquidation and receivership show in the status.
• United States: company records only (people_search returns empty for US; events_* and monitor_create serve it, register-change events dated by the weekly read). The US has no national register: country=US serves the business registers of New York, Colorado, Connecticut, Pennsylvania, Florida, Iowa, the District of Columbia, Texas and Oregon (state open data and public records; Texas is the Comptroller's franchise-tax file, not the Secretary of State register) plus SEC filers (EDGAR) and LEI holders (GLEIF) from every state, Delaware included, as one record per state registration (domestic or foreign), updated weekly. A US company is found by state code and register number (company_number=NY-4424185, CO-20091096973, DE-10684990), by SEC number (CIK-0000320193) or by LEI (LEI- and 20 characters); identifiers also carry cik, ein (SEC filers) and lei. Colorado entities the register marks Delinquent or Noncompliant (a late periodic report) are served as active with local_status delinquent (registry_details.status_code keeps the register's word); New York, Pennsylvania, Iowa and Oregon publish active entities only (the District of Columbia serves every status; Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign), and the SEC gives no legal status. There is no VAT number (a vat search is refused), no officers and no registry-compliance signal; US insolvency notices are not linked to the company records; sole proprietorships are never served; it is not every US company. 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), Oregon Secretary of State, Corporation Division (open data), SEC EDGAR, GLEIF (CC0).

Get a key

14-day free trial at https://www.prometiam.com/signup?utm_source=pypi&utm_medium=readme (a card is required, nothing is charged for 14 days). Docs: https://www.prometiam.com/risk-api/docs?utm_source=pypi&utm_medium=readme. Support: support@prometiam.com.