En ny adress, ett nytt namn, en ny bolagsform eller ett nystartat bolag är ofta ögonblicket då ett bolag börjar köpa. API:et bevakar bolagen i ditt CRM, skickar de förändringar som Bolagsverket har registrerat och listar de bolag som just har registrerats. Alltid på bolagsnivå: för Sverige finns inga uppgifter om styrelseledamöter eller andra funktionärer.
Ett bolag köper sällan jämnt över året. Inköpen samlas kring händelser: bolaget bildas, flyttar, byter namn eller bolagsform, går upp i ett annat bolag eller är på väg ut ur registret. API:et ger de här förändringarna som registerhändelser. Varje händelse har event_type, ett datum och, för namn, adress och bolagsform, både previous_value och new_value, så att du ser vad som gällde före och efter.
| Förändring i registret | event_type | Varför det spelar roll för säljare |
|---|---|---|
| Nytt bolag syns i registret | new_incorporation | Ett nytt bolag behöver bank, redovisning, försäkring, IT och lokal |
| Ny registrerad adress | address_change | Ny lokal: flytt, inredning, telefoni, bredband och lokala leverantörer. Postnummer och ort står i new_value |
| Nytt bolagsnamn | name_change | Ett namnbyte ger nya skyltar, ny webbplats och ofta nya avtal och system |
| Ny bolagsform | legal_form_change | Till exempel från handelsbolag till kommanditbolag: nya avtal, ny bank och ny försäkring |
| Bolaget går upp i ett annat | merger | Två leverantörslistor blir en, och inköpen samlas hos ett bolag |
| Likvidation, avregistrering, konkurs | liquidation, dissolution, insolvency | Stoppa affären, skydda fakturan och städa i CRM |
| Bolaget är aktivt igen | reactivation | Ett bolag som var i likvidation är aktivt igen: ta upp kontakten på nytt |
De svenska uppgifterna omfattar varken funktionärer eller aktiekapital. Ändringar av styrelse, firmatecknare och aktiekapital, som i andra länder är starka signaler, finns därför inte här. Händelserna får det datum då ändringen först syns i registerdata, inte datumet för Bolagsverkets beslut, och det finns inga före den 30 september 2026.
Slå upp varje konto på organisationsnumret en gång, lägg det under bevakning och spara ditt CRM-id som label: det följer med i varje larm. Att bevaka kostar inga krediter.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
# Dina konton: organisationsnummer och id i CRM
konton = [('556012-5790', 'crm-1001'), ('556016-0680', 'crm-1002')]
for orgnr, crm_id in konton:
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'SE', 'company_number': orgnr})
r.raise_for_status()
traffar = r.json()['data']
if not traffar:
continue
requests.post(f'{BASE}/monitor', headers=H, json={
'company_id': traffar[0]['id'],
'label': crm_id, # följer med i varje larm
'events': ['corporate_event', 'status_change', 'dissolution'],
'webhook_url': 'https://example.com/hooks/prometiam',
}).raise_for_status()
Larmen är signerade. Headern X-Prometiam-Signature har värdet sha256= följt av HMAC-SHA256 av innehållet, beräknad med det webhook_secret som POST /monitor returnerar. Kontrollera signaturen innan du skapar uppgiften åt kontots ägare:
import hashlib, hmac, os
from flask import Flask, request, abort
app = Flask(__name__)
SECRET = os.environ['PROMETIAM_WEBHOOK_SECRET'].encode() # webhook_secret från POST /monitor
def skapa_crm_uppgift(crm_id, typ, detalj, datum):
... # ditt CRM:s API: en uppgift åt kontots ägare
@app.post('/hooks/prometiam')
def larm():
skickad = request.headers.get('X-Prometiam-Signature', '')
beraknad = 'sha256=' + hmac.new(SECRET, request.get_data(), hashlib.sha256).hexdigest()
if not hmac.compare_digest(skickad, beraknad):
abort(401)
a = request.get_json()
# till exempel alert_type 'corporate_event', detail.event_type 'address_change', label 'crm-1001'
skapa_crm_uppgift(a['label'], a['alert_type'], a.get('detail', {}), a['event_date'])
return '', 204
Webhooks ingår i alla planer. Du kan också läsa larmen med GET /monitor (de 50 senaste), så ett jobb som körs varje natt fungerar också. Bevakningen kontrolleras varje dag. Du kan bevaka 3 bolag under provperioden, 25 med Starter, 250 med Professional och 2 500 med Scale.
Innan det första samtalet säger de senaste förändringarna mer än en bolagsbeskrivning. GET /company-events/search?country=SE&company_number=556012-5790&date_from=2026-09-30 ger kontots händelser, de nyaste först, för 2 krediter per anrop. En tom lista betyder att ingen förändring har setts ännu. Organisationsnumret fungerar med eller utan bindestreck.
Utan organisationsnummer och namn är samma anrop landets händelseflöde: alla registerhändelser i Sverige, de nyaste först, som du kan filtrera på event_type. Flödet täcker högst de senaste 31 dagarna (7 dagar om du inte anger date_from, och ett äldre datum ger felet 400). Ett dagligt eller veckovis jobb som läser flödet och behåller bolagen i ditt segment hittar de konton du ännu inte bevakar.
# Alla adressändringar i Sverige sedan 5 oktober, de nyaste först (100 händelser per anrop) curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=SE&event_type=address_change&date_from=2026-10-05&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Varje anrop kostar 2 krediter för upp till 100 händelser, och du bläddrar vidare med next_cursor. En adressändring innehåller både den gamla och den nya adressen (previous_value och new_value, med postnummer och ort), så du kan filtrera på postnummer och ort direkt i flödet och bara slå upp de bolag som är intressanta med GET /companies/{id} för 1 kredit. Nya bolag (new_incorporation), namnbyten (name_change) och byten av bolagsform (legal_form_change) hämtas på samma sätt.
Bildandet är den första signalen: ett nytt bolag behöver bank, redovisningsbyrå, försäkring, IT och lokal. founded_after listar bolag som registrerats från ett visst datum utan att du anger något namn, sida för sida och med de nyaste först. För varje bolag får du legal_form (till exempel AB, HB eller KB), adress och ort, region (län) där registret anger det och verksamhetsbeskrivningen business_purpose där bolaget har lämnat en.
# Bolag registrerade sedan 5 oktober, de nyaste först (100 bolag per anrop) curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=SE&founded_after=2026-10-05&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Filtrera på business_purpose och legal_form i svaret: SNI-koden (activity_code) saknas ofta hos de allra nyaste bolagen, så den går inte alltid att filtrera på. Momsnumret (vat_number) bildas av organisationsnumret och är inte bekräftat av registret (vat_number_source är rule). En sökning kostar 1 kredit för upp till 100 bolag. Vill du veta när bolaget först syntes i registerdata, ger new_incorporation i händelseflödet det datumet.
GET /insolvency/search?country=SE) är en egen källa som bevakningen inte larmar om. Att ett bolag går i likvidation, avregistreras eller försätts i konkurs syns däremot som en statusändring bland händelserna.Bevakningen kostar inga krediter: planen styr hur många konton du bevakar. En bolagssökning kostar 1 kredit och en händelsesökning 2; ett anrop som misslyckas kostar ingenting. Starter kostar 9,99 EUR i månaden med 1 000 krediter, Professional 29,99 EUR med 10 000 krediter och 250 bolag, och Scale 99,99 EUR med 50 000 krediter och 2 500 bolag; webhooks ingår i alla planer. Provperioden varar i 14 dagar och omfattar 500 krediter. Kort krävs och ingenting dras under provperioden; därefter fortsätter Starter (9,99 EUR i månaden) om du inte säger upp.
Svenska uppgifter: Contains data from Bolagsverket (the Swedish Companies Registration Office) and Statistics Sweden (SCB).
Starta 14 dagars gratis provperiod · API-dokumentation
Provperioden varar i 14 dagar och omfattar 500 krediter. Kort krävs, ingenting dras under provperioden; därefter fortsätter Starter (9,99 EUR per månad) om du inte säger upp.