POST/v1/sni/lookup

SNI-uppslag

Slå upp SNI-koder via kodnummer eller sök efter beskrivning. Användbart för autocomplete och att hitta rätt branschkod.

Översikt

SNI-uppslag-endpointen låter dig slå upp SNI-koder på två sätt: antingen genom att ange en exakt 5-siffrig kod, eller genom att söka på beskrivning/kodprefix. Detta är särskilt användbart för att bygga autocomplete-funktionalitet eller för att hitta rätt branschkod baserat på en verksamhetsbeskrivning.

Vad är SNI?

SNI (Svensk Näringsgrensindelning) är det svenska systemet för branschklassificering. Varje registrerat svenskt företag har en eller flera SNI-koder som beskriver deras affärsverksamhet.

Kreditförbrukning

1 kredit per uppslagning (fast pris, oavsett antal resultat).

Förfrågan

Förfrågningskropp

Skicka ett JSON-objekt med antingen en sökterm (q) eller en exakt SNI-kod (code):

json

// Sök på beskrivning
{
  "q": "frisör"
}

// Eller slå upp exakt kod
{
  "code": "96210"
}

Parametrar

Parameter	Typ	Obligatorisk	Beskrivning
q	string	q eller code	Sökterm som matchar kodprefix eller beskrivning (t.ex. "frisör", "konsult", "62").
code	string	q eller code	Exakt 5-siffrig SNI-kod att slå upp.
limit	number	Valfri	Max antal resultat att returnera. Standard: 20, Max: 50.

En av q eller code krävs

Du måste ange antingen q (sökterm) eller code (exakt kod). Om du anger code returneras max 1 resultat (exakt matchning).

Kodexempel

Här är exempel på flera programmeringsspråk:

curl

1
2
3
4
5
6
7
8
9
10
11# Sök på beskrivning
curl -X POST 'https://data.foretagsapi.se/v1/sni/lookup' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"q": "frisör"}'

# Eller slå upp exakt kod
curl -X POST 'https://data.foretagsapi.se/v1/sni/lookup' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"code": "96210"}'

Svar

Lyckat svar (200 OK)

Returnerar ett JSON-objekt med matchande SNI-koder:

json

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16{
  "sniCodes": [
    {
      "code": "96210",
      "description": "Frisörer"
    }
  ],
  "metadata": {
    "searchTerm": "frisör",
    "resultCount": 1,
    "creditsCharged": 1,
    "processingTimeMs": 45,
    "timestamp": "2026-01-29T12:00:00.000Z",
    "mode": "api"
  }
}

Svarsfält

Fält	Typ	Beskrivning
sniCodes	array	Array med matchande SNI-koder
sniCodes[].code	string	5-siffrig SNI-kod
sniCodes[].description	string	Beskrivning av branschklassificeringen
metadata.searchTerm	string	Söktermen eller koden som användes
metadata.resultCount	number	Antal returnerade resultat
metadata.creditsCharged	number	Antal krediter som förbrukades (alltid 1)
metadata.processingTimeMs	number	Bearbetningstid i millisekunder
metadata.timestamp	string	ISO 8601 tidsstämpel för svaret
metadata.mode	string	Alltid "api" för autentiserade anrop

Vanliga SNI-koder

Här är några vanligt använda SNI-koder som referens:

Kod	Beskrivning
62100	Dataprogrammering
62020	Datakonsultverksamhet
63100	Databehandling, hosting och liknande verksamhet
70220	Konsultverksamhet avseende företags organisation
41200	Byggande av bostadshus och andra byggnader

Felsvar

Status	Fel	Orsak
400	Missing required parameter: q (search term) or code (SNI code)	Varken q eller code angavs
405	Method not allowed	Använd POST, inte GET
429	Quota exceeded. Please upgrade your plan or wait for monthly reset.	Månatlig kvot uppnådd
500	Database error during lookup/search	Internt fel (försök igen)

Exempel på felsvar

json

{
  "error": "Missing required parameter: q (search term) or code (SNI code)"
}