REST-API

Historik och ändringar

Registrerade ändringar (styrelse, adress, årsredovisning med mera) sedan ett datum, och bolagets statushistorik.

http

GET /api/v1/companies/{org_number}/history

Operation	Scope	Pris per uppslag
`get_company_history` (historik och ändringar)	`history:read`	0,50 kr

Parametrar#

Namn	Var	Typ	Standard	Beskrivning
`org_number` (krävs)	path	string	–	Organisationsnummer, tio siffror med eller utan bindestreck (`569900-0013` eller `5699000013`). Tolv siffror med sekel går också.
`since`	query	date (ÅÅÅÅ-MM-DD)	–	Bara ändringar från och med datumet. Utan `since` kommer de senaste ändringarna.
`limit`	query	integer 1–200	`50`	Högst så många ändringar, nyast först.

Headers: Authorization: Bearer … (krävs) och Idempotency-Key (valfri).

Exempel#

Exemplen saknas just nu

Svaren från sandlådan kunde inte genereras i den här miljön. Anropen fungerar som beskrivet.

Ändringar sedan 1 januari 2026#

curl -s "http://localhost:3020/api/v1/companies/569900-0013/history?since=2026-01-01" \
  -H "Authorization: Bearer $GETBOLAG_KEY"

Exemplet kunde inte genereras i den här miljön.

Felaktigt datum#

bash

curl -s "http://localhost:3020/api/v1/companies/569900-0013/history?since=1%20januari" \
  -H "Authorization: Bearer $GETBOLAG_KEY"

Exemplet kunde inte genereras i den här miljön.

Om svaret#

events är registrerade ändringar, nyast först, med code och en svensk text.
events_coverage anger perioden vi har ändringar för. Ändringar före from finns inte i tjänsten, och ett tomt svar betyder att inget ändrats inom perioden.
status_history visar bolagets status och form över tid, med valid_from och valid_to.

Felkoder#

Kod	HTTP	Vad du gör
`invalid_org_number`	400	Skicka tio siffror, med eller utan bindestreck, till exempel `569900-0013`.
`invalid_since`	400	Skicka datumet som ÅÅÅÅ-MM-DD, till exempel `2026-01-01`.
`invalid_parameter`	400	Kontrollera parametrarna mot endpointens tabell. Okända parametrar avvisas i stället för att ignoreras.
`not_found`	404	Kontrollera numret. Inte hittat debiteras inte.
`entity_cap_exceeded`	429	Bolag och personer du redan hämtat i dag går att hämta igen. Behöver du ett högre tak, kontakta support.
`unauthorized`	401	Skicka `Authorization: Bearer gb_test_…` eller `gb_live_…`. Kontrollera att hela nyckeln kom med. En OAuth-token gäller en timme; förnya den med refresh-token.
`insufficient_scope`	403	Skapa en nyckel med rätt scope under Konto → Nycklar. Se scopes.
`email_not_verified`	403	Klicka på länken i bekräftelsemejlet, eller skicka ett nytt från Konto.
`user_disabled`	403	Be kontots ägare att aktivera användaren, eller använd en egen nyckel.
`account_not_active`	403	Använd en testnyckel tills kontot är godkänt. Status syns under Konto.
`blocked_by_phase`	503	Använd en testnyckel mot sandlådan. Vi meddelar när live-data öppnar. Se sandlådan.
`suspended`	503	Kontakta support@getbolag.se.
`rate_limited`	429	Vänta så många sekunder som `Retry-After` anger och försök igen. Se takt och tak.
`insufficient_credits`	402	Fyll på under Konto → Krediter.
`monthly_cap_reached`	402	Höj taket under Konto, eller vänta till nästa månad.
`key_daily_cap_reached`	402	Höj nyckelns tak under Konto → Nycklar, eller vänta till nästa dygn.
`invalid_idempotency_key`	400	Skicka ett kort, unikt värde per uppslag, till exempel ett UUID.
`idempotency_key_reused`	422	Använd en ny nyckel för varje nytt uppslag. Samma nyckel gäller bara när exakt samma anrop görs om. Se Idempotency-Key.
`internal_error`	500	Försök igen med samma `Idempotency-Key`. Ange `request_id` om du kontaktar support.

Samma uppslag i MCP: verktyget gb_get_company_history. Se MCP.