Collect watchlist changes
poll_watchlistCollect everything the watch tools have found: call it to drain the changeset for every watch owned by your API key, most severe first. Company watches return an 'updated' entry with the changed fields and risk; CAEN and county watches return the 'new' firms registered since the last poll (200 a poll, the rest next).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | true when the poll ran. | |
| asOf | No | What to cite: registry (ONRC snapshot date), financialYear (fiscal year of the figures), anaf (day of the ANAF data), snapshot, published, source. | |
| error | No | Set only when there is no answer (empty_query, invalid_cui, data_unavailable, plan_required ...); such a call is not counted. | |
| owner | No | Whose watches these are (key prefix or IP). | |
| total | No | Number of watches with news. | |
| active | No | Every watch you hold, changed or not: kind (company or caen), target (CUI or code), county, since, name. Remove one with unwatch. | |
| message | No | A sentence for the caller. | |
| watches | No | Per watch: an 'updated' company with its changed fields and risk, or the 'new' firms registered in a watched activity. | |
| attribution | No | The credit line to keep when redistributing the data (CC BY 4.0). | |
| email_alerts | No | How to get the same changes by email. |