# Overvåking av endringer i norske selskaper

Canonical: https://www.apier.no/no/overvaking

Apier følger registrene i Brønnøysund og lagrer hver endring det observerer, i et arkiv som bare kan utvides. En AI-agent kan få beskjed med en signert webhook når et selskap den jobber med, endres, eller lese de samme endringene fra arkivet.

Et varsel sier hva som er endret i registeret, og når. En agent bruker det til å flagge endringen slik at et menneske ser på den; varselet sier ikke noe om hvem som kan handle for selskapet.

## Hva som oppdages

Endringsvarsler har fem hendelsestyper. Hver hendelse har verdien før og etter endringen, virkningsdatoen når Brønnøysund oppgir en, datoen Apier observerte endringen, kilden og ID-en til den arkiverte endringen den kommer fra.

| Hendelsestype | Når den utløses |
|---|---|
| `signing_rule_changed` | Den registrerte signaturretten eller prokuraen endres. |
| `role_added` | En rolleinnehaver legges til i styret, eller som innehaver av et enkeltpersonforetak. |
| `role_removed` | En rolleinnehaver fjernes. |
| `status_changed` | Statusen til selskapet endres, for eksempel til konkurs, under avvikling, under tvangsavvikling eller slettet. |
| `vat_registration_changed` | Selskapet registreres i, eller slettes fra, Merverdiavgiftsregisteret. |

Hendelser navngir aldri en person: en rollehendelse sier hvilken rolle som er lagt til eller fjernet, og en signaturhendelse viser rollene og signaturreglene, ikke hvem som har dem. Kall `GET /api/v1/company/{org}/authority` for å se hvem som har en rolle nå.

## Hvor ofte Apier sjekker

Apier henter endringene selv; Brønnøysund sender dem ikke. Dette er de planlagte jobbene mellom en endring i registeret og varselet du får, med når hver av dem kjører.

| Jobb | Kjører | Hva den gjør |
|---|---|---|
| `brreg-updates-feed` | 20 minutter over hver hele time | Leser oppdateringene fra Enhetsregisteret i Brønnøysund og arkiverer det som er endret. |
| `brreg-roller-feed` | 40 minutter over hver hele time | Leser rolleoppdateringene fra Brønnøysund og den registrerte signaturretten og prokuraen for selskapene den oppdaterer. |
| `bulk-file-vault` | én gang i døgnet | Lagrer den nasjonale registerfilen, som er kilden til det daglige arkivet til Apier. |
| `change-alerts` | 50 minutter over hver hele time | Gjør de arkiverte endringene for selskaper du følger, om til varselhendelser. |
| `webhook-delivery` | hvert minutt | Sender ventende varsler til webhooken din og prøver en feilet leveranse på nytt med økende ventetid. |

En endring som en av de timevise jobbene arkiverer, blir et varsel i neste varselkjøring, og leveringsjobben sender det deretter. Varslene gjelder selskaper Apier speiler fra oppdateringene i Brønnøysund.

## Når arkivet starter

Arkivet til Apier fra Brønnøysund starter 2026-07-30. Endringer fra før den dagen finnes ikke i det, og Apier hevder ingen. Hvert historisk svar oppgir perioden det dekker.

Arkivet kan bare utvides: en observert endring blir aldri skrevet om eller fjernet. Unntaket er en oppføring Brønnøysund selv fjerner, som beholdes som en gravstein med dato og årsak.

## Hvordan en agent abonnerer

### Varsler: en følgeliste med signerte webhooks

En konto kan følge inntil 100 selskaper. Følgelisten styres fra en innlogget økt i dashbordet: det første selskapet du legger til, oppretter den, med URL-en til webhooken din og kontonøkkelen som saldoen og utgiftsgrensene belastes for. Hemmeligheten for signering vises én gang, i det første svaret.

Hver leveranse er en `POST` til URL-en din med headeren `x-apier-signature: t=<unix seconds>,v1=<hex>`, en HMAC over tidsstempelet, et punktum og den rå meldingskroppen. Svar med en hvilken som helst `2xx`; andre svar prøves på nytt med økende ventetid. Du kan følge et utvalg av de fem hendelsestypene.

### Oppslag: les endringsarkivet

En agent som heller henter selv, leser arkivet med `GET /api/v1/changes` eller MCP-verktøyet `list_changes`, med en API-nøkkel som har scopet `read:changes`. Filtrer på `entity_id` (organisasjonsnummeret), `source`, `change_type` og et intervall fra `from` til `to`; sidene kommer med de nyeste først og har en signert markør. Spørringer uten `entity_id` utelater rader med personopplysninger. Hver rad har `observation_kind`: `first_observation` betyr at arkivet så verdien for første gang, ikke at selskapet er endret, og `value_change` betyr en observert endring. Tell bare rader med `value_change` som endringer.

```bash
curl -H 'Authorization: Bearer <API_KEY>' \
  'https://www.apier.no/api/v1/changes?entity_id=999999999&from=2026-11-01T00:00:00Z'
```

### Test uten følgeliste

`GET /api/v1/sandbox/watchlist/events` returnerer ett syntetisk varsel av hver hendelsestype, formet som `change`-objektet i en ekte leveranse. Den godtar sandkassens bearer og koster ingenting; sandkassen gir hendelser bare ved oppslag og sender aldri en webhook.

## Hva det koster

Endringsvarsler følger reglene for saldo i overvåking av årsregnskap: hvert selskap du følger, belastes samme månedspris som overvåking av årsregnskap én gang per kalendermåned (Europe/Oslo), og bare én gang også når du overvåker regnskapet til selskapet. Leveranser koster ikke noe ekstra. Belastning fra saldo for overvåkingen kommer; dagens Professional og Enterprise abonnenter har endringsvarsler til slutten av perioden sin. Prissiden har vilkårene som gjelder nå.

## Hva overvåkingen ikke er

Et varsel er en oversikt over hva Apier observerte i et offentlig register. Det er ingen vurdering av om noen kan signere eller handle for selskapet, det stopper eller godkjenner ingenting av seg selv, og det er ikke juridisk rådgivning. Autoritetsendepunktet returnerer selskapets registrerte signaturregler slik de står nå.

## Les mer

- [Veiledning for endringsvarsler (på engelsk)](https://www.apier.no/docs/guides/change-alerts)
- [Priser](https://www.apier.no/no/priser)
- [Status for funksjoner (på engelsk)](https://www.apier.no/docs/capability-status)
