POST/v1/search

Sök på namn

Sök efter svenska företag på namn.

Översikt

Sök på namn-endpointen låter dig söka efter svenska företag med deras registrerade namn. API:et hittar relevanta resultat även med partiella namn.

Autentisering krävs

Denna endpoint kräver autentisering med en API-nyckel. Registrera ett gratis konto för att komma igång.

Kreditförbrukning

1 kredit per förfrågan (oavsett antal resultat som returneras). En sökning på "Spotify" som returnerar 5 matchande företag förbrukar endast 1 kredit.

Finansiell data: partiell täckning

Svaret inkluderar alltid financials och hasDigitalAnnualReport per företag. Att financials är null betyder inte att företaget saknar omsättning. Oftast har företaget lämnat in sin årsredovisning på papper i stället för digitalt, och då har vi ingen åtkomst till siffrorna. Detaljerad finansiell data finns för cirka 60 % av aktiva aktiebolag som lämnat in digital årsredovisning. SCB-intervall täcker ytterligare bolag, totalt cirka 85 %. Data kan även saknas för andra bolagsformer än aktiebolag eller för IFRS-bolag utan omsättning.

Varumärkesdata (PRV)

Skicka "include": ["trademarks"] för att berika varje företag i svaret med dess registrerade varumärken från PRV (Patent- och registreringsverket). Detta är ett opt-in — utan include ingår inga varumärkesfält i svaret. Kreditkostnaden påverkas inte.

Förfrågan

Förfrågningskropp

Skicka ett JSON-objekt med sökfrågan:

json

{
  "q": "Spotify AB",
  "limit": 5
}

Lägg till include för att berika svaret med varumärkesdata:

json

{
  "q": "Spotify AB",
  "limit": 5,
  "include": ["trademarks"]
}

Parametrar

Parameter	Typ	Obligatorisk	Beskrivning
q	string	Obligatorisk	Företagsnamnet att söka efter. Stödjer partiella namn.
limit	number	Valfri	Max antal resultat att returnera. Standard: 10, Max: 10.
has_annual_report	boolean	Valfri	Filtrera på om företaget har digital årsredovisning. `true` = enbart företag med årsredovisning, `false` = enbart utan. Utelämnas = alla. Standard: ej satt (alla).
include	string[]	Valfri	Opt-in-väljare för berikad data. Stödjer för närvarande `"trademarks"` — lägger till fälten `trademarks` och `trademarkCount` per företag. Okända värden ignoreras.

Kodexempel

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

curl

curl -X POST 'https://data.foretagsapi.se/v1/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"q": "Spotify AB"}'

Svar

Lyckat svar (200 OK)

Returnerar ett JSON-objekt som innehåller en array med matchande företag och metadata:

json

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91{
  "companies": [
    {
      "id": 521294,
      "name": "Spotify AB",
      "orgNumber": "5567037485",
      "legalForm": "AB",
      "postalAddress": {
        "street": "Regeringsgatan 19",
        "city": "STOCKHOLM",
        "postalCode": "11153"
      },
      "registrationDate": "2006-05-10",
      "deregistrationDate": null,
      "deregistrationReason": null,
      "businessDescription": "Bolaget har till föremål för sin verksamhet att bedriva Internetrelaterade tjänster inom digitala medier som musik, spel och TV...",
      "ongoingRestructuring": null,
      "ftgstat": 1,
      "jestat": 1,
      "jurform": 49,
      "reklamsparr": 1,
      "sniCodes": {
        "sni1": "60100",
        "sni2": null,
        "sni3": null,
        "sni4": null,
        "sni5": null,
        "sni1_name": "Radiosändning och distribution av ljudinspelningar",
        "sni2_name": null,
        "sni3_name": null,
        "sni4_name": null,
        "sni5_name": null
      },
      "hasDigitalAnnualReport": false,
      "financials": null,
      "revenue_estimate": {
        "value": 10000000000,
        "type": "interval",
        "interval_low": 10000000000,
        "interval_high": null,
        "reference_year": 2025,
        "source": "scb",
        "scb_class": "fin_21",
        "label_sv": "≥ 10 mdkr"
      },
      "employees_estimate": {
        "value": 1100,
        "type": "interval",
        "interval_low": 1000,
        "interval_high": 1499,
        "source": "scb",
        "scb_class": "anst_10",
        "label_sv": "1 000–1 499 anställda"
      },
      "score": 1.0,
      "trademarkCount": 2,
      "trademarks": [
        {
          "prvId": "2015-01234",
          "registrationNumber": "543210",
          "markText": "SPOTIFY",
          "markFeature": "Word",
          "markStatus": "Registered",
          "applicationDate": "2015-02-10",
          "registrationDate": "2015-08-21",
          "expiryDate": "2025-02-10",
          "niceClasses": [9, 38, 41]
        },
        {
          "prvId": "2012-00099",
          "registrationNumber": "498765",
          "markText": null,
          "markFeature": "Figurative",
          "markStatus": "Registered",
          "applicationDate": "2012-05-03",
          "registrationDate": "2012-11-30",
          "expiryDate": "2022-05-03",
          "niceClasses": [9]
        }
      ]
    }
  ],
  "metadata": {
    "searchTerm": "Spotify AB",
    "searchType": "name",
    "resultCount": 1,
    "processingTimeMs": 45,
    "timestamp": "2024-01-15T10:30:00Z",
    "mode": "api"
  }
}

