What data does the Prometiam Risk Intelligence API cover?

Company data across five countries: Spain from the official BORME registry (3.8M+ entities), France from BODACC (12.4M+ entities), the UK from Companies House (7.6M+ entities including 12M+ Persons with Significant Control), Ireland from the CRO (817K+ companies, company-level), and Poland from the KRS (732K+ companies, company-level), plus insolvency notices, sanctions and US export-control screening, and corporate event timelines. Data updates daily from primary sources.

Is the API GDPR-compliant and hosted in the EU?

Yes. All data is hosted in AWS eu-central-1 (Frankfurt, Germany). No data leaves the EU. The platform is GDPR-compliant, ISO 27001 aligned, and operates under EU data residency rules.

How is Prometiam different from Pappers, Societe.com, or Creditsafe?

Prometiam is API-first, EU + UK-native, and transparent: pricing is public (Free, €9.99, €29.99, €99.99, Enterprise), and data covers Spain (BORME), France (BODACC), the UK (Companies House), Ireland (CRO), and Poland (KRS) under one unified schema and a single API key. No per-user seat fees, no 'contact sales' for a quote.

What API endpoints are available?

GET /companies/search, /companies/{id}, /people/{id}, /notices/{id}, /company-events/search, /company-events/timeline, /search (insolvency), /records/{id}, /sanctions/screen, /coverage, and /account. Full docs at https://www.prometiam.com/risk-api/docs

How do I get an API key?

Sign up at https://www.prometiam.com/signup to receive an rk_live_ key. The Free plan includes 1,000 calls/month with no credit card required.

How much does the Prometiam Risk API cost?

Pricing is public and self-serve: Free (1,000 calls/month, no credit card), Starter (€9.99/month, 10,000 calls), Professional (€29.99/month, 100,000 calls with full sanctions screening), Scale (€99.99/month, 1,000,000 calls), and Enterprise (custom). All five countries are included in every tier at no upcharge.

What sanctions lists are screened?

Five consolidated lists in one trigram-fuzzy call with confidence scoring: EU consolidated, UN, US OFAC SDN, UK OFSI, and the French Registre des gels. Refreshed daily, with optional watchlist webhooks on the Professional tier and above.

VIES (VAT Information Exchange System) is the European Commission service that lets you check whether an EU VAT number is valid and, for most member states, returns the registered trader name and address. Prometiam wraps it in a single authenticated REST endpoint.

Which countries does the VAT endpoint cover?

The 27 EU member states plus XI (Northern Ireland). Greece files under the EL prefix, not GR. GB VAT is out of scope post-Brexit — use XI for Northern Ireland businesses.

Does an invalid response mean the VAT does not exist?

Only when is_valid is false with a normal 200 response. If VIES or a member-state register is temporarily down, the API returns 503 upstream_unavailable — that means the VAT was not checked, not that it is invalid. Retry shortly.

Is VAT validation on the free tier?

Yes. /vat is registry-data scope and works on the free tier (1,000 calls/month, no card). Only the sanctions endpoints require a paid plan.

VAT number validation API (VIES) — Python & Node

A short tutorial that validates an EU VAT number against VIES from your own code. Prometiam's GET /vat/{vatNumber} checks the number against the official VIES service across the 27 EU member states plus XI (Northern Ireland), and returns the registered name and address when the number is valid.

What the guide covers

What VIES is — the European Commission's VAT Information Exchange System — and why a single REST call is more robust than talking to VIES SOAP directly (it separates a definitive invalid VAT from a transient member-state outage, returning 503 instead of a false "invalid").
Calling GET /vat/{vatNumber} with a Bearer key, e.g. GET /vat/IE6388047V, and the JSON it returns: is_valid, country_code, name, address, and request_date.
Copy-paste Python and Node.js examples, plus when to use VAT validation in KYB onboarding and invoicing (reverse-charge, Spain's Verifactu / SII).

Runs on the free tier (1,000 calls/month, no credit card) — it is registry-data scope, not the paid sanctions tier. VIES covers the 27 EU states + XI; Greece files under EL, and GB VAT is out of scope post-Brexit.