Sign up

Guide · Getting started

Free company data API for the multi-country (14-day trial)

One REST key, 500 credits over 14 days, card required, nothing charged for 14 days. Company search and full company detail across every registry the API covers — plus VIES VAT validation and LEI lookup. Here's exactly what's free, what isn't, and how to make your first call in under 60 seconds.

Updated 28 October 2026

Why a 14-day free trial exists

Most company-data providers gate everything behind a sales call and an annual contract (€3K+/year is typical for Creditsafe- or Iberinform-grade output). That's a bad fit if you're a developer who just wants to prototype a KYB flow, enrich a CRM, or check whether a registry number resolves to a real company. Prometiam's 14-day free trial removes the contract and charges nothing for 14 days (a card is required) so you can build against real registry data on day one — and only pay when you actually need volume or compliance-grade screening.

What's in the 14-day free trial

The free trial (500 credits over 14 days, card required, nothing charged for 14 days) gives you the core company-data surface across all live countries on a single key:

  • Company search — GET /companies/search?name= — ILIKE + trigram fuzzy match across every registry the API covers.
  • Full company detail — GET /companies/{id} — legal name, legal form, registered address, capital, status, officers (ES, FR, GB, NO and PL), and the corporate-event timeline (ES, FR and GB, plus register-change events for IE, PL and NO (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, AR, UA, RS, EC, NL and US). The UK adds PSC beneficial owners.
  • VIES VAT validation — GET /vat — live checks against the EU VIES service for all 27 member states.
  • GLEIF LEI lookup + search — GET /lei, GET /lei/search — legal entities by LEI or name.
  • Coverage + account — GET /coverage and GET /account to check freshness per country and your remaining quota.

Honest scope: Ireland, Poland, Finland, Sweden, Belgium, Croatia, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus, Romania, Lithuania, Canada, Australia, Japan, Israel, Singapore, Colombia, Taiwan, Germany, Ukraine, Serbia, Ecuador, Chile, Mexico, the Netherlands, Brazil and the United States are company records only (no directors or UBO). Real beneficial-owner data is UK PSC only. The corporate-event timeline is ES, FR and GB only; every other registry returns no corporate events.

What's not free

We'd rather be blunt than have you hit a wall mid-build. These need a paid tier:

  • Full sanctions + US export-control screening — the complete GET /sanctions/screen surface (beta; EU, UN, OFAC, UK, Australia (DFAT), French gels, and the US Consolidated Screening List / BIS Entity List) is Professional (€29.99/mo).
  • Ongoing monitoring webhooks — /monitor subscribe-and-get-pushed on company events, status changes, and sanctions hits works in the trial for 3 companies; Starter (€9.99/mo) monitors 25. Monitoring covers every live country except France and Chile.
  • Higher credit volume — Free is 500 credits over 14 days. Starter 1,000 credits a month, Professional 10,000, Scale 50,000, Enterprise custom.

Everything else — search, detail, VAT, LEI — is included in the free 14-day trial.

Quick-start: key to first call in under 60 seconds

Two steps.

  1. Get a key. Go to prometiam.com/signup, sign up and add a card (nothing is charged for 14 days), and copy your rk_live_… key from the dashboard.
  2. Call the API. Set the key as a Bearer token and hit /companies/search.

curl

# search for a company by name (14-day free trial)
curl -s "https://api.prometiam.com/functions/v1/risk-api/companies/search?name=telefonica&country=ES" \
  -H "Authorization: Bearer $PROMETIAM_API_KEY" | jq '.data[0]'

# then pull the full detail record by id
curl -s "https://api.prometiam.com/functions/v1/risk-api/companies/812044" \
  -H "Authorization: Bearer $PROMETIAM_API_KEY" | jq '.data'

Python

# quickstart.py — first calls on the 14-day free trial
import os, requests

API  = 'https://api.prometiam.com/functions/v1/risk-api'
HEAD = {'Authorization': f'Bearer {os.environ["PROMETIAM_API_KEY"]}'}

# 1) search by name across any of the live countries
r = requests.get(f'{API}/companies/search',
                 params={'name': 'telefonica', 'country': 'ES'},
                 headers=HEAD).json()
company = r['data'][0]
print(company['company_name'], '→ id', company['id'])

# 2) full detail
detail = requests.get(f'{API}/companies/{company["id"]}', headers=HEAD).json()['data']
print(detail['legal_form'], detail.get('address'))

# 3) validate an EU VAT number (VIES, 27 states)
vat = requests.get(f'{API}/vat', params={'country': 'ES', 'number': 'A28015865'}, headers=HEAD).json()
print('VAT valid:', vat['data']['valid'])

# 4) look up a legal entity's LEI
lei = requests.get(f'{API}/lei/search', params={'name': 'telefonica'}, headers=HEAD).json()
print('LEI:', lei['data'][0]['lei'])

Export your key first: export PROMETIAM_API_KEY=rk_live_…

What a search result looks like

{
  "data": [
    {
      "id": 812044,
      "country": "ES",
      "company_number": "A28015865",
      "company_name": "TELEFONICA, S.A.",
      "legal_form": "SA",
      "region": "MADRID",
      "status": "active"
    }
  ],
  "meta": { "count": 1, "tier": "free", "calls_remaining": 999 }
}

Every response carries a meta block with your tier and remaining quota, so you can back off gracefully before you hit the monthly cap.

Coverage at a glance

  • Spain — BORME. Directors, capital, corporate-event timeline.
  • France — BODACC. Directors, corporate-event timeline.
  • UK — Companies House. Directors, PSC beneficial owners, corporate-event timeline.
  • Ireland — CRO. Company-level only.
  • Poland — KRS. Company-level only.
  • Norway — Brønnøysundregistrene (Enhetsregisteret). Officers and directors, NACE industry code, employee counts, share capital. No corporate-event timeline.
  • Finland — Kaupparekisteri (PRH/YTJ). Company records only: no officers; register-change events and monitoring; insolvency notices linked by business ID.
  • Sweden — Bolagsverket. Company records only: no officers; register-change events, monitoring and insolvency notices linked by organisationsnummer; sole traders are never served.
  • Belgium — KBO/BCE, the Crossroads Bank for Enterprises. Company records only: no officers and no insolvency notices; register-change events and monitoring; enterprises of natural persons are never served.
  • Croatia — Sudski registar. Company records only: no officers; register-change events, monitoring and insolvency notices linked by MBS; sole traders are never served.
  • Denmark — CVR, the Danish Central Business Register. Company records only: no officers; register-change events, monitoring and insolvency notices linked by CVR number; sole proprietorships and estates are never served.

All data is hosted in the EU (Frankfurt), and the registries refresh daily. Call /coverage for the exact latest-filing date per country.

Common questions before you build

  • Rate limits. Free is 500 credits over 14 days and 10 requests/minute. Error responses (4xx) don't count against your quota. If you're batch-enriching, cache /companies/{id} for 24 hours.
  • One key, all countries. Pass country=ES|FR|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|AR|UA|RS|EC|NL|CL|NL|MX to scope a search, or omit it to search across all live countries.
  • Identifiers. Search by name on the 14-day free trial; for exact-match lookups pass a national identifier (Spanish NIF, French SIREN, UK company number) — see the guides below.
  • No data resale. The 14-day free trial is for building and evaluating. Bulk redistribution needs an Enterprise agreement.

FAQ

Is the API really free?
Yes — 14 days, 500 credits, card required, nothing charged for 14 days. Search, detail, VAT, and LEI are all included.

What's not free?
Full sanctions screening (beta; Professional, €29.99/mo), monitoring of more than 3 companies (Starter, €9.99/mo, 25 companies), and higher call volume.

Which countries?
Spain, France, the UK, 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, Argentina, Ukraine, Serbia, Ecuador, Chile, Mexico, the Netherlands, Brazil and the United States — one key. Ireland, Poland, Finland, Sweden, Belgium, Croatia, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus, Romania, Lithuania, Canada, Australia, Japan, Israel, Singapore, Colombia, Taiwan, Germany, Ukraine, Serbia, Ecuador, Chile, Mexico, the Netherlands, Brazil, Argentina and the United States are company-level only; Norway ships officers but no corporate events; the UK adds real PSC beneficial owners.

Do I need a card?
Yes, a card is required to start the trial, and nothing is charged during the 14 days. It then becomes Starter (€9.99 a month) unless you cancel before it ends, in one click from the dashboard; there is one trial per customer and per card. To try the data without a card, use the Try it demo key in the docs, the MCP server in demo mode or the free lookup tools.

Where is the data hosted?
Hosted in the EU (Frankfurt), GDPR-aligned.

Related

Frequently asked questions

Is the company data API really free?
Yes. The free trial is 500 credits over 14 days, with a card required and nothing charged for 14 days. It covers company search and full company detail across every registry the API covers, plus VIES VAT validation and GLEIF LEI lookup.
What is NOT included in the 14-day free trial?
Full sanctions and US export-control screening (beta) requires the Professional tier (€29.99/mo). Monitoring webhooks work in the trial for up to 3 companies; Starter (€9.99/mo) monitors 25, Professional 250 and Scale 2,500. Higher credit allowances are also paid: Starter is 1,000 credits/month, Professional 10,000, Scale 50,000.
Which countries does the 14-day free trial cover?
All live countries on one key: Spain (BORME), France (BODACC), the UK (Companies House, with PSC beneficial owners), Ireland (CRO), Poland (KRS), Norway (Brønnøysundregistrene, with officers), Finland (PRH/YTJ), Sweden (Bolagsverket), Belgium (KBO/BCE), Croatia (Sudski registar), Denmark (CVR), Estonia (e-Business Register), Slovakia (RPO), Switzerland (Zefix), Latvia (Register of Enterprises), Cyprus (DRCOR) and Romania (ONRC) and the United States. Ireland, Poland, Finland, Sweden, Belgium, Croatia, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus, Romania, Lithuania, Canada, Australia, Japan, Israel, Singapore, Colombia, Taiwan, Germany, Ukraine, Serbia, Ecuador, Chile, Mexico, the Netherlands, Brazil and the United States are company records only.
Do I need a credit card to sign up?
Yes, to start the trial: sign up, add a card, get an rk_live_ key instantly and start calling. Nothing is charged during the 14 days, and the trial becomes Starter (EUR 9.99 a month) unless you cancel before it ends, in one click from the dashboard. To try the data without a card, use the Try it demo key in the docs, the MCP server in demo mode or the free lookup tools.