API documentation

Company monitoring and webhooks: GET, POST, DELETE /monitor

Subscribe a company with POST /monitor and Prometiam pushes each material change (corporate events, status changes, dissolution, a new sanctions match) to your webhook the day after it is published, and to GET /monitor. Webhooks are signed with HMAC-SHA256 over the raw body, so verify the signature before you trust a payload.

Card required, nothing charged for 14 days. 500 credits over the trial.

curl -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": 812044, "label": "acme-vendor", "webhook_url": "https://yourapp.com/hooks/prometiam", "events": ["corporate_event","status_change","sanctions_match"]}'

company_id is the numeric id from /companies/search. The response returns a one-time webhook_secret: store it to verify signatures. Only company_id is required; omit webhook_url to poll GET /monitor instead.

The webhook payload

Signed with HMAC-SHA256 over the raw body using your webhook_secret, in the X-Prometiam-Signature: sha256=… header.

{
  "event": "company_monitor.alert",
  "alert_type": "corporate_event",
  "monitor_id": 42,
  "label": "acme-vendor",
  "company": { "id": 812044, "company_number": "A28015865", "name": "TELEFONICA SA", "country": "ES" },
  "event_date": "2026-07-02",
  "detail": { "event_type": "capital_change", "previous_value": "3000000", "new_value": "5000000", "notice_url": "https://www.boe.es/borme/..." },
  "created_at": "2026-07-03T05:10:00Z"
}

alert_type is one of corporate_event, status_change, dissolution or sanctions_match. GET /monitor lists your subscriptions and recent alerts; GET /monitor/{id} returns one subscription with its alert history; DELETE /monitor/{id} stops monitoring. Managing monitored companies costs 0 credits.

How many companies

Monitored companies per account scale with the plan: free trial 3, Starter 25, Professional 250, Scale 2,500 (accounts on the earlier plans keep their caps).

Limits

Monitoring covers 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 and US, plus the LEI layers AT, IT, IN and GR. France and Chile are not monitorable.
Corporate events: Spain gets the gazette stream; the United Kingdom alerts on Companies House filings and Gazette notices; Ireland, Poland and Norway alert on register-change events (none before 14 Oct 2026); the other countries alert on register-change events dated when the change first appears in the register data, with a start date per country in the reference.
A dissolution alert fires when the company gets a dissolution date or, where the register gives no date, when its status becomes closed; that alert is dated by the check that first sees the closure and carries detail.date_basis first_seen_closed. Argentina is read monthly and never fires a dissolution alert.
Sanctions screening is in beta. PEP data is in beta and covers Spain only.
The free trial lasts 14 days, needs a card, charges nothing during it and then becomes Starter at EUR 9.99 a month unless you cancel; it includes 500 credits in total plus 25-call allowances on sanctions screening, people search and company events.

This page is a short guide; the full reference has every parameter and response, and openapi.json is the machine-readable specification.