REST-API

Bokslut och nyckeltal

Resultat- och balansräkning i tusental kronor och nyckeltal för upp till fem år. Bara aktiebolag.

http

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

Operation	Scope	Pris per uppslag
`get_financials` (bokslut och nyckeltal)	`financials:read`	0,10 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å.
`years`	query	integer 1–5	`5`	Antal räkenskapsår, senaste först.

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

Exempel#

Tre år för ett aktiebolag#

curl -s "https://app.bolagskvarnen.se/api/v1/companies/569900-0013/financials?years=3" \
  -H "Authorization: Bearer $GETBOLAG_KEY"

Svar från sandlådanHTTP 200

application/json

{
  "status": "ok",
  "data": {
    "org_number": "569900-0013",
    "name": "Exempelbolaget i Norrland AB",
    "currency_unit": "tsek",
    "statements": [
      {
        "period_from": "2025-01-01",
        "period_to": "2025-12-31",
        "months": 12,
        "employees": 14,
        "amounts_tsek": {
          "net_sales": 15200,
          "operating_income": null,
          "operating_result": 1800,
          "result_after_financial_items": null,
          "net_profit": 1350,
          "personnel_costs": null,
          "depreciation": null,
          "tax": null,
          "fixed_assets": null,
          "current_assets": null,
          "cash_and_bank": null,
          "total_assets": 9800,
          "share_capital": null,
          "equity": 4100,
          "untaxed_reserves": null,
          "provisions": null,
          "long_term_liabilities": null,
          "current_liabilities": null,
          "total_equity_and_liabilities": null,
          "dividend": 500,
          "ebitda": null
        },
        "ratios": {
          "operating_margin_percent": 11.8,
          "profit_margin_percent": null,
          "equity_ratio_percent": 41.8,
          "quick_ratio_percent": null,
          "return_on_equity_percent": null,
          "return_on_capital_employed_percent": null,
          "turnover_change_percent": null,
          "turnover_per_employee": null,
          "debt_ratio": null
        }
      },
      {
        "period_from": "2024-01-01",
        "period_to": "2024-12-31",
        "months": 12,
        "employees": 12,
        "amounts_tsek": {
          "net_sales": 13100,
          "operating_income": null,
          "operating_result": 1500,
          "result_after_financial_items": null,
          "net_profit": 1120,
          "personnel_costs": null,
          "depreciation": null,
          "tax": null,
          "fixed_assets": null,
          "current_assets": null,
          "cash_and_bank": null,
          "total_assets": 8700,
          "share_capital": null,
          "equity": 3250,
          "untaxed_reserves": null,
          "provisions": null,
          "long_term_liabilities": null,
          "current_liabilities": null,
          "total_equity_and_liabilities": null,
          "dividend": 0,
          "ebitda": null
        },
        "ratios": {
          "operating_margin_percent": 11.5,
          "profit_margin_percent": null,
          "equity_ratio_percent": 37.4,
          "quick_ratio_percent": null,
          "return_on_equity_percent": null,
          "return_on_capital_employed_percent": null,
          "turnover_change_percent": null,
          "turnover_per_employee": null,
          "debt_ratio": null
        }
      },
      {
        "period_from": "2023-01-01",
        "period_to": "2023-12-31",
        "months": 12,
        "employees": 11,
        "amounts_tsek": {
          "net_sales": 11900,
          "operating_income": null,
          "operating_result": 900,
          "result_after_financial_items": null,
          "net_profit": 640,
          "personnel_costs": null,
          "depreciation": null,
          "tax": null,
          "fixed_assets": null,
          "current_assets": null,
          "cash_and_bank": null,
          "total_assets": 7600,
          "share_capital": null,
          "equity": 2130,
          "untaxed_reserves": null,
          "provisions": null,
          "long_term_liabilities": null,
          "current_liabilities": null,
          "total_equity_and_liabilities": null,
          "dividend": 0,
          "ebitda": null
        },
        "ratios": {
          "operating_margin_percent": 7.6,
          "profit_margin_percent": null,
          "equity_ratio_percent": 28,
          "quick_ratio_percent": null,
          "return_on_equity_percent": null,
          "return_on_capital_employed_percent": null,
          "turnover_change_percent": null,
          "turnover_per_employee": null,
          "debt_ratio": null
        }
      }
    ]
  },
  "meta": {
    "request_id": "813a45fa-1c3a-4c73-88a1-c136b21db7d2",
    "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": {
      "financials": "available"
    }
  }
}

SandlådaPåhittad testdata ur sandlådan.

Handelsbolag: inga bokslut (restricted, debiteras inte)#

bash

curl -s "https://app.bolagskvarnen.se/api/v1/companies/969900-0049/financials" \
  -H "Authorization: Bearer $GETBOLAG_KEY"

Svar från sandlådanHTTP 200

application/json

{
  "status": "ok",
  "data": {
    "org_number": "969900-0049",
    "name": "Handelsbolaget Påhitt",
    "currency_unit": "tsek",
    "statements": []
  },
  "meta": {
    "request_id": "b467b95b-5346-4c80-823a-4e586cc3bde1",
    "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": {
      "financials": "restricted"
    }
  }
}

SandlådaPåhittad testdata ur sandlådan.

Om svaret#

Belopp i amounts_tsek är i tusental kronor (currency_unit: "tsek"). Nyckeltal i ratios är procent eller kvoter enligt fältnamnet.
Bokslut finns bara för aktiebolag. För andra bolagsformer är coverage.financials restricted, statements tom och anropet debiteras inte.
Ett fält som är null saknas i bokslutet. Det betyder inte noll.
Bokslut och nyckeltal är underlag för ditt eget arbete. De är ingen kreditupplysning eller kreditbedömning.

Felkoder#

Kod	HTTP	Vad du gör
`invalid_org_number`	400	Skicka tio siffror, med eller utan bindestreck, till exempel `569900-0013`.
`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_financials. Se MCP.