För utvecklare och AI-agenter

API och MCP

Samma bolagsdata som på sajten, som REST-API och som MCP-server för Claude och andra AI-agenter. Varje svar anger källa och uppdateringsdatum.

Gratis

1 000 anrop/mån

Ingen kortuppgift. Kvoten nollställs den 1:a varje månad (UTC).

Därefter

Pris per 1 000 anrop

Publiceras öppet, utan bindningstid eller säljsamtal.

MCP

Öppen källkod

Paketet @bolagen/mcp, MIT-licens.

Kom igång

Alla anrop kräver en API-nyckel som börjar med blg_. Skicka den i headern Authorization: Bearer eller X-API-Key. Nyckeln visas en gång när den skapas; vi sparar bara en hash. Under betan delas nycklar ut manuellt.

curl -H "Authorization: Bearer $BOLAGEN_API_KEY" \
  "https://bolagen.ai/api/v1/companies/556677-8899/financials?years=3"

Svaren är JSON med snake_case-fält. Belopp är i kronor (SEK), inte tkr. Organisationsnummer tas emot med eller utan bindestreck. Varje svar har headrarna X-RateLimit-Remaining och X-RateLimit-Reset.

{
  "error": { "code": "quota_exceeded", "message": "Monthly quota of 1000 calls used up. …" }
}

Felkoder: 400 bad_request, 401 missing_api_key / invalid_api_key, 404 not_found, 429 quota_exceeded.

Endpoints

Bas-URL https://bolagen.ai/api/v1. Fullständiga scheman finns i OpenAPI-dokumentet.

GET/search?q={namn eller orgnr}&type=companies|people|all&limit=10

Sök bolag på namn eller organisationsnummer, och personer på namn.

MCP-verktyg: search_companies

GET/companies/{orgnr}

Bolagsprofil: status, bolagsform, SNI, adress, registreringar, koncern och senaste nyckeltal.

MCP-verktyg: get_company

GET/companies/{orgnr}/financials?years=10

Bokslut per år i kronor, med beräknade nyckeltal och formler.

MCP-verktyg: get_financials

GET/companies/{orgnr}/roles?current=true

Styrelse, VD, revisorer och firmatecknare, med från- och tilldatum.

MCP-verktyg: get_people

GET/companies/{orgnr}/events

De 30 senaste händelserna: styrelseändringar, årsredovisningar, statusändringar.

MCP-verktyg: get_events

GET/people/{id}

En persons uppdrag och nätverk av styrelsekollegor.

MCP-verktyg: get_people

GET/usage

Nyckelns förbrukning denna månad.

Nyckeltal

/financials räknar nyckeltalen per år mot föregående år. Procent anges som tal (12,5 betyder 12,5 %). Saknas underlag blir värdet null, aldrig en gissning.

Omsättningstillväxt: (Omsättning år t − omsättning år t−1) / omsättning år t−1
Rörelsemarginal: Rörelseresultat / nettoomsättning
Vinstmarginal: Resultat efter finansiella poster / nettoomsättning
Soliditet: (Eget kapital + 79,4 % av obeskattade reserver) / summa tillgångar
Kassalikviditet: (Omsättningstillgångar − varulager) / kortfristiga skulder
Avkastning på eget kapital: Resultat efter finansiella poster / justerat eget kapital
Omsättning per anställd: Nettoomsättning / medelantal anställda

MCP-server

MCP-servern ger AI-agenter verktygen search_companies, get_company, get_financials, get_people och get_events. Den anropar samma API och räknas mot samma kvot.

Claude Code:

claude mcp add bolagen -e BOLAGEN_API_KEY=blg_... -- npx -y @bolagen/mcp

Claude Desktop och andra klienter:

{
  "mcpServers": {
    "bolagen": {
      "command": "npx",
      "args": ["-y", "@bolagen/mcp"],
      "env": { "BOLAGEN_API_KEY": "blg_..." }
    }
  }
}

Data och regler

Källor: Bolagsverket (register och iXBRL-årsredovisningar) och SCB. Varje svar har ett source-fält. Bolagsverket kräver att källan anges när du visar datan.
Personuppgifter begränsas till namn, födelseår och roller. Personnummer, hemadress och inkomst finns inte. Personer med skyddade personuppgifter returneras aldrig.
Poster med is_fixture: true är påhittade exempelbolag för demo och test.