GET/v1/annual-report

Hämta årsredovisning

Hämta en digital årsredovisning som iXBRL eller PDF för ett visst räkenskapsår.

Översikt

Den här endpointen hämtar själva dokumentet för en årsredovisning. Ange företagets organisationsnummer och räkenskapsårets slutdatum (fiscal_end), som du får från Årsredovisningar (lista). Du kan välja format iXBRL (standard) eller PDF.

Snabbfakta

Kostnad: 1 kredit per årsredovisning, oavsett format. Krediten dras först när ett dokument levereras.
Autentisering: API-nyckel krävs i Authorization-headern. Att lista är gratis, men att hämta dokument är inte det.
Bas-URL: Hämta alltid via data.foretagsapi.se.
Format: iXBRL levereras direkt. PDF renderas vid första hämtningen för ett räkenskapsår och cachas sedan, så det första anropet kan ta några sekunder.
Källa: Dokumenten kommer från Bolagsverket. Attributionen "Källa: Bolagsverket" är instämplad i renderade PDF:er, visa den även intill nedladdningen i ditt gränssnitt.

Delningslänk med &share=1

Lägg till &share=1 så får du tillbaka JSON med en publik, signerad delningslänk som är giltig i 24 timmar, i stället för dokumentbytena. Länken öppnas utan API-nyckel, perfekt för att skicka vidare till t.ex. en revisor. Drar samma 1 kredit som en vanlig hämtning, ingen extra kostnad.

Förfrågan

Frågeparametrar

Parameter	Typ	Obligatorisk	Beskrivning
org_number	string	Obligatorisk	Det 10-siffriga organisationsnumret, exakt 10 siffror utan bindestreck.
fiscal_end	string	Valfri	Räkenskapsårets slutdatum (`YYYY-MM-DD`), från list-endpointens `fiscalEnd`. Om du utelämnar parametern hämtas den senaste tillgängliga årsredovisningen, vilket är praktiskt när du bara vill ha den färskaste. Alternativt kan `fiscal_year` anges, då väljs den senaste årsredovisningen för det året.
format	string	Valfri	`ixbrl` (standard) eller `pdf`.
share	string	Valfri	Sätt `share=1` för att i stället få en publik delningslänk (JSON) som är giltig i 24 timmar. Drar samma 1 kredit.

Kodexempel

Här är exempel i flera programmeringsspråk:

curl

1
2
3
4
5
6
7
8# Hämta en årsredovisning som PDF (1 kredit, API-nyckel krävs)
curl 'https://data.foretagsapi.se/v1/annual-report?org_number=5593386872&fiscal_end=2024-12-31&format=pdf' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  --output arsredovisning-2024.pdf

# Eller skapa en publik delningslänk (giltig i 24 timmar, samma 1 kredit)
curl 'https://data.foretagsapi.se/v1/annual-report?org_number=5593386872&fiscal_end=2024-12-31&format=pdf&share=1' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Svar

Lyckat svar (200 OK)

Vid en vanlig hämtning returneras dokumentet som bytes med rätt Content-Type (application/xhtml+xml för iXBRL, application/pdf för PDF).

När du lägger till &share=1 returneras JSON med en publik länk i stället för dokumentet:

json

{
  "shareUrl": "https://data.foretagsapi.se/v1/shared/9f3c2a1b8d7e6f5a4c3b2a1908d7e6f5",
  "expiresAt": "2026-01-16T10:32:00Z",
  "format": "pdf"
}

Delningslänken är giltig i 24 timmar

Länken är publik och signerad, vem som helst med länken kan öppna dokumentet tills den går ut. Den lämpar sig för att skicka vidare, inte för att spara permanent i ett system.

Felsvar

400 Bad Request

Returneras när obligatoriska parametrar saknas, till exempel org_number:

json

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

401 Unauthorized

Returneras när ingen giltig API-nyckel skickas med:

json

{
  "error": "Invalid API key",
  "message": "API-nyckeln är ogiltig eller felaktigt formaterad."
}

404 Not Found

Returneras när det inte finns någon årsredovisning för det angivna räkenskapsåret. Om dokumentet finns i katalogen men ännu inte renderats kan ett nytt försök strax efteråt lyckas.

json

{
  "error": "No annual report found for that company / period."
}