{
  "info": {
    "_postman_id": "foretagsapi-collection-v1",
    "name": "FöretagsAPI",
    "description": "Ett enkelt API för svensk företagsdata.\n\n## Kom igång\n1. Skapa ett konto på https://foretagsapi.se\n2. Gå till Dashboard och skapa en API-nyckel\n3. Kopiera din nyckel och sätt den som variabeln `FAPI_KEY`\n\n## Miljövariabler\n- `FAPI_KEY`: Din API-nyckel (börjar med `fapi_`)\n- `BASE_URL`: https://data.foretagsapi.se (redan inställd)\n\n## Kreditförbrukning\n- Sök: 1 kredit per sökning\n- Bulk: 1 kredit per lyckat uppslag\n- SNI-sökning: 1 kredit per returnerat företag\n- SNI-uppslag: 1 kredit per sökning",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "BASE_URL",
      "value": "https://data.foretagsapi.se",
      "type": "string"
    },
    {
      "key": "FAPI_KEY",
      "value": "fapi_your_api_key_here",
      "type": "string"
    }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{FAPI_KEY}}",
        "type": "string"
      }
    ]
  },
  "item": [
    {
      "name": "Search",
      "description": "Sök efter företag på namn eller organisationsnummer",
      "item": [
        {
          "name": "Sök på företagsnamn",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"q\": \"Spotify AB\",\n  \"limit\": 5\n}"
            },
            "url": {
              "raw": "{{BASE_URL}}/v1/search",
              "host": ["{{BASE_URL}}"],
              "path": ["v1", "search"]
            },
            "description": "Sök efter företag på namn med fuzzy-matchning.\n\n**Kreditförbrukning:** 1 kredit per sökning\n\n**Parametrar:**\n- `q`: Företagsnamn att söka på\n- `limit`: Max antal resultat (1-10)"
          },
          "response": [
            {
              "name": "Lyckad sökning",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "body": {
                  "mode": "raw",
                  "raw": "{\"q\": \"Spotify AB\", \"limit\": 1}"
                },
                "url": {
                  "raw": "{{BASE_URL}}/v1/search",
                  "host": ["{{BASE_URL}}"],
                  "path": ["v1", "search"]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "body": "{\n  \"companies\": [\n    {\n      \"id\": 521294,\n      \"name\": \"Spotify AB\",\n      \"orgNumber\": \"5567037485\",\n      \"legalForm\": \"AB-ORGFO\",\n      \"postalAddress\": {\n        \"street\": \"Regeringsgatan 19\",\n        \"postalCode\": \"11153\",\n        \"city\": \"STOCKHOLM\"\n      },\n      \"registrationDate\": \"2006-05-10\",\n      \"deregistrationDate\": null,\n      \"deregistrationReason\": null,\n      \"businessDescription\": \"Bolaget har till föremål för sin verksamhet att bedriva Internetrelaterade tjänster inom digitala medier som musik, spel och TV...\",\n      \"ongoingRestructuring\": null,\n      \"ftgstat\": 1,\n      \"jestat\": 1,\n      \"jurform\": 49,\n      \"reklamsparr\": 1,\n      \"sniCodes\": {\n        \"sni1\": \"63100\",\n        \"sni2\": null,\n        \"sni3\": null,\n        \"sni4\": null,\n        \"sni5\": null,\n        \"sni1_name\": null,\n        \"sni2_name\": null,\n        \"sni3_name\": null,\n        \"sni4_name\": null,\n        \"sni5_name\": null\n      },\n      \"score\": 1.0\n    }\n  ],\n  \"metadata\": {\n    \"searchTerm\": \"Spotify AB\",\n    \"searchType\": \"name\",\n    \"resultCount\": 1,\n    \"processingTimeMs\": 245,\n    \"timestamp\": \"2026-01-15T10:30:00.000Z\",\n    \"mode\": \"api\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Sök på organisationsnummer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"org_number\": \"5567037485\"\n}"
            },
            "url": {
              "raw": "{{BASE_URL}}/v1/search",
              "host": ["{{BASE_URL}}"],
              "path": ["v1", "search"]
            },
            "description": "Slå upp ett företag på exakt organisationsnummer.\n\n**Kreditförbrukning:** 1 kredit per sökning\n\n**Parametrar:**\n- `org_number`: 10-siffrigt organisationsnummer utan bindestreck"
          },
          "response": [
            {
              "name": "Lyckad uppslag",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "body": {
                  "mode": "raw",
                  "raw": "{\"org_number\": \"5567037485\"}"
                },
                "url": {
                  "raw": "{{BASE_URL}}/v1/search",
                  "host": ["{{BASE_URL}}"],
                  "path": ["v1", "search"]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "body": "{\n  \"companies\": [\n    {\n      \"id\": 521294,\n      \"name\": \"Spotify AB\",\n      \"orgNumber\": \"5567037485\",\n      \"legalForm\": \"AB-ORGFO\",\n      \"postalAddress\": {\n        \"street\": \"Regeringsgatan 19\",\n        \"postalCode\": \"11153\",\n        \"city\": \"STOCKHOLM\"\n      },\n      \"registrationDate\": \"2006-05-10\",\n      \"deregistrationDate\": null,\n      \"deregistrationReason\": null,\n      \"businessDescription\": \"Bolaget har till föremål för sin verksamhet att bedriva Internetrelaterade tjänster inom digitala medier som musik, spel och TV...\",\n      \"ongoingRestructuring\": null,\n      \"ftgstat\": 1,\n      \"jestat\": 1,\n      \"jurform\": 49,\n      \"reklamsparr\": 1,\n      \"sniCodes\": {\n        \"sni1\": \"63100\",\n        \"sni2\": null,\n        \"sni3\": null,\n        \"sni4\": null,\n        \"sni5\": null,\n        \"sni1_name\": null,\n        \"sni2_name\": null,\n        \"sni3_name\": null,\n        \"sni4_name\": null,\n        \"sni5_name\": null\n      }\n    }\n  ],\n  \"metadata\": {\n    \"searchTerm\": \"5567037485\",\n    \"searchType\": \"org_number\",\n    \"resultCount\": 1,\n    \"processingTimeMs\": 45,\n    \"timestamp\": \"2026-01-15T10:30:00.000Z\",\n    \"mode\": \"api\"\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Bulk",
      "description": "Slå upp flera företag samtidigt",
      "item": [
        {
          "name": "Bulkuppslag",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"names\": [\n    \"Spotify AB\",\n    \"Volvo AB\",\n    \"IKEA AB\"\n  ]\n}"
            },
            "url": {
              "raw": "{{BASE_URL}}/v1/bulk",
              "host": ["{{BASE_URL}}"],
              "path": ["v1", "bulk"]
            },
            "description": "Slå upp flera företag samtidigt på namn.\n\n**Kreditförbrukning:** 1 kredit per lyckat uppslag\n\n**Begränsningar:**\n- Gäster: Max 10 företag\n- API: Max 100 företag\n\n**Parametrar:**\n- `names`: Array med företagsnamn"
          },
          "response": [
            {
              "name": "Lyckad bulkuppslag",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "body": {
                  "mode": "raw",
                  "raw": "{\"names\": [\"Spotify AB\", \"Volvo AB\"]}"
                },
                "url": {
                  "raw": "{{BASE_URL}}/v1/bulk",
                  "host": ["{{BASE_URL}}"],
                  "path": ["v1", "bulk"]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "body": "{\n  \"results\": [\n    {\n      \"searchTerm\": \"Spotify AB\",\n      \"company\": {\n        \"id\": 521294,\n        \"name\": \"Spotify AB\",\n        \"orgNumber\": \"5567037485\",\n        \"legalForm\": \"AB-ORGFO\",\n        \"postalAddress\": {\n          \"street\": \"Regeringsgatan 19\",\n          \"postalCode\": \"11153\",\n          \"city\": \"STOCKHOLM\"\n        },\n        \"registrationDate\": \"2006-05-10\",\n        \"deregistrationDate\": null,\n        \"deregistrationReason\": null,\n        \"businessDescription\": \"Bolaget har till föremål för sin verksamhet att bedriva Internetrelaterade tjänster inom digitala medier...\",\n        \"ongoingRestructuring\": null,\n        \"ftgstat\": 1,\n        \"jestat\": 1,\n        \"jurform\": 49,\n        \"reklamsparr\": 1,\n        \"sniCodes\": {\n          \"sni1\": \"63100\",\n          \"sni2\": null,\n          \"sni3\": null,\n          \"sni4\": null,\n          \"sni5\": null,\n          \"sni1_name\": null,\n          \"sni2_name\": null,\n          \"sni3_name\": null,\n          \"sni4_name\": null,\n          \"sni5_name\": null\n        },\n        \"score\": 1.0\n      },\n      \"success\": true\n    },\n    {\n      \"searchTerm\": \"Volvo AB\",\n      \"company\": {\n        \"id\": 1357434,\n        \"name\": \"Aktiebolaget Volvo\",\n        \"orgNumber\": \"5560125790\",\n        \"legalForm\": \"AB-ORGFO\",\n        \"postalAddress\": {\n          \"street\": \"N/A\",\n          \"postalCode\": \"40508\",\n          \"city\": \"GÖTEBORG\"\n        },\n        \"registrationDate\": \"1915-05-05\",\n        \"deregistrationDate\": null,\n        \"deregistrationReason\": null,\n        \"businessDescription\": \"Bolaget skall - direkt eller genom dotterbolag - bedriva verksamhet företrädesvis inom affärsområdena transportmedel, livsmedel, energi och finans...\",\n        \"ongoingRestructuring\": null,\n        \"ftgstat\": 1,\n        \"jestat\": 1,\n        \"jurform\": 49,\n        \"reklamsparr\": 1,\n        \"sniCodes\": {\n          \"sni1\": \"70100\",\n          \"sni2\": null,\n          \"sni3\": null,\n          \"sni4\": null,\n          \"sni5\": null,\n          \"sni1_name\": null,\n          \"sni2_name\": null,\n          \"sni3_name\": null,\n          \"sni4_name\": null,\n          \"sni5_name\": null\n        },\n        \"score\": 1.0\n      },\n      \"success\": true\n    }\n  ],\n  \"metadata\": {\n    \"processingTimeMs\": 456,\n    \"totalSearches\": 2,\n    \"successfulSearches\": 2,\n    \"timestamp\": \"2026-01-15T10:30:00.000Z\",\n    \"mode\": \"api\"\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "SNI",
      "description": "Sök och slå upp SNI-koder (branschkoder)",
      "item": [
        {
          "name": "SNI-uppslag (sök på beskrivning)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"q\": \"frisör\",\n  \"limit\": 10\n}"
            },
            "url": {
              "raw": "{{BASE_URL}}/v1/sni/lookup",
              "host": ["{{BASE_URL}}"],
              "path": ["v1", "sni", "lookup"]
            },
            "description": "Sök efter SNI-koder på beskrivning.\nAnvändbart för autocomplete i formulär.\n\n**Kreditförbrukning:** 1 kredit per sökning\n\n**Parametrar:**\n- `q`: Sökterm\n- `limit`: Max antal resultat (1-50)"
          },
          "response": [
            {
              "name": "Lyckad SNI-uppslag",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "body": {
                  "mode": "raw",
                  "raw": "{\"q\": \"frisör\"}"
                },
                "url": {
                  "raw": "{{BASE_URL}}/v1/sni/lookup",
                  "host": ["{{BASE_URL}}"],
                  "path": ["v1", "sni", "lookup"]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "body": "{\n  \"sniCodes\": [\n    {\n      \"code\": \"96210\",\n      \"description\": \"Frisörer och barberare\"\n    }\n  ],\n  \"metadata\": {\n    \"searchTerm\": \"frisör\",\n    \"resultCount\": 1,\n    \"creditsCharged\": 1,\n    \"processingTimeMs\": 45,\n    \"timestamp\": \"2026-01-15T10:30:00.000Z\",\n    \"mode\": \"api\"\n  }\n}"
            }
          ]
        },
        {
          "name": "SNI-uppslag (exakt kod)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"code\": \"96210\"\n}"
            },
            "url": {
              "raw": "{{BASE_URL}}/v1/sni/lookup",
              "host": ["{{BASE_URL}}"],
              "path": ["v1", "sni", "lookup"]
            },
            "description": "Slå upp beskrivning för en exakt SNI-kod.\n\n**Kreditförbrukning:** 1 kredit per sökning\n\n**Parametrar:**\n- `code`: 5-siffrig SNI-kod"
          },
          "response": [
            {
              "name": "Lyckad koduppslag",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "body": {
                  "mode": "raw",
                  "raw": "{\"code\": \"96210\"}"
                },
                "url": {
                  "raw": "{{BASE_URL}}/v1/sni/lookup",
                  "host": ["{{BASE_URL}}"],
                  "path": ["v1", "sni", "lookup"]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "body": "{\n  \"sniCodes\": [\n    {\n      \"code\": \"96210\",\n      \"description\": \"Frisörer och barberare\"\n    }\n  ],\n  \"metadata\": {\n    \"searchTerm\": \"96210\",\n    \"resultCount\": 1,\n    \"creditsCharged\": 1,\n    \"processingTimeMs\": 12,\n    \"timestamp\": \"2026-01-15T10:30:00.000Z\",\n    \"mode\": \"api\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Sök företag på SNI-kod",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"sni_code\": \"70200\",\n  \"city\": \"Stockholm\",\n  \"limit\": 10,\n  \"offset\": 0,\n  \"active_only\": true\n}"
            },
            "url": {
              "raw": "{{BASE_URL}}/v1/sni/search",
              "host": ["{{BASE_URL}}"],
              "path": ["v1", "sni", "search"]
            },
            "description": "Sök efter företag med en specifik SNI-kod.\n\n**OBS:** Endast 5-siffriga subklasskoder fungerar.\n\n**Kreditförbrukning:** 1 kredit per returnerat företag\n\n**Parametrar:**\n- `sni_code`: 5-siffrig SNI-kod (obligatorisk)\n- `city`: Filtrera på stad (rekommenderas för populära koder)\n- `limit`: Max antal resultat (1-100)\n- `offset`: Offset för paginering\n- `active_only`: Endast aktiva företag (default: true)"
          },
          "response": [
            {
              "name": "Lyckad SNI-sökning",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "body": {
                  "mode": "raw",
                  "raw": "{\"sni_code\": \"70200\", \"city\": \"Stockholm\", \"limit\": 2}"
                },
                "url": {
                  "raw": "{{BASE_URL}}/v1/sni/search",
                  "host": ["{{BASE_URL}}"],
                  "path": ["v1", "sni", "search"]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "body": "{\n  \"companies\": [\n    {\n      \"id\": 811187,\n      \"name\": \"Konsultbolaget AB\",\n      \"orgNumber\": \"5590512769\",\n      \"legalForm\": \"AB-ORGFO\",\n      \"postalAddress\": {\n        \"street\": \"Lützengatan 1 Lgh 1402\",\n        \"postalCode\": \"11520\",\n        \"city\": \"STOCKHOLM\"\n      },\n      \"registrationDate\": \"2016-02-15\",\n      \"deregistrationDate\": null,\n      \"deregistrationReason\": null,\n      \"businessDescription\": \"Bolaget ska bedriva försäljning och tillhandahållande av utbildning och konsulttjänster inom IT, affärsutveckling...\",\n      \"ongoingRestructuring\": null,\n      \"ftgstat\": 1,\n      \"jestat\": 1,\n      \"jurform\": 49,\n      \"reklamsparr\": 1,\n      \"sniCodes\": {\n        \"sni1\": \"64994\",\n        \"sni2\": \"70200\",\n        \"sni3\": null,\n        \"sni4\": null,\n        \"sni5\": null,\n        \"sni1_name\": null,\n        \"sni2_name\": null,\n        \"sni3_name\": null,\n        \"sni4_name\": null,\n        \"sni5_name\": null\n      },\n      \"score\": 1.0\n    }\n  ],\n  \"metadata\": {\n    \"sniCode\": \"70200\",\n    \"sniDescription\": \"Konsultverksamhet avseende företags organisation\",\n    \"city\": \"Stockholm\",\n    \"resultCount\": 1,\n    \"totalCount\": 15042,\n    \"offset\": 0,\n    \"limit\": 2,\n    \"hasMore\": true,\n    \"creditsCharged\": 1,\n    \"processingTimeMs\": 234,\n    \"timestamp\": \"2026-01-15T10:30:00.000Z\",\n    \"mode\": \"api\"\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Health",
      "description": "Kontrollera tjänstens status",
      "item": [
        {
          "name": "Hälsokontroll",
          "request": {
            "auth": {
              "type": "noauth"
            },
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{BASE_URL}}/health",
              "host": ["{{BASE_URL}}"],
              "path": ["health"]
            },
            "description": "Kontrollera om API:et är tillgängligt.\n\n**Kräver ingen autentisering.**"
          },
          "response": [
            {
              "name": "Tjänsten är tillgänglig",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{BASE_URL}}/health",
                  "host": ["{{BASE_URL}}"],
                  "path": ["health"]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "body": "{\n  \"status\": \"ok\",\n  \"timestamp\": \"2026-01-15T10:30:00.000Z\"\n}"
            }
          ]
        }
      ]
    }
  ]
}