Counterparty Monitoring API — Daily EU + UK Event Watch

KYB at onboarding only tells you what a counterparty looked like on signup day. Prometiam adds continuous post-onboarding monitoring: a daily query of official-gazette feeds — BORME (Spain), BODACC (France) and UK Companies House — normalized into one typed-event schema across countries. One cron, one endpoint, predictable cost, versus annual batch-FTP subscriptions from legacy vendors.

The watchlist pattern

Two endpoints power the flow, and both are company-scoped: /company-events/search returns events for a named counterparty since a given date, and /company-events/timeline pulls that company's full lifecycle. There is no un-scoped whole-gazette query, so the operational shape is a daily cron that walks your own watchlist, passing each counterparty plus date_from set to your last sweep. For a version you do not schedule yourself, POST /monitor subscribes a company and pushes signed webhooks instead.

Event types that matter for risk

Each event carries previous and new values where applicable, plus a link to the original gazette PDF for audit.

Freshness and pricing

BORME and BODACC are ingested within hours of publication; UK is monthly bulk plus daily delta. Webhooks are live: POST /monitor with a webhook_url and alerts arrive HMAC-SHA256 signed (X-Prometiam-Signature) for Spain, Ireland and Poland. For the other countries the pattern is daily cron plus diff. A 1,000-counterparty portfolio fits the Starter tier; 5,000 fits Professional, with sanctions screening (6 sources, 44,000+ active entities) included.

Read more · Get a free API key

Frequently asked questions

What is counterparty monitoring?
Continuous post-onboarding watch on every B2B counterparty in your portfolio for events that change their risk profile — capital reductions, director changes, dissolution filings, insolvency, name or address changes. Prometiam returns these events daily via /company-events/search and /company-events/timeline.
How fresh are the events?
BORME (Spain) and BODACC (France) are ingested within hours of publication on the official gazette. UK Companies House is monthly bulk + daily delta. /coverage returns latest_filing per country.
How many counterparties can I monitor?
The Free tier (1,000 calls/month) covers a small daily check. Starter (€9.99/mo, 10K calls/month) supports ~1,000 counterparties via paginated daily event pulls and adds 10 sanctions watchlists. Professional (€29.99/mo, 100K calls/month) supports ~5,000 with 100 watchlists. Scale and Enterprise go beyond.
Does it support webhooks for new events?
Yes, for Spain, Ireland and Poland: POST /monitor with a webhook_url and alerts are delivered HMAC-SHA256 signed via the X-Prometiam-Signature header. For other countries the pattern is a daily cron that walks your own watchlist, calling /company-events/search with the company_name or company_number of each counterparty, plus date_from set to your last sweep, and diffs against your local cache. The event endpoints are company-scoped, so there is no un-scoped whole-gazette query.
Which event types are covered?
capital_change, director_change, dissolution, liquidation, insolvency, new_incorporation, name_change, address_change, merger, demerger, status_change. All normalized into typed events with previous/new values where applicable.