Prometiam API documentation

REST API for official company data in Spain, France, the United Kingdom, Ireland, Poland, Norway, Finland, Sweden, Croatia, Belgium, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus, Romania, Lithuania, Canada, Australia, Japan, Israel, Brazil, Colombia, Singapore, Taiwan, the Czech Republic, Germany (LEI-registered entities and energy-market register companies), Argentina, Ukraine, Serbia, Ecuador, Chile, Mexico (LEI-registered entities and the INEGI DENUE directory), the Netherlands (LEI-registered entities with a KVK number) and the United States (the New York, Colorado, Connecticut, Pennsylvania, Florida, Iowa, the District of Columbia, Texas and Oregon registers, the Massachusetts public-record extract of the Corporations Division, SEC filers and LEI holders). Base URL: https://api.prometiam.com/functions/v1/risk-api

Topic guides: Quickstart · Authentication · Company search · Monitoring and webhooks · Rate limits, credits and errors · Identifiers by country · Testing and demo data

Recipes: French insolvency by SIREN · Spanish company by NIF with its BORME events · Daily events feed for a country · Companies that share a director · Monitor a supplier with a webhook · Verify a customer list in one batch · VAT number to company record · Screen a name against sanctions lists (beta)

Quickstart

Base URL: https://api.prometiam.com/functions/v1/risk-api. Header: Authorization: Bearer <key> (keys start rk_live_). To try it without signing up, use the public demo key rk_live_demo_publichn (shared, 30 calls a minute and 1,000 a day; company search, records, VAT, LEI, insolvency and coverage only). Your own key: the 14-day free trial at https://www.prometiam.com/signup (500 credits, card required, nothing charged for 14 days).

1. Search a company by name:

curl "https://api.prometiam.com/functions/v1/risk-api/companies/search?name=inditex&country=ES&limit=1" -H "Authorization: Bearer rk_live_demo_publichn"

2. The response (excerpt, recorded 24 Oct 2026): the payload is in data, lists add pagination and meta, and a company has the same keys in every country, null where the register publishes no value.

{
  "data": [{
    "id": 1741526, "match_score": 100, "country": "ES", "company_number": "A15075062",
    "company_name": "INDUSTRIA DE DISEÑO TEXTIL, S.A",
    "identifiers": [{ "type": "nif", "value": "A15075062" }, { "type": "vat", "value": "ESA15075062" }],
    "vat_number": "ESA15075062", "lei": "549300TTCXZOGZM2EY83", "legal_form": "SA",
    "status": "active", "founding_date": "1985-06-12", "city": "ARTEIXO"
  }],
  "pagination": { "count": 1, "has_more": true, "next_cursor": "o:1" },
  "meta": { "search_mode": "name", "country": "ES" }
}

3. Look up by register number: GET /companies/search?country=XX&company_number=ID for any live country (the number as the register prints it), or GET /companies/by-identifier?type=vat&value=ESA15075062 with a VAT number or an LEI and no country (1 credit).

4. Costs: a successful call costs credits (1 for a company search or record, 2 for people, events, insolvency and procurement, 3 per name screened, 25 for one company's financial statements; account, coverage and monitoring management are free); errors cost nothing. The call's cost is in the X-Credits-Cost header.

5. Errors: 401 unauthorized (key missing, malformed or revoked), 403 upgrade_required (the call needs a plan that includes it; the body names the plan and the price), 429 rate_limit_exceeded (wait the Retry-After seconds).

From an AI assistant, with no key: npx -y prometiam-risk-mcp, or in Claude Desktop and Cursor {"mcpServers":{"prometiam-risk":{"command":"npx","args":["-y","prometiam-risk-mcp"]}}}. Hosted endpoint (no install): the same tools over Streamable HTTP at https://api.prometiam.com/functions/v1/mcp (your key in Authorization: Bearer rk_live_..., demo mode without one; each tool call is one API request, priced in credits; claude.ai and ChatGPT connectors: add https://api.prometiam.com/functions/v1/mcp/connect and sign in with your Prometiam account; a connection lasts 30 days). More at https://www.prometiam.com/mcp and https://www.prometiam.com/mcp.md; short index for assistants: https://www.prometiam.com/llms.txt.

Authentication

Every request needs a bearer API key: Authorization: Bearer rk_live_.... Keys are created at https://www.prometiam.com/signup (free trial: 500 credits over 14 days, card required, nothing charged for 14 days). Most read endpoints accept ?country=ES|FR|GB|IE|PL|NO|FI|SE|HR|BE|DK|EE|SK|CH|LV|CY|RO|US|LT|CA|AU|JP|IL|BR|CO|SG|TW|CZ|DE|NL|IT|IN|AT|GR; the default is ES.

Endpoints

Companies

  • GET /companies/search — Search companies by name or identifier
  • GET /companies/{id} — Get company by ID
  • GET /companies/{country}/{company_number} — Get company by its register number (NIF, SIREN, CRN, KRS, CVR, ...)
  • GET /companies/by-identifier — Find one company by VAT number, LEI or company number, the country worked out for you
  • POST /companies/lookup — Resolve up to 100 companies in one call

Sanctions screening (beta)

  • GET /sanctions/screen — Screen a name against sanctions lists
  • POST /sanctions/screen — Screen up to 50 names in one call
  • GET /sanctions/entity/{id} — Get sanctions entity detail
  • GET /sanctions/watchlist — Your sanctions watchlists and recent hits
  • POST /sanctions/watchlist — Add a name to your sanctions watchlist
  • DELETE /sanctions/watchlist/{id} — Remove a watchlist entry
  • GET /sanctions/changes — Sanctions list change feed

Insolvency (corporate only, sixteen markets)

  • GET /insolvency/search — Search cross-border corporate insolvency notices
  • POST /insolvency/check — Check up to 100 counterparties for corporate insolvency notices

People & networks

  • GET /people/search — Search people by name
  • GET /people/{id} — Get person by ID
  • GET /directors/network — Director network graph

Company events

  • GET /company-events/search — Search corporate events, or a country's event feed
  • GET /company-events/timeline — Corporate event timeline
  • GET /company-events/records/{id} — Get corporate event by ID

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, NL, AR, UA, RS, EC, US)

  • GET /monitor — List monitored companies
  • POST /monitor — Subscribe a company to monitoring
  • GET /monitor/{id} — Get a monitor + alert history
  • DELETE /monitor/{id} — Stop monitoring a company

