Docs
Monitoring

Company Monitoring

Track legal changes on French companies and get notified automatically

Company Monitoring lets you watch French companies (identified by SIREN) for legal events such as governance changes, address moves, capital modifications, and collective proceedings. When something happens, you get an event in your feed and optionally a webhook delivery.

How it works

  1. Create a watch on a SIREN number. Optionally filter by event categories.
  2. Verifiables polls public registries (INPI RNE, BODACC, INSEE Sirene) daily on your behalf.
  3. When a change is detected, an event is created and stored.
  4. If you have configured a webhook, the event is delivered to your endpoint with an HMAC signature.

Registries are polled once a day, so changes are typically detected within a day of their publication.

Core concepts

ConceptDescription
WatchA subscription to changes on a specific SIREN. You can scope it to specific event categories.
EventA detected change, e.g. an address change or new accounts filing. Events are immutable and queryable.
AlertPer-watch notification preferences. Control which categories notify immediately, go to a digest, or stay muted.
WebhookAn HTTPS endpoint that receives event payloads shortly after detection. Secured with HMAC-SHA256 signatures.

Event categories

Monitoring classifies legal events into 14 categories (13 business categories plus an unknown fallback for unclassifiable records):

CategoryDescription
identity_changeCompany name, trade name, or legal form change
capital_changeShare capital increase, decrease, or restructuring
address_changeRegistered office relocation
object_changeChange in corporate purpose
form_changeLegal form transformation (e.g. SAS to SA)
governance_changeNew directors, officers, or beneficial owners
establishment_changeBranch opening, closing, or modification
accounts_filedAnnual accounts deposited at the registry
fund_transferBusiness asset transfer (fonds de commerce)
collective_proceedingInsolvency proceedings (sauvegarde, redressement, liquidation)
incorporationNew company registered
dissolutionCompany dissolved
radiationCompany struck off the registry
unknownSource record could not be classified

Quick example

Create a watch, then list events:

POST /v1/monitoring/watches
Authorization: Bearer oat_your_secret_key
Content-Type: application/json

{
  "siren": "443061841",
  "categories": ["governance_change", "collective_proceeding"]
}
GET /v1/monitoring/events?siren=443061841&dateFrom=2025-01-01
Authorization: Bearer oat_your_secret_key

Next steps

  • Watches: create and manage watches
  • Events: query the event stream
  • Webhooks: receive automatic notifications
  • AML / LCB-FT: how monitoring fits ongoing-vigilance obligations