Dataexport

API-dokumentation

För dig som vill exportera data och insikter från Vården i Siffror programmatiskt. Här hittar du dokumentation och ett testverktyg för vårt export-API.

Export API

Export API:et låter dig programmatiskt hämta data från Vården i Siffror. Du kan filtrera på regioner, indikatorer, tidsperiod och format.

REST APIJSON / CSV / ZIP

GET

/api/workspace/vardenisiffror/export

Parametrar

indicators Required

regions / enheter

Tom = alla enheter

startYear / endYear

2021

2025

gender (kön)

Totalt

Män

Kvinnor

format

JSON

limit

100

Svar

Ange minst en indikator-ID och klicka på "Skicka" för att testa API:et

cURL

curl -X GET "https://vardenisiffror.se/api/workspace/vardenisiffror/export?startYear=2021&endYear=2025&gender=total&format=json&limit=100"

Dokumentation

Endpoint

GET /api/workspace/vardenisiffror/export

Parametrar

Parameter	Typ	Beskrivning
indicatorsRequired	string	Kommaseparerade indikator-ID:n (obligatorisk)
regions	string	Kommaseparerade enhets-ID:n (regioner, kommuner, sjukhus, etc.), eller tom för alla
startYear	integer	Startår för tidsperiod (1990-2025)
endYear	integer	Slutår för tidsperiod (1990-2025)
gender	string	Kommaseparerade kön: total, male, female (default: alla)
format	string	Svarsformat: json, csv (default: json). ZIP-paket finns via exportsidan.
limit	integer	Max antal poster (default: 1000, max: 10000)

Svarsformat (JSON)

{ "meta": { "exportDate": "2024-01-15T10:30:00.000Z", "totalRecords": 150, "indicators": 3, "regions": ["01", "09"], "timeRange": "2020 - 2024", "gender": "Totalt, Män, Kvinnor" }, "data": [ { "measureId": "7002952f-1eb7-40a5-87fd-7eda9110e953", "measureName": "Andel med god glykemisk kontroll", "measureDefinition": "Andel patienter med HbA1c < 52 mmol/mol", "measureType": "Processindikator", "gender": "Totalt", "organizationCode": "01", "organizationName": "Region Stockholm", "organizationType": "Region", "period": "2023", "periodType": "År", "value": 52.3, "numerator": 1234, "denominator": 2360, "confidenceIntervalLow": 50.1, "confidenceIntervalHigh": 54.5 } ] }

ZIP-datapaket (via exportsidan)

ZIP-datapaket är tillgängligt via exportsidan, inte via API:et. Paketet ger ett strukturerat datapaket med separerad metadata och pivottabeller, idealiskt för integration i dataflöden och analysplattformar.

vardenisiffror-datapaket.zip ├── manifest.json # Paketmetadata, version, innehållslista ├── README.md # Dokumentation med kolumnbeskrivningar ├── metadata/ │ ├── indicators.csv # Lista över inkluderade indikatorer │ ├── organizations.csv # Lista över inkluderade enheter │ └── export-parameters.json # Exportparametrar och filter ├── data/ │ ├── measurements.csv # Samtliga datapunkter i platt format │ └── cubes/ │ ├── region.csv # Pivotdata per region │ ├── sjukhus.csv # Pivotdata per sjukhus │ └── ... # En fil per enhetstyp

Svarkoder

Kod	Beskrivning
200	OK - Förfrågan lyckades
400	Bad Request - Ogiltiga eller saknade parametrar
500	Internal Server Error - Serverfel
503	Service Unavailable - Databasanslutning ej konfigurerad

Begränsningar

Maximalt 10 000 poster per anrop
Minst en indikator-ID krävs