VAT & LEI

  • GET /vat/{vatNumber} — Validate an EU VAT number (VIES)
  • GET /lei/{lei} — Look up a Legal Entity Identifier (GLEIF)
  • GET /lei/{lei}/relationships — GLEIF Level 2 ownership (who owns whom)
  • GET /lei/search — Search the GLEIF LEI register by name

Public procurement

  • GET /procurement/awards — List public-procurement awards (ES, FR, GB, IE, PL, NO)
  • GET /procurement/buyer/{id} — Public-buyer risk profile (beta, ES + FR)
  • GET /procurement/buyers — List scored public buyers by risk (beta, ES + FR)
  • GET /procurement/relationship — Buyer-supplier relationship (beta, ES + FR)

Spanish gazette (BORME)

  • GET /search — Search Spanish registry risk notices
  • GET /records/{id} — Get a registry risk notice by ID

Account

  • GET /coverage — Dataset coverage statistics
  • GET /account — Account info and usage

Errors and limits

Errors return a JSON body of the shape {"error":{"code":"...","message":"...","status":N}}. 401 means a missing, malformed or revoked key; 403 means the key lacks the scope for that endpoint; 429 means a rate or quota limit was hit. Rate limits by plan are 10, 60, 120 and 300 requests per minute. Monthly quotas are credits: a successful call costs credits (1 for a company record, see the cost table in Rate limits & quotas), responses with an error cost nothing, and each response carries its cost in the X-Credits-Cost header.

Finland

Look up a Finnish company with GET /companies/search?company_number=0112038-9&country=FI (a Y-tunnus; the hyphen is optional and the check digit is verified) or vat=FI01120389. GET /companies/{id}?include=insolvency returns the linked insolvency notices. Company records from the Finnish Trade Register: legal name, legal form, status, registered address, activity code and dates; with register-change events and monitoring, but no officers and no registry-compliance signal. Corporate insolvency notices are linked by business ID.

Sweden

Look up a Swedish company with GET /companies/search?company_number=556012-5790&country=SE (an organisationsnummer; the hyphen is optional and the check digit is verified) or vat=SE556012579001. Company records from the Swedish Companies Registration Office (Bolagsverket): legal name, legal form, status, registered address, activity code and dates; with register-change events and monitoring, but no officers and no registry-compliance signal (corporate insolvency notices are linked by organisationsnummer), and sole traders (enskild näringsverksamhet) are never served. Sweden is updated weekly. Contains data from Bolagsverket (the Swedish Companies Registration Office) and Statistics Sweden (SCB).

Croatia

Look up a Croatian company with GET /companies/search?company_number=080000604&country=HR (an MBS; a dropped leading zero is restored and the check digit is advisory), oib=27759560625 (an OIB; the check digit is verified) or vat=HR27759560625 (HR plus the OIB). Company records from the Croatian court register (Sudski registar): legal name, legal form, status, registered address, activity code and dates; with register-change events and monitoring, but no officers and no registry-compliance signal (corporate insolvency notices are linked by MBS), and sole traders (trgovac pojedinac) are never served. Croatia is updated every working day. Izvor: Sudski registar, Ministarstvo pravosuđa, uprave i digitalne transformacije (Otvorena dozvola).

Belgium

Look up a Belgian company with GET /companies/search?company_number=0417.497.106&country=BE (an enterprise number; the dots and spaces are optional and the check digits are verified) or vat=BE0417497106 (BE plus the ten digits). Company records from the Crossroads Bank for Enterprises (KBO/BCE): legal name, legal form, status, registered address, activity code and dates; with register-change events and monitoring, but no officers, no registry-compliance signal and no insolvency notices (a bankruptcy shows in the company status and in the register-change events), and enterprises of natural persons (eenmanszaak / entreprise individuelle) are never served. Belgium is updated every working day. Contains data from the Crossroads Bank for Enterprises (KBO/BCE), FPS Economy; see data_as_of for the date of the update.

Denmark

