REST-API

Personers engagemang

Alla bolag där en person har eller har haft ett uppdrag. Personen anges med person_ref från ett rollsvar.

http

GET /api/v1/persons/{person_ref}/engagements

Operation	Scope	Pris per uppslag
`get_person_engagements` (personers engagemang)	`persons:read`	0,10 kr

Parametrar#

Namn	Var	Typ	Standard	Beskrivning
`person_ref` (krävs)	path	string	–	Handtaget `pr_…` från ett svar på roller. Det är bundet till ditt konto.
`include_former`	query	boolean	`false`	`true` tar med avslutade uppdrag.

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

Exempel#

Engagemang, även tidigare#

curl -s "https://app.bolagskvarnen.se/api/v1/persons/$PERSON_REF/engagements?include_former=true" \
  -H "Authorization: Bearer $GETBOLAG_KEY"

Svar från sandlådanHTTP 200

application/json

{
  "status": "ok",
  "data": {
    "person_ref": "pr_LcptQp7Mj6-JQ81T4KB1weuREl9cdzrzldsp2WKvH0ddTx0zJOcxpKja_60",
    "name": "Testsson, Testa",
    "engagements": [
      {
        "company": {
          "org_number": "569900-0013",
          "org_number_withheld": false,
          "name": "Exempelbolaget i Norrland AB",
          "legal_form_code": "AB"
        },
        "role_code": 10,
        "role": "Verkställande direktör",
        "from_date": "2015-03-10",
        "to_date": null,
        "active": true
      },
      {
        "company": {
          "org_number": "569900-0013",
          "org_number_withheld": false,
          "name": "Exempelbolaget i Norrland AB",
          "legal_form_code": "AB"
        },
        "role_code": 20,
        "role": "Styrelseledamot",
        "from_date": "2015-03-10",
        "to_date": null,
        "active": true
      },
      {
        "company": {
          "org_number": "569900-0039",
          "org_number_withheld": false,
          "name": "Fiktiva Konsult AB",
          "legal_form_code": "AB"
        },
        "role_code": 20,
        "role": "Styrelseledamot",
        "from_date": "2012-05-15",
        "to_date": "2020-01-01",
        "active": false
      }
    ]
  },
  "meta": {
    "request_id": "be97ce6e-98e0-4e01-892d-6855e3e3182e",
    "source": [
      "sandbox"
    ],
    "attribution": [
      {
        "source": "getbolag-sandbox",
        "supplier": "Bolagskvarnen",
        "notice": "Påhittad testdata. Inga riktiga bolag eller personer."
      }
    ],
    "retrieved_at": "2026-11-12T12:07:09.899Z",
    "data_updated_at": "2026-10-26T06:00:00Z",
    "cost_sek": 0,
    "environment": "test",
    "database": "Bolagskvarnen (bolagskvarnen.se)",
    "publisher": "Bolagskvarnen, ett varumärke i Bolagskällan AB (559555-5946)",
    "coverage": {
      "engagements": "available"
    }
  }
}

SandlådaPåhittad testdata ur sandlådan.

Okänd person_ref#

bash

curl -s "https://app.bolagskvarnen.se/api/v1/persons/pr_finnsinte/engagements" \
  -H "Authorization: Bearer $GETBOLAG_KEY"

Svar från sandlådanHTTP 400

application/json

{
  "status": "error",
  "error": {
    "code": "invalid_person_ref",
    "message": "person_ref är okänd eller hör till ett annat konto. Hämta den på nytt via bolagets roller."
  }
}

SandlådaPåhittad testdata ur sandlådan.

Om svaret#

Engagemangen är personens uppdrag i alla bolag, med roll och datum.
En enskild firmas organisationsnummer är innehavarens personnummer. Därför är company.org_number null och org_number_withheld true för enskilda firmor i den här listan.
En person_ref från ett annat konto, eller ett påhittat värde, ger 400 invalid_person_ref.
Varje person räknas mot taket för antal olika bolag och personer per dygn, se takt och tak.
I exemplet är person_ref skapad för dokumentationens konto. Den fungerar inte med din nyckel; hämta din egen via roller.

Felkoder#

Kod	HTTP	Vad du gör
`invalid_person_ref`	400	Hämta personens person_ref på nytt via bolagets roller.
`invalid_parameter`	400	Kontrollera parametrarna mot endpointens tabell. Okända parametrar avvisas i stället för att ignoreras.
`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_person_engagements. Se MCP.