POST/v1/search

Sök på org.nummer

Slå upp ett svenskt företag via dess 10-siffriga organisationsnummer.

Översikt

Sök på org.nummer-endpointen låter dig slå upp ett specifikt svenskt företag med dess unika 10-siffriga organisationsnummer. Detta ger en exakt matchning istället för en namnbaserad sökning.

Organisationsnummerformat

Svenska organisationsnummer är 10 siffror. Du kan skicka dem som 5567037485 eller med bindestreck som 556703-7485 (Spotify AB) - bindestreck normaliseras automatiskt.

Kreditförbrukning

1 kredit per uppslagning. Varje anrop med ett organisationsnummer förbrukar 1 kredit, oavsett om företaget hittas eller inte.

Finansiell data — partiell täckning

Svaret innehåller alltid fälten financials och hasDigitalAnnualReport. 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 svaret med företagets registrerade varumärken från PRV (Patent- och registreringsverket). Detta är ett opt-in — utan include ingår inga varumärkesfält. Kreditkostnaden påverkas inte.

Förfrågan

Förfrågningskropp

Skicka ett JSON-objekt med organisationsnumret:

json

{
  "org_number": "5567037485"
}

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

json

{
  "org_number": "5567037485",
  "include": ["trademarks"]
}

Parametrar

Parameter	Typ	Obligatorisk	Beskrivning
org_number	string	Obligatorisk	Det 10-siffriga organisationsnumret att slå upp. Format med bindestreck (`556703-7485`) normaliseras automatiskt och matchar samma företag som `5567037485`.
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.

Format med bindestreck stöds

Du kan skicka organisationsnumret antingen som 10 sammanhängande siffror (5567037485) eller med bindestreck (556703-7485). Bindestreck normaliseras automatiskt innan uppslagningen, så båda formaten matchar samma företag.

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 '{"org_number": "5567037485"}'

Svar

Lyckat svar (200 OK)

Returnerar ett JSON-objekt som innehåller det matchande företaget (om det hittas):

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{
  "companies": [
    {
      "id": 965387,
      "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...",
      "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"
      },
      "trademarkCount": 1,
      "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]
        }
      ]
    }
  ],
  "metadata": {
    "searchTerm": "5567037485",
    "searchType": "org_number",
    "resultCount": 1,
    "processingTimeMs": 23,
    "timestamp": "2024-01-15T10:32: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). Företag utan registrerade varumärken får [] respektive 0. Varje post i trademarks innehåller fälten prvId, registrationNumber, markText (null för rent figurativa märken), markFeature, markStatus, applicationDate, registrationDate, expiryDate och niceClasses. Se Sök på namn för en fullständig fältbeskrivning.

Inga resultat

Om inget företag hittas med det angivna organisationsnumret returneras en tom array:

json

{
  "companies": [],
  "metadata": {
    "searchTerm": "1234567890",
    "searchType": "org_number",
    "resultCount": 0,
    "processingTimeMs": 15,
    "timestamp": "2024-01-15T10:33:00Z",
    "mode": "api"
  }
}

Felaktigt organisationsnummer

Ett organisationsnummer som inte matchar något företag (inklusive felaktigt formaterade värden) ger inget felsvar. Endpointen returnerar 200 OK med en tom companies-array, precis som vid ett giltigt nummer utan träff:

json

{
  "companies": [],
  "metadata": {
    "searchTerm": "abc123",
    "searchType": "org_number",
    "resultCount": 0,
    "processingTimeMs": 12,
    "timestamp": "2024-01-15T10:33:00Z",
    "mode": "api"
  }
}