Sign up

USE CASE · CREDIT CONTROL

Know your customer filed for insolvency before the invoice bounces

Watch your customer book for insolvency filings, dissolutions and status changes across Europe from one REST API — instead of finding out when a payment fails or a delivery goes out to a company in administration.

The job this does

Credit control usually finds out about an insolvency in one of three ways: the customer stops paying, a collections agency mentions it, or someone reads it in the trade press. All three arrive after the exposure is already booked. The filings themselves are published by official gazettes and court registers the day they happen — the problem is that they are published in many different formats, in several languages, on separate websites.

This turns that into one endpoint and one key.

It reaches past our registry footprint

This is the part worth knowing: company-registry data covers every registry the API serves — but the insolvency feed goes wider. If you sell into the DACH region, you can monitor customers there for insolvency even though full company data for those countries is not part of the API.

Finland. 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.

CountryDistress noticesDissolutionsRefreshRegistry data too?
GermanyYesNoneDailyNo — distress data only
FranceYesYes (the majority)DailyYes (BODACC/RNE)
United KingdomYesYesDailyYes (Companies House)
AustriaYesNoneDailyNo — distress data only
NorwayYesYesDailyYes (Brønnøysundregistrene)
SwitzerlandYesYesDailyYes (Zefix), company records only; notices link by UID where the notice names it
FinlandYesYes (the majority)PeriodicYes (Kaupparekisteri), company records only
United StatesYesNonePeriodicNo — distress data only
NetherlandsYes — open and recently closed cases (the register removes a case six months after it closes)—DailyNo — distress data only
SpainYes — concursal notices (also on GET /search)—DailyYes (BORME)

Straight about what this is: the two columns are not interchangeable. A dissolution is a company closing, frequently solvent and voluntary; a distress notice is not. France and Finland are mostly dissolutions rather than distress events, so a blended country total would badly mislead anyone building a credit-risk feed. Use ?event_type= to select. Coverage by country is published at the public /coverage endpoint.

Pull: re-check your book on a schedule

The simplest integration is a nightly job over your open-receivables list. The DACH, Nordic and Spanish markets come from the cross-border insolvency endpoint, and registry-linked French and UK judgments from the events endpoint.

# Germany, Austria, Switzerland, the Netherlands, Norway, Finland, France, UK, US
# event_type=insolvency excludes dissolutions — a solvent closure is not a default signal
curl -s "https://api.prometiam.com/functions/v1/risk-api/insolvency/search?name=ACME&country=DE&event_type=insolvency" \
  -H "Authorization: Bearer rk_live_your_api_key"

# Spanish concursal filings
curl -s "https://api.prometiam.com/functions/v1/risk-api/search?name=ACME&country=ES" \
  -H "Authorization: Bearer rk_live_your_api_key"

# Registry-linked judgments for FR and GB customers (company_name, not name)
curl -s "https://api.prometiam.com/functions/v1/risk-api/company-events/search?company_name=ACME&country=FR" \
  -H "Authorization: Bearer rk_live_your_api_key"
Customer dashboard screenshot: insolvency notices of a Spanish companyCustomer dashboard screenshot: insolvency notices of a Spanish company
The dashboard's Insolvency tab for a Spanish company, the call GET /insolvency/search makes: concurso notices from BORME entries. Corporate insolvency only; no notice is not proof that none exists. Open it in the dashboard

Push: subscribe and get a webhook

Rather than polling, subscribe a company once and receive the events. Monitoring currently supports every live country except France and Chile and is capped by plan at 3 / 25 / 250 / 2,500 watched companies (Free / Starter / Professional / Scale).

# Watch a customer and get pushed the events instead of polling
curl -s -X POST "https://api.prometiam.com/functions/v1/risk-api/monitor" \
  -H "Authorization: Bearer rk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "company_id": 59884,
    "country": "ES",
    "events": ["status_change", "dissolution", "corporate_event", "sanctions_match"],
    "webhook_url": "https://your-erp.example.com/hooks/prometiam"
  }'

Watched events: status_change, dissolution, corporate_event and sanctions_match (sanctions screening is beta). France is not yet monitorable — for it, use the scheduled pull above.

Customer dashboard screenshot: a list of monitored companiesCustomer dashboard screenshot: a list of monitored companies
POST /monitor in the dashboard: the watchlist and what each company is watched for. Monitoring covers every live country except France and Chile; a sanctions match is beta. Shown with a demo account. Open it in the dashboard

What this is not

  • Not a credit score. We report filings and registry facts, not a probability of default. If you need a bureau score, pair this with a scoring vendor.
  • Not trade-credit insurance and not a collections service.
  • Not complete. An insolvency notice appears when it is published by the relevant gazette or court register — a distressed customer can be weeks away from filing and look perfectly healthy here.

What it costs

The free trial is 500 credits over 14 days, card required, nothing charged for 14 days — enough to try the check over a couple of hundred customers (2 credits per company). Starter is €9.99/month for 1,000 credits and Professional €29.99/month for 10,000. Published pricing, no sales call. See pricing.

Sign up Read the insolvency guide