API-översikt

Att financials är null betyder inte att företaget saknar omsättning. Det betyder oftast att företaget lämnat in sin årsredovisning på papper i stället för digitalt - då har vi ingen åtkomst till siffrorna.

Detaljerad finansiell data finns för cirka 60 % av aktiva aktiebolagsom lämnat in digital årsredovisning. SCB-intervall för omsättning och anställda täcker ytterligare bolag så att totalt cirka 85 % har minst en storleksindikation. Data saknas främst av följande skäl:

Pappersinlämnad årsredovisning - företaget har lämnat in på papper, inte digitalt.
Annan bolagsform än aktiebolag - t.ex. enskilda firmor och handelsbolag lämnar inte in digital årsredovisning.
Ingen nyligen inlämnad redovisning - aktiebolag som inte har ett aktuellt räkenskapsår i datasetet.
IFRS-bolag - finansiella företag vars redovisning innehåller intentionellt null-omsättning.

När data saknas returneras "financials": null och "hasDigitalAnnualReport": false. Aldrig utelämnat.

Hämta hela årsredovisningen

Utöver de strukturerade financials-fälten kan du hämta själva årsredovisningsdokumentet som iXBRL eller PDF. Lista tillgängliga år gratis och hämta ett dokument för 1 kredit. Du kan även skapa en publik delningslänk som är giltig i 24 timmar. Källa: Bolagsverket.

Varumärken (PRV)

API:et kan berika företagssvar med registrerade varumärken från PRV (Patent- och registreringsverket). Detta är ett opt-in: skicka "include": ["trademarks"] i förfrågan så läggs fälten trademarks och trademarkCount till för varje företag i svaret.

Varumärken hör till den grundläggande datanivån - uppgiften är tillgänglig för alla företag. Ett företag som inte äger något registrerat varumärke får trademarks: [] - det är ett fullständigt och korrekt svar ("detta företag har inga varumärken"), inte saknad data.

Varumärken vs. finansiell data - två olika saker

Tom trademarks: [] och financials: null betyder inte samma sak. trademarks: [] är ett definitivt svar - företaget har inga registrerade varumärken. financials: null betyder att vi saknar åtkomst till företagets finansiella data (oftast pappersinlämnad årsredovisning) - det säger ingenting om huruvida företaget har omsättning. Finansiell data är en separat, partiell datanivå.

Opt-in via include

Stöds av /v1/search (sök på namn och organisationsnummer) och /v1/bulk - för uppslag på både names och org_numbers.
Utan include saknas varumärkesfälten helt i svaret (de är inte null).
Företag utan registrerade varumärken får trademarks: [] och trademarkCount: 0.
Varumärken sorteras med senaste registreringsdatum först.
I /v1/bulk tillämpas response_fields-projektion endast på org_numbers-uppslag; där behålls varumärkesfälten i alla lägen, även minimal och core.

Källa: varumärkesdata från PRV:s varumärkesdatabas. Varumärken finns för en delmängd av företagen och utökas löpande. Se Sök på namn för den fullständiga fältbeskrivningen av varumärkesobjektet.

Storleksuppskattning (SCB)

Varje företag i ett sökresultat innehåller fälten revenue_estimate och employees_estimate - källmedvetna envelope-objekt som ger en omsättnings- respektive anställningsuppgift även när den exakta årsredovisningen saknas. De har tre varianter via fältet type:

type: "exact" - värdet kommer från företagets digitala årsredovisning. value är det exakta talet, source: "annual_report", och interval_low/interval_high är null.
type: "interval" - ett SCB-baserat storleksintervall. source: "scb", med interval_low/interval_high, ett representativt value, ett scb_class och en svensk etikett i label_sv.
type: "none" - ingen storleksuppgift finns; övriga fält är null.

Öppna toppintervall: interval_high kan vara null

Det översta SCB-intervallet är öppet uppåt. Ett storbolag kan därför returnera interval_low satt men interval_high: null (t.ex. omsättning ≥ 10 mdkr). Hantera interval_high === null som "ingen övre gräns".

Fältnamnen är snake_case

Envelope-fälten använder snake_case (revenue_estimate, employees_estimate, interval_low, interval_high, reference_year, scb_class, label_sv) till skillnad från resten av API:et som är camelCase (orgNumber, legalForm osv.). Källa: SCB (egen bearbetning).

Svarsformat

Alla svar är JSON-objekt. Lyckade svar inkluderar ett metadata-objekt med förfrågningsinformation:

json

{
  "companies": [...],
  "metadata": {
    "searchTerm": "Spotify AB",
    "searchType": "name",
    "resultCount": 5,
    "processingTimeMs": 245,
    "timestamp": "2026-01-15T10:00:00.000Z",
    "mode": "api"
  }
}

Felhantering

Felsvar inkluderar ett error-fält med en beskrivning:

json

{
  "error": "Missing required parameter: q (company name) or org_number"
}

Interaktiv testning

Använd API Playground för att testa endpoints interaktivt utan att skriva kod.