# Company monitoring and webhooks

FirmAPI continuously watches 55 public registers. When something changes at a monitored company – a new debt, insolvency, director change – a webhook delivers it into your system immediately.

## Which changes we catch

- **Risk signals** – The company appeared on a debtor list, entered bankruptcy, received an enforcement authorization or lost VAT reliability.
- **Business Register changes** – Changes of directors, shareholders, registered address, business name, share capital or business activities.
- **Status changes** – Entering liquidation, deletion from the register, legal form change.
- **Financial data** – A new financial statement filed in the Register of Financial Statements.

## How monitoring works

1. **Subscribe companies** – Via API or the dashboard, pick the IČOs you want to watch – customers, suppliers, competitors.
2. **Set up a webhook** – Provide your endpoint URL. Every delivered event is signed so you can verify its authenticity.
3. **React automatically** – The change arrives as a JSON payload with the event type, IČO and value diff. The rest is up to your system – from a Slack notification to freezing credit.

```bash
# Registering a webhook
curl -X POST -H "X-API-Key: fa_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "ico": "51636549",
    "url": "https://vas-system.sk/webhooks/firmapi",
    "events": ["debtor.added", "insolvency.opened", "officers.changed", "address.changed"]
  }' \
  "https://firmapi.sk/v1/notifications"

{ "id": "whs_01j...", "status": "active" }
```

## Typical deployments

- Credit management – automatically stop deliveries when a customer appears on a debtor list.
- Compliance – continuous sanctions screening of existing clients.
- CRM hygiene – addresses, names and directors in your CRM update themselves.
- Sales signals – a new company in your industry or a leadership change at a prospect.

## Frequently asked questions

### How many companies can I monitor?

Depends on the plan – from a handful on the free plan to thousands on Enterprise. Monitored company and webhook counts are listed on the pricing page.

### How quickly do I learn about a change?

The webhook fires immediately after the respective register's synchronisation catches the change. Most registers synchronise daily.

### What if my endpoint is down?

We retry delivery with exponential backoff, and the delivery history is visible in the dashboard and via API.

### Can I receive changes by e-mail too?

Yes, alongside webhooks we support e-mail notifications – handy when a person rather than a system watches the changes.

---

Sign up: https://api.firmapi.sk/en/register · Documentation: https://api.firmapi.sk/en/docs.md · Company verification: https://api.firmapi.sk/en/verify-company.md · Use cases: https://api.firmapi.sk/en/use-cases.md