Events

Events represent detected changes on watched companies. They are created automatically when Verifiables detects a change in public registries (INPI RNE, BODACC, INSEE Sirene). Events are immutable and retained indefinitely.

GET /v1/monitoring/events

List events for the companies you actively watch. Results are paginated and sorted by source publication date, descending.

Events are scoped to your active watches: only events whose SIREN matches one of your active watches are returned. If you have no active watches, the list is empty, and filtering by a SIREN you do not watch returns nothing.

Authentication: Secret API key

Query parameters

Parameter	Type	Default	Description
`siren`	string	-	Filter by SIREN number (must be one of your watched SIREN)
`category`	string	-	Filter by event category
`dateFrom`	string (ISO 8601)	-	Events published on or after this date
`dateTo`	string (ISO 8601)	-	Events published on or before this date
`page`	number	`1`	Page number
`perPage`	number	`25`	Results per page (max 100)

Response `200`

{
  "meta": {
    "total": 42,
    "perPage": 25,
    "currentPage": 1,
    "lastPage": 2
  },
  "data": [
    {
      "id": "01j1bc8zc7q0axyz4n6p8s0e1x",
      "siren": "443061841",
      "siret": null,
      "category": "governance_change",
      "proceeding": null,
      "source": "inpi_rne",
      "sourceRecordId": "2025-A-12345",
      "sourcePublishedAt": "2025-05-29T00:00:00.000+00:00",
      "effectiveDate": "2025-05-28T00:00:00.000+00:00",
      "filingDate": null,
      "ingestedAt": "2025-05-29T08:30:00.000+00:00",
      "before": { "dirigeants": ["Marie Martin"] },
      "after": { "dirigeants": ["Marie Martin", "Jean Dupont"] },
      "raw": { "...": "original source record" }
    }
  ]
}

Field	Type	Description
`id`	string	Deterministic ULID, stable across re-ingestion
`siren`	string	9-digit company SIREN number
`siret`	string \| null	14-digit SIRET when the event is establishment-scoped
`category`	string	Event category (see below)
`proceeding`	string \| null	Proceeding type, only for `collective_proceeding` events
`source`	string	Data source: `inpi_rne`, `bodacc`, or `insee_sirene`
`sourceRecordId`	string	Reference in the source registry (INPI formalité ID, BODACC numéro d'annonce, ...)
`sourcePublishedAt`	string	Publication date in the source registry
`effectiveDate`	string \| null	Legal effective date of the change, when available
`filingDate`	string \| null	Filing date at the registry, when available
`ingestedAt`	string	When Verifiables ingested the event
`before`	object \| null	Snapshot of the changed fields before the event
`after`	object \| null	Snapshot of the changed fields after the event
`raw`	object \| null	Original source record as ingested

curl examples

Fetch all events for a watched company:

curl "https://api.verifiables.com/v1/monitoring/events?siren=443061841" \
  -H "Authorization: Bearer oat_your_secret_key"

Filter by category and date range:

curl "https://api.verifiables.com/v1/monitoring/events?siren=443061841&category=collective_proceeding&dateFrom=2025-01-01&dateTo=2025-06-30" \
  -H "Authorization: Bearer oat_your_secret_key"

Event categories

Category	Description	Common sources
`identity_change`	Company name, trade name, or legal form change	RNE, Sirene
`capital_change`	Share capital increase, decrease, or restructuring	RNE, BODACC
`address_change`	Registered office relocation	RNE, Sirene
`object_change`	Change in corporate purpose	RNE
`form_change`	Legal form transformation (e.g. SAS to SA)	RNE
`governance_change`	Directors, officers, or beneficial owners	RNE, BODACC
`establishment_change`	Branch opening, closing, or modification	Sirene
`accounts_filed`	Annual accounts deposited at the registry	BODACC
`fund_transfer`	Business asset transfer (fonds de commerce)	BODACC
`collective_proceeding`	Insolvency proceedings	BODACC
`incorporation`	New company registered	RNE, Sirene
`dissolution`	Company dissolved	RNE, BODACC
`radiation`	Company struck off the registry	RNE, Sirene
`unknown`	Source record could not be classified	any

Collective proceeding types

Events with category collective_proceeding carry a top-level proceeding field. The possible values correspond to French insolvency law:

Type	Description
`sauvegarde`	Safeguard procedure (Book VI, Art. L620-1)
`redressement_judiciaire`	Judicial reorganization
`liquidation_judiciaire`	Judicial liquidation
`conciliation`	Conciliation (confidential negotiation)
`retablissement_professionnel`	Professional recovery (individuals)
`plan_de_sauvegarde`	Approved safeguard plan
`plan_de_redressement`	Approved reorganization plan
`cloture_pour_insuffisance_actif`	Closure for insufficient assets
`cloture_pour_extinction_passif`	Closure with all debts settled

Example: collective proceeding event

{
  "id": "01j1bc8zc7q0axyz4n6p8s0e2y",
  "siren": "443061841",
  "category": "collective_proceeding",
  "proceeding": "redressement_judiciaire",
  "source": "bodacc",
  "sourceRecordId": "BODACC-A-2025-12345",
  "sourcePublishedAt": "2025-05-16T00:00:00.000+00:00",
  "effectiveDate": "2025-05-15T00:00:00.000+00:00",
  "after": {
    "court": "Tribunal de commerce de Paris",
    "judgmentDate": "2025-05-15"
  }
}