# getBolag

> getBolag (getbolag.se) säljer svensk bolagsdata via REST-API och MCP till svenska företag för internt bruk: bolag, styrelser och roller, historik och bokslut. Datan levereras av Creditsafe i Sverige AB, och Bolagskällan AB (559555-5946) är återförsäljare; getBolag är ett varumärke i Bolagskällan AB. Live-data öppnas efter granskning; testnycklar (gb_test_…) fungerar mot en sandlåda med påhittade bolag.

REST-API: http://localhost:3020/api/v1 (Authorization: Bearer gb_live_… eller gb_test_…). MCP: http://localhost:3020/mcp (Streamable HTTP, OAuth 2.1 eller API-nyckel). Exemplen i dokumentationen är riktiga svar från sandlådan.

## Kom igång

- [Kom igång på fem minuter](http://localhost:3020/docs/md/index.md): Skapa konto, hämta en testnyckel och gör ditt första anrop mot sandlådan med curl, JavaScript eller Python.
- [Autentisering](http://localhost:3020/docs/md/autentisering.md): API-nycklar för live och test, scopes, en nyckel per användare, rotation och OAuth för MCP-klienter.
- [Sandlådan](http://localhost:3020/docs/md/sandlada.md): Påhittade bolag och personer för testnycklar. Live-data öppnas efter granskning.

## REST-API

- [REST-API](http://localhost:3020/docs/md/api.md): Bas-URL, endpoints, operationer och priser i REST-API:t v1.
- [Sök bolag](http://localhost:3020/docs/md/api/sok-bolag.md): Hitta bolag på namn eller organisationsnummer. Högst tio träffar. Gratis, upp till 1 000 sökningar per dygn.
- [Hämta bolag](http://localhost:3020/docs/md/api/bolag.md): Bolagsprofil: namn, form, status, säte och bransch. Med detail=full även adresser, F-skatt, moms, verksamhet, tidigare namn och aktiekapital.
- [Styrelse och roller](http://localhost:3020/docs/md/api/roller.md): Styrelse, VD, suppleanter och revisor med person_ref, och bolagets firmateckning.
- [Historik och ändringar](http://localhost:3020/docs/md/api/historik.md): Registrerade ändringar (styrelse, adress, årsredovisning med mera) sedan ett datum, och bolagets statushistorik.
- [Bokslut och nyckeltal](http://localhost:3020/docs/md/api/bokslut.md): Resultat- och balansräkning i tusental kronor och nyckeltal för upp till fem år. Bara aktiebolag.
- [Personers engagemang](http://localhost:3020/docs/md/api/engagemang.md): Alla bolag där en person har eller har haft ett uppdrag. Personen anges med person_ref från ett rollsvar.
- [Konto och saldo](http://localhost:3020/docs/md/api/konto.md): Ditt konto, saldot, månadens förbrukning och nyckelns scopes och miljö. Gratis och mäts inte.

## Referens

- [Svarsformat](http://localhost:3020/docs/md/svarsformat.md): status, data och meta, täckningsstatus per sektion, attribution, cost_sek, request_id och vad null betyder.
- [Felkoder](http://localhost:3020/docs/md/fel.md): Alla felkoder i API:t och MCP med HTTP-status, betydelse och vad du gör.
- [Takt och tak](http://localhost:3020/docs/md/takt-och-tak.md): Anrop per minut, sökkvot, tak på antal bolag per dygn, månadstak, dygnstak per nyckel och Idempotency-Key.
- [Priser](http://localhost:3020/docs/md/priser.md): Pris per uppslag i kronor. Sök och konto är gratis, och inte hittat debiteras inte.

## MCP

- [MCP](http://localhost:3020/docs/md/mcp.md): Anslut Claude, Claude Code och Cursor till getBolag via MCP, med OAuth eller API-nyckel. Verktyg och parametrar.

## Regler

- [Personuppgifter](http://localhost:3020/docs/md/personuppgifter.md): person_ref i stället för personnummer, enskilda firmor och ditt ansvar för personuppgifterna du hämtar.
- [Villkor och källor](http://localhost:3020/docs/md/villkor-och-kallor.md): Internt bruk, Creditsafe som leverantör, attribution som ska behållas och regler för lagring.

## Övrigt

- [Changelog](http://localhost:3020/docs/md/changelog.md): Ändringar i API:t, MCP-servern och dokumentationen, och hur vi fasar ut gamla versioner.

## Optional

- [OpenAPI-specifikation](http://localhost:3020/openapi.json): REST-API:t v1 som OpenAPI 3.
- [Hela dokumentationen](http://localhost:3020/llms-full.txt): alla sidor ovan i en fil.
- [Villkor](http://localhost:3020/villkor): villkoren som gäller för tjänsten.