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 utan bindestreck eller mellanslag. Till exempel: 5567037485 (Spotify AB).

Kreditförbrukning

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

Förfrågan

Förfrågningskropp

Skicka ett JSON-objekt med organisationsnumret:

json

{
  "org_number": "5567037485"
}

Parametrar

Parameter	Typ	Obligatorisk	Beskrivning
org_number	string	Obligatorisk	Det 10-siffriga organisationsnumret att slå upp. Måste vara exakt 10 siffror utan bindestreck eller mellanslag.

Formatkrav

Organisationsnumret måste vara exakt 10 siffror. Vanliga format som556703-7485 med bindestreck ska konverteras till 5567037485 innan förfrågan görs.

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{
  "companies": [
    {
      "id": 521294,
      "name": "Spotify AB",
      "orgNumber": "5567037485",
      "legalForm": "AB-ORGFO",
      "postalAddress": {
        "street": "Regeringsgatan 19",
        "city": "Stockholm",
        "postalCode": "11153"
      },
      "registrationDate": "2006-04-18",
      "deregistrationDate": null,
      "deregistrationReason": null,
      "businessDescription": "Utveckling av internettjänst...",
      "ongoingRestructuring": null,
      "ftgstat": 1,
      "jestat": 1,
      "jurform": 49,
      "reklamsparr": 0,
      "sniCodes": {
        "sni1": "63100",
        "sni2": "58210",
        "sni3": null,
        "sni4": null,
        "sni5": null,
        "sni1_name": "Databehandling, hosting o.d.",
        "sni2_name": "Utgivning av programvara",
        "sni3_name": null,
        "sni4_name": null,
        "sni5_name": null
      },
      "score": 1.0
    }
  ],
  "metadata": {
    "searchTerm": "5567037485",
    "searchType": "org_number",
    "resultCount": 1,
    "processingTimeMs": 23,
    "timestamp": "2024-01-15T10:32:00Z",
    "mode": "api"
  }
}

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"
  }
}

Felsvar

400 Bad Request

Returneras när organisationsnummerformatet är ogiltigt:

json

{
  "error": "Invalid org_number format. Must be exactly 10 digits."
}