Look up a Danish company with GET /companies/search?company_number=24256790&country=DK (a CVR number; spaces and hyphens are optional, the eight-digit format is validated and the mod-11 check is advisory, so a mismatch is not an error) or vat=DK24256790 (DK plus the eight digits). Company records from the Danish Central Business Register (CVR): legal name, legal form, status (including the register's bankruptcy state), registered address, activity code and dates; with register-change events and monitoring, but no officers, no registry-compliance signal and no share capital (corporate insolvency notices are linked by CVR number), and sole proprietorships (enkeltmandsvirksomhed) and estates are never served. Denmark is updated every working day. Contains data from Det Centrale Virksomhedsregister (CVR), CC BY 4.0. Contains CVR data (Erhvervsstyrelsen), CC BY 4.0

Machine-readable specification: https://www.prometiam.com/openapi.json — Postman collection: https://www.prometiam.com/prometiam.postman_collection.json (37 requests covering every endpoint; set the api_key variable and send) — run it without downloading: https://app.getpostman.com/run-collection/56913391-c22df6ad-ad87-43cf-b3a3-0bddb12bebf7

5. Costs and limits

StatusCodeMeaning
401unauthorizedThe key is missing, malformed or revoked.
403upgrade_requiredThe call needs a plan that includes it; the body names the plan and the price.
429rate_limit_exceededPer-minute or daily limit; wait the Retry-After seconds.

Errors

Status Code Description
400validation_errorMissing or invalid parameters (e.g. no search term, invalid country)
401unauthorizedMissing, invalid, or expired API key
403forbiddenKey has no access to the requested country
403upgrade_requiredThe scope is not in your plan, or your free trial allowance for it is used up. The body names the plan that includes it (included_in), its price, upgrade_url and, when relevant, trial_allowance. Trial keys get 25 calls a month on each of sanctions screening, people search and company events; allowed calls carry meta.trial_allowance with used, limit and resets_on
404not_foundRecord or endpoint not found
429rate_limit_exceededPer-minute (requests) or daily (credits) limit exceeded — check Retry-After header (seconds)
429quota_exceededMonthly credits exhausted (incl. 10% paid-tier grace) — resets at month start; upgrade or contact support
409idempotency_key_in_progressA request with this Idempotency-Key (batch endpoints only) is still running — see Retry-After
422idempotency_key_reuseThis Idempotency-Key was already used with a different request body — use a new key
500internal_errorServer error — safe to retry with exponential backoff

Rate limits &amp; quotas

Tier Credits/month Requests/min Credits/day (fair use) Watchlists Price
Free500 over the 14-day trial10200—EUR 0, 14-day trial
Starter1,000601,00010EUR 9.99/mo
Professional10,00012010,000100EUR 29.99/mo
Scale50,00030050,0001,000EUR 99.99/mo
EnterpriseCustomCustomCustomCustomContact sales

Query Parameters

Parameter Type Required Description
idinteger (path)yesCompany id as returned by /companies/search
countrystringnoCountry code; inferred from the id when omitted
yearsintegernoFiscal years to return, 1-10, default 3, most recent first
statement_typestringnoindividual, consolidated or all (default)
currencystringnonative (filing currency only), eur (euro only) or both (default)
includestringnolines adds balance_sheet and income_statement: every mapped line, with keys such as total_assets, cash, share_capital, revenue, cost_of_sales
include_supersededbooleannotrue also returns statements replaced by a later or amended filing, flagged superseded: true. Default false

Query Parameters

Parameter Type Required Description
namestringyesName to screen (person, company, or vessel)
thresholdintegernoMinimum match score 30–100, default 80. Lower it (50–60) to catch typos and spelling variants
liststringnoComma-separated list filter: EU, OFAC, UN, OFSI (the UK Sanctions List, published by the FCDO), FR_GELS, DFAT (the Australian DFAT Consolidated List), NL_TERROR (the Dutch national terrorism list), JP_MOF (Japan, Ministry of Finance), NZ_MFAT (New Zealand, Russia Sanctions Register), PL_MSWIA (Poland, MSWiA), MC_GEL (Monaco, Direction du Budget et du Trésor),DHS_UFLPA, FINCEN_311, STATE_FTO, STATE_TEL and DOD_1260H (US government lists)
entity_typestringnoperson, company, vessel, aircraft, unknown or any (no filter, the default); entity is an alias of company; anything else is a 400
dobdatenoDisambiguator (YYYY-MM-DD). Excludes entities with a different known date of birth; entities with unknown DOB are never excluded
countrystringnoDisambiguator. Matches against listed country/nationality; entities with unknown country are never excluded
active_onlybooleannoDefault true. Set false to include delisted entities
include_pepbooleannoSet true to also screen against politically exposed persons. Results come back in a separate pep block so they never mix with sanctions hits — see the note below
pep_min_tierstringnonational, regional or local — only return PEP hits at or above that tier. Omit it and you get every hit, including people with no recorded office
groupstringnoSet entity to fold hits into one row per listed person or company, with a sources array carrying each listing (OFSI, OFAC, EU, UN…) and a lists summary. The default keeps one row per listing; meta.distinct_entities is reported either way
limitintegerno1–100, default 20

Query Parameters

Parameter Type Required Description
sincedatenoYYYY-MM-DD or ISO timestamp, default 30 days ago
liststringnoComma-separated list filter
change_typestringnolisted, delisted, relisted, renamed, or bulk: one event per list summarising a mass change held back for review (no entity, entity_name reads "<n> entries of <LIST>", never a watchlist hit)
limitintegerno1–500, default 100

Query Parameters

Parameter Type Required Description
countrystringyesOne of FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV, EE, SG
namestringnoCompany name (fuzzy match)
company_numberstringnoRegistry number as printed on the notice, exact match (SIREN for FR, Companies House number for GB, org number for NO). A German HRA/HRB number is only unique within its register court, so DE notices carry it with the court (HRB12653/FRANKFURT-AM-MAIN): send HRB 12653 Frankfurt am Main (or the court first, or with Amtsgericht) to select one court; HRB 12653 alone matches every court and meta.register_courts lists them. Pair with country
limitintegerno1–100, default 20
cursorstringnoPagination cursor from the previous response

Query Parameters

Parameter Type Required Description
namestringyesPerson name (normalised pattern match). Minimum 2 characters
countrystringnoES (default), FR, GB, or NO. IE, PL, FI, SE, HR, BE, DK, EE, SK, CH, LV, CY, RO, US, LT, CA, AU, JP, IL, BR, CO, SG, TW and CZ are company-level and return no people
limitintegerno1–100, default 20
cursorstringnoPagination cursor from previous response

Query Parameters

Parameter Type Required Description
company_numberstringone of twoRegistry registration number (exact match, recommended)
company_namestringone of twoCompany name (normalised pattern match)
limitintegerno1–200, default 50
includestringnonotice attaches to each event the publication behind it as notice (id, source: BORME, BODACC or Companies House, published_date, reference, type, court, region, url), or null for events of the other countries, which have no notice

Path Parameter

Parameter Type Required Description
vatNumberstringyesFull VAT number including the 2-letter country prefix, e.g. IE6388047V or DE811569869. Spaces and punctuation are ignored.

GET /procurement/buyers — list by score

Parameter Type Required Description
countrystringnoES (default) or FR
modelstringnocompetition (default) or counterparty — the score that orders the list
min_scoreintegerno1–10, keep buyers at or above this score
namestringnoBuyer name, matched anywhere (min 3 characters)
regionstringnoRegion name, matched anywhere
limitintegerno1–100, default 20
cursorstringnoKeyset cursor from pagination.next_cursor (score_id)

Frequently asked questions

What is the Prometiam Company Data API?
A commercial REST API that unifies multi-country company registry data — Spain (BORME), France (BODACC), the United Kingdom (Companies House), Ireland (CRO), Poland (KRS), Norway (Enhetsregisteret), 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 ABR), Japan (National Tax Agency), Israel (Corporations Authority), Brazil (CNPJ), Colombia (RUES), Singapore (ACRA), Taiwan (GCIS), the Czech Republic (public register of the Ministry of Justice, and RES), Germany (LEI-registered entities and energy-market register companies) and the United States (the New York, Colorado, Connecticut, Pennsylvania, Florida, Iowa, the District of Columbia, Texas and Oregon state registers, the Massachusetts public-record extract of the Corporations Division plus SEC EDGAR filers and GLEIF LEI holders from every state) — under one schema, with updates every working day for Finland, Belgium, Denmark, Croatia, Estonia, Slovakia, Switzerland, Latvia, Lithuania, Canada, Japan, Israel, Taiwan, the Czech Republic and Germany, weekly for Sweden, Australia and the United States (Massachusetts: only when the Division supplies a newer extract), monthly for Cyprus, Romania, Singapore, Colombia and Brazil and daily for the other registries (the UK as a monthly bulk plus a daily delta), sanctions and US export-control screening (EU, UN, OFAC, the UK Sanctions List (FCDO), the Australian DFAT Consolidated List, French Registre des gels, plus the US Consolidated Screening List), and corporate-event monitoring. Authentication is a Bearer rk_live_ API key.
Is there a free trial for the Prometiam API?
Yes. The Free trial provides 500 credits over 14 days and includes the search, records, and coverage scopes across all live countries. A card is required and nothing is charged for 14 days; your rk_live_ API key appears in the dashboard once the trial starts.
How much does the Prometiam API cost?
Public tiers: Starter (€9.99/mo, 1,000 credits/month with people, company events, and sanctions monitoring; it begins with a 14-day trial of 500 credits), Professional (€29.99/mo, 10,000 credits/month with full scopes including sanctions screening and 100 watchlists), Scale (€99.99/mo, 50,000 credits/month), and Enterprise (custom). Monthly quotas count successful requests only; paid plans include a 10% overage buffer.
Which countries does the API cover?
Spain (BORME) is fully live with daily updates. France (BODACC), the United Kingdom (Companies House), Ireland (CRO), Poland (KRS), Norway (Enhetsregisteret, from Brønnøysundregistrene), Finland (Kaupparekisteri, the Finnish Trade Register), Sweden (Bolagsverket, the Swedish Companies Registration Office), Croatia (Sudski registar, the Croatian court register), Belgium (KBO/BCE, the Crossroads Bank for Enterprises), Denmark (CVR, the Danish Central Business Register), Estonia (e-Business Register), Slovakia (RPO), Switzerland (Zefix), Latvia (Register of Enterprises), Cyprus (DRCOR), Romania (ONRC), Lithuania (JAR), Canada (Corporations Canada), Australia (ASIC and ABR), Japan (National Tax Agency), Israel (Corporations Authority), Brazil (CNPJ), Colombia (RUES), Singapore (ACRA), Taiwan (GCIS), the Czech Republic (public register of the Ministry of Justice, and RES), Germany (LEI-registered entities and energy-market register companies) and the United States (state registers, SEC EDGAR and GLEIF) are also covered via the same endpoints. The country parameter is ?country=ES, ?country=FR, ?country=GB, ?country=IE, ?country=PL, ?country=NO, ?country=FI, ?country=SE, ?country=HR, ?country=BE, ?country=DK, ?country=EE, ?country=SK, ?country=CH, ?country=LV, ?country=CY, ?country=RO, ?country=LT, ?country=CA, ?country=AU, ?country=JP, ?country=IL, ?country=BR, ?country=CO, ?country=SG, ?country=TW, ?country=CZ, or ?country=US. Spain, France, the UK, Norway, and Poland include officers and directors (Polish natural persons are masked by the register itself and have no person records); Ireland is company-level, Poland adds NIP, REGON, PKD code, and capital, and UBO is not yet included for IE/PL. Norway has no corporate-event gazette, so the company-event endpoints return nothing for NO. Finland is company-level: Company records from the Finnish Trade Register: legal name, legal form, status, registered address, activity code and dates; with register-change events and monitoring, but no officers and no registry-compliance signal. Corporate insolvency notices are linked by business ID. Sweden is company-level: Company records from the Swedish Companies Registration Office (Bolagsverket): legal name, legal form, status, registered address, activity code and dates; with register-change events and monitoring, but no officers and no registry-compliance signal (corporate insolvency notices are linked by organisationsnummer), and sole traders (enskild näringsverksamhet) are never served. Croatia is company-level: Company records from the Croatian court register (Sudski registar): legal name, legal form, status, registered address, activity code and dates; with register-change events and monitoring, but no officers and no registry-compliance signal (corporate insolvency notices are linked by MBS), and sole traders (trgovac pojedinac) are never served. Belgium is company-level: Company records from the Crossroads Bank for Enterprises (KBO/BCE): legal name, legal form, status, registered address, activity code and dates; with register-change events and monitoring, but no officers, no registry-compliance signal and no insolvency notices (a bankruptcy shows in the company status and in the register-change events), and enterprises of natural persons (eenmanszaak / entreprise individuelle) are never served. Denmark is company-level: Company records from the Danish Central Business Register (CVR): legal name, legal form, status (including the register's bankruptcy state), registered address, activity code and dates; with register-change events and monitoring, but no officers, no registry-compliance signal and no share capital (corporate insolvency notices are linked by CVR number), and sole proprietorships (enkeltmandsvirksomhed) and estates are never served. Estonia is company-level: Company records from the Estonian e-Business Register (RIK): legal name, legal form, status (including liquidation and bankruptcy), registered address, activity code (EMTAK 2008 or 2025, per company) and dates; with register-change events and monitoring, but no officers and no registry-compliance signal. Its bankruptcy declarations are served as insolvency notices. Sole traders (FIE) are never served, and the VAT number (KMKR) is searchable with `vat=`. Slovakia is company-level: Company records from the Slovak Register of Legal Entities (RPO): legal name, legal form, status (including bankruptcy (konkurz) and restructuring), registered address, activity code (SK NACE Rev. 2.1) and dates; with register-change events and monitoring, but no officers, no registry-compliance signal and no insolvency notices. Commercial legal persons only (no associations, foundations or other non-commercial entities); no VAT number (a `vat` search is refused); sole traders and other natural persons are never served. Romania is company-level: Company records from the National Trade Register Office (ONRC): legal name, legal form, status (including dissolution, liquidation, insolvency, reorganisation, bankruptcy and deregistration), registered address with the county, CAEN activity codes, the J registration number and EUID, and dates; the VAT number is built from the CUI by rule (RO plus the CUI) and the registration is not confirmed; with register-change events and monitoring, but no officers, no registry-compliance signal, no share capital and no insolvency notices. Natural persons and sole traders (PF, PFA, II, IF, AF) are never served. Updated monthly. Cyprus is company-level: Company records from the Department of the Registrar of Companies and Intellectual Property (DRCOR) of the Republic of Cyprus: legal name, legal form, status (including strike-off pending, voluntary and compulsory liquidation and administration), registered address with the district, and dates; with register-change events and monitoring, but no officers, no registry-compliance signal, no activity code, no share capital, no VAT number (a `vat` search is refused) and no insolvency notices. Companies (private, public and limited by guarantee) and overseas companies only; trade names and partnerships are never served. Latvia is company-level: Company records from the Register of Enterprises of the Republic of Latvia: legal name, legal form, status (including liquidation, insolvency and legal protection proceedings), registered address with the region, share capital, previous names and dates; with register-change events and monitoring, but no officers, no registry-compliance signal, no activity code; its Insolvency Register proceedings are served as insolvency notices; individual merchants and other natural persons are never served, and the Latvian VAT number (LV plus the registration number) is searchable with `vat=`. Switzerland is company-level: Company records from Zefix, the Swiss central business name index: legal name, legal form, status (including liquidation), registered address with the canton and business purpose; with register-change events and monitoring, but no officers, no registry-compliance signal and no activity code. Corporate insolvency notices (SHAB) are linked by UID where the notice names it. Commercial-register publications of the Swiss Official Gazette of Commerce (SHAB) are served as gazette events for Swiss legal entities and branches, from publications of 1 January 2024 (new entry, change of name, seat, address, purpose, capital, legal form, auditor, board or signatories, merger, liquidation, bankruptcy, deletion), dated by the publication date, linked by UID, with the SHAB publication as notice_url; the notice text and the names of board members and signatories are never served (a board or signatory change says only that persons changed). The gazette events are a summary derived from the SOGC publications; the publication linked as notice_url is the authoritative text. Legal entities and branches only; sole proprietorships (Einzelunternehmen) and other natural persons are never served, and the UID with its MWST, TVA or IVA suffix is searchable with `vat=`. The United States is company-level: company records from the business registers of New York, Colorado, Connecticut, Pennsylvania, Florida, Iowa, the District of Columbia, Texas, Oregon and Massachusetts (state open data and public records) plus SEC filers (EDGAR) and LEI holders (GLEIF) from every state, Delaware included; not every US company. One record per state registration, domestic or foreign; New York, Pennsylvania, Iowa and Oregon publish active entities only (Florida serves active and inactive entities: profit corporations, limited liability companies, limited partnerships and non-profit corporations, domestic and foreign; the District of Columbia serves every status, a closed one with its reason, and Iowa the home-office address, neither with registered agents or beneficial owners; Texas serves franchise tax taxpayers that hold a Secretary of State file number, from the file of the Comptroller of Public Accounts and not the Secretary of State register, forfeited and closed ones with their status; Oregon serves limited liability companies, business, professional and non-profit corporations, limited partnerships, limited liability partnerships and cooperatives with the principal place of business as address (the mailing address for limited partnerships, which have none), never assumed business names (trade names), business trusts, reserved names or acts of government, and has no registered agents or authorized representatives; Massachusetts serves every status (active, dissolved, revoked, withdrawn, and inactive where no reason is given), domestic and foreign business, professional, benefit and non-profit corporations, limited liability companies, limited partnerships, registered limited liability partnerships, co-operatives and the Chapter 180 and special-statute corporations, from the public-record extract of the Corporations Division (19 Oct 2026; refreshed, with its change events, only when the Division supplies a newer extract), not an official register extract, never trade names (foreign DBAs), voluntary associations, trusts or corporations sole, and has no officers or resident agents); updated weekly; no officers and no registry-compliance signal, with register-change events (dated by the weekly read) and monitoring; no VAT number (a `vat` search is refused); US insolvency notices are on /insolvency/search and are not linked to the company records; sole proprietorships are never served; annual financial statements for SEC filers only. Lithuania is company-level: Company records from the Register of Legal Entities (JAR): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day. Company status includes liquidation, bankruptcy and restructuring; there are no insolvency notices. Activity codes follow NACE Rev. 2.1 (EVRK 2.1, class level; the 6-digit code is in registry_details). Share capital is held for UAB and AB only. VAT numbers come from the State Tax Inspectorate (VMI) list. Sole proprietorships, partnerships (KUB, TUB), branches, state enterprises and non-commercial bodies are never served. Canada is company-level: Company records from Corporations Canada (Innovation, Science and Economic Development Canada): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day. Federal corporations only (Canada Business Corporations Act, Canada Cooperatives Act and the repealed Canada Corporations Act Part I and Cooperative Associations Act); provincial and territorial corporations, not-for-profit corporations and boards of trade are not in the register. There is no insolvency, liquidation or bankruptcy status (that is the Office of the Superintendent of Bankruptcy and the courts), no activity code, share capital or VAT number. The Business Number is searchable with business_number=, and a corporation's other names are in registry_details. Australia is company-level: Company records from the Australian Securities and Investments Commission (ASIC) and the Australian Business Register (ABR): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated weekly. Proprietary, public and foreign companies (ACN and ARBN) only; associations, cooperatives, other bodies, individuals and sole traders are never served. The register gives the state and the postcode, not a street address. ASIC does not separate liquidation from administration, so external administration shows as in_administration and there is no in_liquidation status; there are no insolvency notices. No activity code or share capital. The VAT number is the ABN when the ABN is active and registered for GST; an ABN is searchable with abn= and a GST-registered one with vat=. Data are licensed CC BY 3.0 AU (no sublicensing): the credit and licence link travel with every answer. Japan is company-level: Company records from the National Tax Agency corporate number publication site: legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day, with a monthly full reconciliation. Companies (kabushiki, godo, gomei, goshi and tokurei yugen kaisha) and registered foreign companies only; national and local government bodies, associations and other corporations are never served. Status is active, deregistered or merged (with the successor's number): the register publishes no liquidation or insolvency state and there are no insolvency notices; no founding date, activity code, share capital or VAT number. The registration date is the date the corporate number was assigned and is null for companies that carry only the 5 October 2015 designation. Names are in Japanese; the English name, the kana reading and a romanised name are in registry_details. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). Israel is company-level: Company records from the Israeli Corporations Authority (Ministry of Justice): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day. Israeli and registered foreign companies only; partnerships, cooperative societies, non-profit associations and sole traders are other registers and are not served. Company status includes liquidation, receivership, restructuring and insolvency proceedings; there are no insolvency notices. Names are in Hebrew, with the English name in registry_details where the register holds one. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). No activity code, share capital or VAT number. Brazil is company-level: Company records from the Cadastro Nacional da Pessoa Jurídica (CNPJ), Receita Federal do Brasil: legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated monthly (the Receita publishes one full file a month). Commercial legal persons only: limited companies (LTDA), corporations (S.A.), simple societies, single-member limited companies (EIRELI), public companies and mixed-capital companies, and cooperatives; sole traders (empresário individual, MEI included), non-profit entities, branches of foreign companies and every other natural-person form are never served. One record per CNPJ root, with the head office's 14-character CNPJ (shown 00.000.000/0001-91; the 8-digit root finds it too); branches are not served. Status is active, suspended, inapta (served as active_strike_off_pending), deregistered or merged; judicial recovery, bankruptcy, liquidation and intervention are read from the register's special situation, and there are no insolvency notices. The activity code is CNAE-Subclasses 2.3 (BR-CNAE-2.3), not a NACE code; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; the secondary codes are in registry_details. No VAT number (a vat search is refused), and no partners, officers or contacts. Colombia is company-level: Company records from Confecámaras (RUES, the Colombian chambers of commerce): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated monthly: the source's own update date is data_as_of and is in the credit. Companies of the commercial register only (S.A.S., Ltda., S.A., S. en C., S.C.A., collective companies, single-person companies (E.U.) and branches of foreign companies); natural persons, non-profit entities, cooperatives and public bodies are never served. The register has no address, share capital, contact, activity description or VAT number (a vat search is refused), and no liquidation state: liquidation, judicial liquidation and reorganisation are read from the company name and served as the status, and a cancelled registration is deregistered or merged. The registration may not be current although it reads active: last_renewal_year in registry_details is the last year it was renewed. company_name is the name without those markers and name_as_registered is the name as published. The activity code is the CIIU Rev.4 A.C. 4-digit code (CO-CIIU-REV4-AC), not a NACE code; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. No insolvency notices. The records are offered under CC BY-SA 4.0 (share-alike). Singapore is company-level: Company records from the Accounting and Corporate Regulatory Authority (ACRA): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated monthly. Local companies, limited liability partnerships (LLP) and registered foreign company branches only; sole proprietorships, general partnerships and limited partnerships are never served. Status includes liquidation, judicial management and receivership, and a struck-off, dissolved or amalgamated company is deregistered or merged; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. The register publishes no cessation date, share capital, GST (VAT) number (a vat search is refused), region or officers. The activity code is SSIC 2020 (5 digits, SG-SSIC-2020; a legacy 4-digit code carries no scheme); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. The annual return and accounts-due dates are in registry_details as published. API use of the data is licensed, not a right to the data itself. Taiwan is company-level: Company records from the Ministry of Economic Affairs (GCIS) and the Ministry of Finance (Fiscal Information Agency): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day. Limited companies, companies limited by shares, unlimited companies, limited partnership companies and Taiwan branches of foreign companies only; sole proprietorships, partnerships, domestic branches, cooperatives, associations and representative offices are never served. Names and addresses are in Chinese (the register publishes no English name; the English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). The responsible person is not served. Status includes dissolution, reorganisation, receivership and bankruptcy. The VAT number is the unified business number where the company is in the Ministry of Finance tax file (searchable with vat=), else null. The activity code is the Ministry of Finance tax industry code (6 digits, TW-TAX-SIC), which is not a NACE code, and the other codes of the file are in secondary_activity_codes. The check digit of the number is advisory. No officers; no insolvency notices.
Which company identifiers does the API accept?
Spain: ?vat= (NIF, 9 chars starting with a letter, e.g. A28015865). France: ?siren= (9 digits) or ?siret= (14 digits). United Kingdom: ?company_number= (8 chars; numeric for England & Wales/Scotland; alphabetic prefixes such as SC, NI, OC, LP, FC, OE for special types). Finland: ?company_number= with a Y-tunnus such as 0112038-9 (the hyphen is optional and the check digit is verified), or ?vat= with the Finnish VAT number FI01120389, both with country=FI. Sweden: ?company_number= with an organisationsnummer such as 556012-5790 (the hyphen is optional and the check digit is verified), or ?vat= with the Swedish VAT number SE556012579001, both with country=SE. Croatia: ?company_number= with an MBS such as 080000604 (a dropped leading zero is restored and the check digit is advisory), ?oib= with an OIB such as 27759560625 (the check digit is verified), or ?vat= with the Croatian VAT number HR27759560625, all with country=HR. Belgium: ?company_number= with an enterprise number such as 0417.497.106 (the dots and spaces are optional and the check digits are verified), or ?vat= with the Belgian VAT number BE0417497106, both with country=BE. Denmark: ?company_number= with a CVR number such as 24256790 (eight digits; the mod-11 check is advisory, so a mismatch is not an error), or ?vat= with the Danish VAT number DK24256790, both with country=DK. Estonia: ?company_number= with a registry code such as 10060701 (eight digits, the first being 1, 7, 8 or 9; the check digit is enforced and a wrong one is a 400), or ?vat= with the Estonian VAT number (KMKR) such as EE100354546 where the register publishes it, both with country=EE. Slovakia: ?company_number= with an IČO such as 35763469 (eight digits; the mod-11 check is advisory, so a mismatch is not an error); there is no vat search for Slovakia, because the register carries no VAT number. Switzerland: ?company_number= with a UID such as CHE-103.867.266 (CHE plus nine digits; separators and a MWST, TVA or IVA suffix are optional and the check digit is enforced, so a wrong one is a 400), or ?vat= with the Swiss VAT number, the UID followed by MWST, TVA or IVA, both with country=CH. Latvia: ?company_number= with a registration number such as 40003032949 (11 digits, an LV prefix is optional and the check is enforced, so a wrong one is a 400), or ?vat= with the Latvian VAT number LV40003032949, both with country=LV. Cyprus: ?company_number= with a registration number such as HE165 (HE for a company, AE for an overseas company, bare digits mean HE; there is no check digit); there is no vat search for Cyprus, because the register carries no VAT number. Romania: ?company_number= with a CUI such as 5022670 (2 to 10 digits, an RO prefix is optional, the check digit is advisory), or ?vat= with the Romanian VAT number RO5022670 (built from the CUI by rule), both with country=RO. United States: ?company_number= with a state code and register number such as NY-4424185, CO-20091096973 or DE-10684990, with CIK- and the SEC number such as CIK-0000320193, or with LEI- and the 20-character LEI, all with country=US (the dash is optional and there is no check digit); there is no vat search for the United States, because there is no US VAT number. Lithuania: ?company_number= with a legal entity code such as 110053842 (nine digits, check digit verified), or ?vat= with the Lithuanian VAT number LT100538411, both with country=LT. Canada: ?company_number= with a corporation number such as 426160-7, or ?business_number= with a nine-digit Business Number, both with country=CA; there is no vat search for Canada. Australia: ?company_number= with an ACN or ARBN such as 004 028 077, ?abn= with an ABN such as 49004028077, or ?vat= with the GST number (the ABN), all with country=AU. Japan: ?company_number= with a 13-digit corporate number such as 1180301018771 (check digit verified), with country=JP; there is no vat search for Japan. Israel: ?company_number= with a company number such as 520013954 (nine digits starting 51, 52 or 56; the check digit is advisory), with country=IL; there is no vat search for Israel. Brazil: ?company_number= with a CNPJ such as 33.000.167/0001-01 (or its 8-digit root), with country=BR; there is no vat search for Brazil. Colombia: ?company_number= with a NIT such as 900843898-9, with country=CO; there is no vat search for Colombia. Singapore: ?company_number= with a UEN such as 196800306E, with country=SG; there is no vat search for Singapore. Taiwan: ?company_number= with a unified business number such as 22099131, or ?vat= with the same number, both with country=TW. Czech Republic: ?company_number= with an IČO such as 45274649, with country=CZ; there is no vat search for the Czech Republic.
How fresh is the data?
Spanish (BORME) and French (BODACC) data is updated daily. UK Companies House is updated monthly with daily deltas. Irish (CRO) company data is refreshed daily. Norwegian data is refreshed daily from Brønnøysundregistrene (Enhetsregisteret, open data under the NLOD licence). Finnish, Belgian, Danish, Croatian, Estonian, Slovak, Swiss and Latvian company records are updated every working day; Cypriot and Romanian records monthly; US records (state registers, SEC EDGAR, GLEIF) are updated weekly. Lithuanian, Canadian, Japanese, Israeli, Taiwanese and Czech records are updated every working day, Swedish and Australian records weekly, and Brazilian, Colombian and Singaporean records monthly. The /coverage endpoint returns the latest_filing date per country.
How does authentication work?
Every request requires a Bearer token via the Authorization header: Authorization: Bearer rk_live_your_api_key. Keys are provisioned via the free signup and tied to a tier (rate limits), a list of scopes, and a list of allowed countries.
Where is the data hosted?
In the European Union: accounts, keys and usage in Frankfurt (Supabase), the company data on a dedicated server in Germany (OVHcloud). Payments, e-mail and some support tools use sub-processors outside the EU under the Standard Contractual Clauses; see the sub-processor list at /legal/sub-processors. No SOC 2 or ISO 27001 certification.
How does Prometiam compare to Creditsafe, Iberinform, Pappers, and OpenCorporates?
Prometiam ships a single REST endpoint covering Spain (BORME), France (BODACC), the UK (Companies House), Ireland (CRO), Poland (KRS), Norway (Enhetsregisteret), 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 ABR), Japan (National Tax Agency), Israel (Corporations Authority), Brazil (CNPJ), Colombia (RUES), Singapore (ACRA), Taiwan (GCIS), the Czech Republic (public register of the Ministry of Justice, and RES), Germany (LEI-registered entities and energy-market register companies) and the United States (state registers, SEC EDGAR, GLEIF) with daily updates for Spain, France, Ireland, Poland and Norway, monthly bulk plus daily delta for the UK, every working day for Finland, Belgium, Denmark, Croatia, Estonia, Slovakia, Switzerland, Latvia, Lithuania, Canada, Japan, Israel, Taiwan, the Czech Republic and Germany, weekly for Sweden, Australia and the United States, and monthly for Cyprus, Romania, Singapore, Colombia and Brazil, transparent public pricing from €9.99/month, sanctions and US export-control screening across seven sources (EU, OFAC, UN, UK, Australia DFAT, French gels, plus the US Consolidated Screening List) with daily refresh and scored fuzzy matching, and explainable risk fields. Most competitors fragment by country, hide pricing, or charge much more for comparable coverage.