Subscribe to Industry Monitoring (NACE)
firmaradar_subscribe_naceMonitor Norwegian companies by NACE industry code: receive webhooks on status changes, announcements, or ownership updates. Use filters for region, size, and event type to reduce volume.
Instructions
Subscribe to industry (NACE) monitoring: when any Norwegian company in the chosen industry triggers a monitored event (new announcement, status change such as bankruptcy/dissolution, or ownership update), Firmaradar delivers a webhook to your URL. Use list_nace_codes first to resolve the exact code. A subscription on a parent code matches all child codes. Restrict events (e.g. ['status_changed']) and use geographic/size filters to cut volume in large industries, or pick a digest aggregation_mode. Idempotent — upserted on (user, nace_code), so re-subscribing the same code updates it. Requires a user whose plan has Firmaovervakning enabled. Call only when the user has asked to set up industry monitoring.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | HTTPS webhook URL that receives a POST for each matched event. Omit only if you intend to add it later via the portal. | |
| events | No | Which event types to deliver. Omit for all of them. Restrict to e.g. ['status_changed'] to receive only bankruptcy/dissolution signals and cut volume dramatically in large industries. | |
| aktivert | No | Whether the subscription is active immediately (default true). | |
| nace_code | Yes | The NACE code to monitor. Accepts a section letter ('G'), a group ('47'), or a more specific code ('47.110'). Resolve the exact code first with list_nace_codes if unsure. A subscription on a parent code also matches events in all child codes. | |
| min_ansatte | No | Optional size filter: only companies with at least this many employees. | |
| bearer_token | No | Optional bearer token Firmaradar sends as `Authorization: Bearer <token>` when calling your webhook URL, so your endpoint can authenticate the delivery. Stored encrypted. | |
| fylke_filter | No | Optional geographic filter: only companies in these fylker (county numbers). | |
| kommune_filter | No | Optional geographic filter: only companies in these kommuner (4-digit kommunenummer). | |
| landsdel_filter | No | Optional geographic filter: only companies in these landsdeler. | |
| aggregation_mode | No | Delivery cadence. 'real_time' (default) posts each event immediately. 'hourly_digest' / 'daily_digest' batch events to reduce noise in high-volume industries. | real_time |
| min_omsetning_nok | No | Optional size filter: only companies with at least this much revenue (NOK). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ID of the created/updated subscription. | |
| raw | No | ||
| url | No | ||
| events | No | ||
| aktivert | No | ||
| nace_code | No | ||
| created_at | No | ||
| updated_at | No | ||
| aggregation_mode | No | ||
| aggregation_mode_en | No |