Varumärkesfält endast med include

Fälten trademarks och trademarkCount ovan ingår enbart när förfrågan skickade "include": ["trademarks"]. Utan include saknas fälten helt (de är inte null). Varumärken hör till den grundläggande datanivån och är tillgängliga för alla företag. Ett tomt trademarks: [] är ett definitivt svar ("företaget har inga registrerade varumärken"), inte saknad data.

Svarsfält

Fält	Typ	Beskrivning
companies	array	Array med matchande företagsobjekt
score	number	Matchningspoäng från 0.0 till 1.0. Högre poäng indikerar bättre matchningar. En poäng på 1.0 betyder en exakt träff.
metadata	object	Metadata om förfrågan inklusive searchTerm, searchType, resultCount, processingTimeMs (behandlingstid i millisekunder), timestamp (ISO 8601-format) och mode

Score-fältet

Fältet score indikerar hur väl företagsnamnet matchar din sökfråga. Använd det för att sortera eller filtrera resultat baserat på relevans.

Företagsobjekt

Varje företag i resultatarrayen innehåller följande fält:

Fält	Typ	Beskrivning
id	number	Internt databas-ID
name	string	Officiellt registrerat företagsnamn
orgNumber	string	10-siffrigt svenskt organisationsnummer (utan bindestreck)
legalForm	string	Juridisk form som textkod (kortform). Vanliga värden: AB (Aktiebolag), HB (Handelsbolag), KB (Kommanditbolag), BRF (Bostadsrättsförening), EK (Ekonomisk förening). Offentliga organisationer, som inte registreras hos Bolagsverket, hämtas från SCB och har koderna KOMMUN, REGION, STAT (statlig enhet), KOMMUNALFORBUND, OFFENTLIG (offentlig korporation eller anstalt) och HYPOTEKSFORENING. Enskilda firmor ingår för närvarande inte i datasetet.
postalAddress	object	Adressobjekt med fälten street, city och postalCode
registrationDate	string	ISO-datum för företagsregistrering
deregistrationDate	string \| null	ISO-datum om företaget är avregistrerat, annars null
deregistrationReason	string \| null	Orsakskod vid avregistrering. Vanliga värden: KKAV-AVORG (konkursavslut), FUAV-AVORG (fusion), LIAV-AVORG (likvidation), AKEJH-AVORG (avförd ej registreringspliktig). Null om ej avregistrerat.
businessDescription	string	Företagets registrerade verksamhetsbeskrivning
sniCodes	object	Objekt med sni1-sni5 (5-siffriga SNI-koder) och sni1_name-sni5_name (branschnamn).
score	number	Matchningspoäng 0.0-1.0 (endast sökresultat)
ftgstat	number	F-skattestatus (0=aldrig, 1=aktiv, 9=inaktiv)
jestat	number \| null	Status för juridisk enhet (1=aktiv, null=ej tillgänglig)
jurform	number \| null	Juridisk formkod (numerisk). Vanliga värden: 10=Enskild firma, 31=Handelsbolag, 49=Aktiebolag, 51=Ekonomisk förening. Se även legalForm för textkod.
reklamsparr	number	Reklamspärr (0=okänd, 1=ingen spärr, 2=spärrad). Värdet 2 betyder att mottagaren har avsagt sig direktreklam via post, telefon eller kombo. Gäller ej e-post. Källa: Bolagsverket och SCB.
ongoingRestructuring	string \| null	Kod för pågående avvecklings- eller rekonstruktionsförfarande. Vanliga prefix: LI=likvidation, KK=konkurs, FR=företagsrekonstruktion, FUOL/FUOT=fusion. Formatet är "\|KOD-AVOMFO$datum". Null om inget pågår.
hasDigitalAnnualReport	boolean	Sant om företaget har lämnat in digital årsredovisning och finansiell data finns i systemet. Falskt annars. Alltid med i svaret, aldrig utelämnat.
financials	object \| null	Finansiell data från senaste årsredovisning, eller `null` om data saknas. Fält: `year`, `fiscalYearStart`, `fiscalYearEnd`, `revenue`, `operatingResult`, `netResult`, `totalAssets`, `equity`, `solidity`, `employees`, med mera. Alla belopp i hela SEK (bigint). Negativa värden är legitima.
revenue_estimate	object	Källmedveten omsättnings-envelope. `type: "exact"` = värdet kommer från digital årsredovisning (samma som `financials.revenue`). `type: "interval"` = SCB-baserad omsättningsklass; `interval_low`/`interval_high` ger bandets gränser, `label_sv` är en färdigformaterad svensk etikett (t.ex. "1-5 Mkr" eller "≥ 10 mdkr"). `type: "none"` = ingen storleksuppgift finns. Övriga fält: `value`, `source` ("annual_report"\|"scb"\|null), `reference_year`, `scb_class`.
employees_estimate	object	Källmedveten anställda-envelope. Samma struktur som `revenue_estimate` men för antal anställda (saknar `reference_year`). För bolag med digital årsredovisning är `value` samma som `financials.employees`. För bolag utan AR finns ofta ett SCB-intervall (BRF, HB, KB och ekonomiska föreningar omfattas).
trademarks	array	Array med företagets registrerade varumärken (PRV). Endast med när `include` innehåller `"trademarks"` — annars utelämnat. Tom array om företaget saknar varumärken. Sorteras med senaste registreringsdatum först.
trademarkCount	number	Antal varumärken i `trademarks`-arrayen. Endast med när `include` innehåller `"trademarks"`. `0` om företaget saknar varumärken.

