Ny adresse, nytt navn eller et nystiftet selskap er ofte øyeblikket da et selskap begynner å kjøpe. API-et overvåker selskapene i CRM-et ditt, sender endringen slik Brønnøysundregistrene har registrert den, og lister opp selskapene som nettopp er stiftet. Alltid på selskapsnivå.
Et selskap kjøper sjelden jevnt gjennom året. Innkjøpene samles rundt hendelser: selskapet flytter, bytter navn, går mot avvikling eller er aktivt igjen etter avvikling. API-et gir disse endringene som registerendringer. Hver hendelse har event_type, en dato og, for navn og adresse, både previous_value og new_value, slik at du ser hva som gjaldt før og etter.
| Endring i registeret | event_type | Hvorfor det er viktig for salg |
|---|---|---|
| Ny forretningsadresse | address_change | Nye lokaler: flytting, innredning, IT og lokale leverandører. Postnummer og sted står i new_value |
| Nytt navn | name_change | Et navnebytte gir behov for nye skilt, nytt nettsted og oppdaterte avtaler og systemer |
| Ny organisasjonsform | legal_form_change | Selskapet omdannes: nye avtaler, ny bank og ny forsikring |
| Under avvikling, tvangsavvikling eller tvangsoppløsning | liquidation | Stans salget, beskytt fakturaen og rydd i CRM |
| Konkurs | insolvency | Stans leveranser på kreditt og meld kravet i boet |
| Slettet fra registeret | dissolution | Selskapet finnes ikke lenger: fjern det fra pipeline og kundelister |
| Aktivt igjen | reactivation | Et selskap som var under avvikling eller slettet, er aktivt igjen: ta kontakt på nytt |
Norge har ingen kunngjøringsstrøm for selskapshendelser. Hendelsene er registerendringer i navn, forretningsadresse, organisasjonsform og status, datert den dagen endringen først vises i registerdataene, og det finnes ingen før 14. oktober 2026. Registerets egen dato kan være tidligere.
Slå opp hver kunde på organisasjonsnummeret én gang, legg den under overvåking og lagre CRM-id-en som label: den følger med i hvert varsel. For Norge er id selve organisasjonsnummeret. Å overvåke koster ingen kreditter.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
# Kundene dine: organisasjonsnummer og id i CRM
kunder = [('923609016', 'crm-1001'), ('982463718', 'crm-1002')]
for orgnr, crm_id in kunder:
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'NO', 'company_number': orgnr})
r.raise_for_status()
treff = r.json()['data']
if not treff:
continue
requests.post(f'{BASE}/monitor', headers=H, json={
'company_id': treff[0]['id'],
'label': crm_id, # følger med i hvert varsel
'events': ['corporate_event', 'status_change', 'dissolution'],
'webhook_url': 'https://example.com/hooks/prometiam',
}).raise_for_status()
Varslene er signerte. Headeren X-Prometiam-Signature har verdien sha256= etterfulgt av HMAC-SHA256 av innholdet, regnet ut med webhook_secret som POST /monitor returnerer. Kontroller signaturen før du oppretter oppgaven til kundeansvarlig. Webhook følger med alle planer. Du kan også lese varslene med GET /monitor (de 50 siste), så en jobb som kjører hver natt, fungerer også. Overvåkingen kontrolleres hver dag. Du kan overvåke 3 selskaper i prøveperioden, 25 med Starter, 250 med Professional og 2 500 med Scale.
Før den første samtalen sier de siste endringene mer enn en selskapsbeskrivelse. GET /company-events/search?country=NO&company_number=923609016&date_from=2026-10-14 gir kundens hendelser, de nyeste først, for 2 kreditter per kall. En tom liste betyr at ingen endring er sett ennå.
Uten organisasjonsnummer og navn er samme kall landets hendelsesstrøm: alle registerendringer i Norge, de nyeste først, filtrert på event_type. Strømmen dekker høyst de siste 31 dagene (7 dager hvis du ikke oppgir date_from, og en eldre dato gir feilen 400). En daglig eller ukentlig jobb som leser strømmen og beholder selskapene i segmentet ditt, finner selskapene du ennå ikke overvåker.
# Alle adresseendringer i Norge siden 14. oktober, de nyeste først (100 hendelser per kall) curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=NO&event_type=address_change&date_from=2026-10-14&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Hvert kall koster 2 kreditter for opptil 100 hendelser, og du blar videre med next_cursor. En adresseendring har både gammel og ny adresse (previous_value og new_value, med postnummer og sted), så du kan filtrere på postnummer eller sted direkte i strømmen og slå opp bare de selskapene som er interessante, med GET /companies/{id} for 1 kreditt. Navneendringer (name_change) og statusendringer som avvikling (liquidation) hentes på samme måte.
Selskapets stiftelse er det første signalet: et nytt selskap trenger bank, regnskapsfører, forsikring, IT og lokaler. founded_after lister opp selskaper stiftet fra en dato, side for side og med de nyeste først, uten at du oppgir navn. Hvert selskap har legal_form (for eksempel AS), capital_amount med capital_currency (NOK), activity_code (næringskode), municipality (kommune) og region (fylke).
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
def nye_selskaper(fra):
"""Alle selskaper stiftet fra en dato, de nyeste først (1 kreditt per side på opptil 100)."""
cursor = None
while True:
p = {'country': 'NO', 'founded_after': fra, 'limit': 100, **({'cursor': cursor} if cursor else {})}
r = requests.get(f'{BASE}/companies/search', headers=H, params=p)
r.raise_for_status()
body = r.json()
yield from body['data']
cursor = (body.get('pagination') or {}).get('next_cursor')
if not cursor:
break
# Nye aksjeselskaper i bygg og anlegg (næringskode 41 til 43)
for s in nye_selskaper('2026-10-01'):
if s['legal_form'] == 'AS' and (s.get('activity_code') or '')[:2] in ('41', '42', '43'):
print(s['founding_date'], s['company_number'], s['company_name'], s['municipality'], s['capital_amount'])
Tre ting å vite. Datoen i founded_after er stiftelsesdatoen (founding_date), og et selskap vises i registeret først etter at det er stiftet: de siste dagene er derfor alltid ufullstendige, så hent med noen dagers margin og hopp over organisasjonsnumre du allerede har. De nyeste selskapene har ofte ingen næringskode ennå (activity_code er 00.000, «Uoppgitt», eller mangler), så filtrer ikke bare på næringskode. Og enheter uten stiftelsesdato i registeret, som konkursbo (KBO), andre bo (BO) og enkeltpersonforetak (ENK), kommer aldri med i listen.
legal_form_change) hører med til registerendringene, men i de første dagene etter 14. oktober 2026 var det ingen i strømmen.GET /insolvency/search?country=NO) som overvåkingen ikke varsler om. At et selskap går konkurs, går under avvikling eller blir slettet, ser du derimot som statusendring blant hendelsene.Overvåking koster ingen kreditter: planen bestemmer hvor mange kunder du overvåker. Et selskapsoppslag koster 1 kreditt og et hendelsessøk 2; feil koster ingenting. Starter koster 9,99 € per måned med 1 000 kreditter, Professional 29,99 € med 10 000 kreditter og 250 selskaper, og Scale 99,99 € med 50 000 kreditter og 2 500 selskaper; webhook følger med alle planer. Prøveperioden er 14 dager og 500 kreditter: betalingskort kreves, og ingenting belastes under prøveperioden. Deretter går du over til Starter (9,99 € per måned) hvis du ikke sier opp.
Source: Brønnøysundregistrene (Enhetsregisteret), Norway. Licensed NLOD.
Start din gratis prøveperiode på 14 dager · API-dokumentasjon
Prøveperioden varer i 14 dager og gir 500 kreditter. Betalingskort kreves, men ingenting belastes under prøveperioden; deretter går du over til Starter (9,99 € per måned) hvis du ikke sier opp.