GET/v1/annual-reports

Årsredovisningar (lista)

Lista ett företags tillgängliga digitala årsredovisningar via organisationsnummer.

Översikt

Den här endpointen listar vilka digitala årsredovisningar som finns tillgängliga för ett företag, ett räkenskapsår per rad. Använd den för att visa vilka år som går att hämta innan du laddar ner ett dokument med Hämta årsredovisning. Varje rad innehåller räkenskapsårets slutdatum, vilka format som finns (iXBRL och PDF) samt en ungefärlig filstorlek.

Gratis att lista

0 krediter. Att lista tillgängliga årsredovisningar kostar ingenting och fungerar även utan API-nyckel. Krediter dras först när du hämtar ett dokument.

Partiell täckning

Digitala årsredovisningar finns för en delmängd av alla aktiebolag, de bolag som lämnat in sin årsredovisning digitalt till Bolagsverket. Om ett företag inte har någon digital årsredovisning returneras en tom filings-lista (det är inget fel). Att listan är tom betyder inte att företaget saknar omsättning, ofta har bolaget lämnat in på papper.

Källa

Årsredovisningarna kommer från Bolagsverket. Attributionen "Källa: Bolagsverket" ska visas tillsammans med de hämtade dokumenten.

Förfrågan

Frågeparametrar

Parameter	Typ	Obligatorisk	Beskrivning
org_number	string	Obligatorisk	Det 10-siffriga organisationsnumret. Måste vara exakt 10 siffror utan bindestreck eller mellanslag.

Kodexempel

Listan är gratis och kräver ingen API-nyckel. Här är exempel i flera programmeringsspråk:

curl

# Lista tillgängliga årsredovisningar (gratis, ingen nyckel krävs)
curl 'https://data.foretagsapi.se/v1/annual-reports?org_number=5593386872'

Svar

Lyckat svar (200 OK)

Returnerar ett JSON-objekt med en lista över tillgängliga årsredovisningar:

json

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20{
  "orgNumber": "5593386872",
  "filingCount": 1,
  "filings": [
    {
      "fiscalYear": 2024,
      "fiscalEnd": "2024-12-31",
      "documents": 2,
      "sizeKb": 42,
      "formats": ["ixbrl", "pdf"],
      "ixbrlUrl": "https://data.foretagsapi.se/v1/annual-report?org_number=5593386872&fiscal_end=2024-12-31&format=ixbrl",
      "pdfUrl": "https://data.foretagsapi.se/v1/annual-report?org_number=5593386872&fiscal_end=2024-12-31&format=pdf"
    }
  ],
  "metadata": {
    "mode": "api",
    "source": "Bolagsverket",
    "timestamp": "2026-01-15T10:32:00Z"
  }
}

Om fälten

fiscalEnd är räkenskapsårets slutdatum (YYYY-MM-DD) och den kanoniska identifieraren när du hämtar ett dokument.
formats innehåller alltid "ixbrl". "pdf" visas när PDF:en redan har renderats, men du kan begära PDF ändå, den renderas då vid första hämtningen.
ixbrlUrl och pdfUrl är färdiga länkar till hämtnings-endpointen. De kräver en API-nyckel och drar 1 kredit, så de fungerar inte som vanliga klickbara länkar i en webbläsare (se Hämta årsredovisning).

Ingen digital årsredovisning

Om företaget inte har någon digital årsredovisning returneras en tom lista (inte ett fel):

json

{
  "orgNumber": "5560000001",
  "filingCount": 0,
  "filings": [],
  "metadata": {
    "mode": "api",
    "source": "Bolagsverket",
    "timestamp": "2026-01-15T10:33:00Z"
  }
}

Felsvar

400 Bad Request

Returneras när org_number saknas helt:

json

{
  "error": "Missing required parameter: org_number"
}

Eller när det angivna org_number är felaktigt formaterat:

json

{
  "error": "Invalid org_number"
}