Varumärkesobjekt

Varje post i trademarks-arrayen beskriver ett registrerat varumärke hos PRV (Patent- och registreringsverket):

Fält	Typ	Beskrivning
prvId	string	PRV:s interna identifierare för varumärket
registrationNumber	string \| null	Officiellt registreringsnummer hos PRV
markText	string \| null	Varumärkets ordtext. `null` för rent figurativa varumärken (logotyper utan text).
markFeature	string \| null	Varumärkestyp. Vanliga värden: `Word` (ordmärke), `Figurative` (figurmärke), `Combined` (kombinerat ord- och figurmärke).
markStatus	string \| null	Varumärkets status, t.ex. `Registered`.
applicationDate	string \| null	ISO-datum för ansökan
registrationDate	string \| null	ISO-datum för registrering
expiryDate	string \| null	ISO-datum då registreringen löper ut
niceClasses	number[]	Nice-klassificering — array med varu- och tjänsteklasser (1–45) som varumärket omfattar. Tom array om okänt.

Felsvar

400 Bad Request

Returneras när förfrågningskroppen är ogiltig eller parametern q saknas:

json

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

429 Too Many Requests

Returneras när du överskrider hastighetsgränsen för din nivå:

json

{
  "error": "Rate limit exceeded. Please wait and retry."
}