API för utbildningstillfällen (Susa-navet)
Skolverket samlar dagligen in och delar information om kurser och utbildningstillfällen från alla utbildningsformer i den nationella databasen Susa-navet, som är tillgänglig via öppna API:er. Susa står för Samverkan Utbildningsinformation Skolverket – Arbetsförmedlingen.
Format
Du kan hämta uppgifter ur Susa-navet genom två olika API:er:
- REST API:et hämtas genom Swagger och resultaten visas i JSON-format. API:et kommer tas bort 1 april 2026 och ersättas av Susa-navets nya API som finns tillgängligt från och med 1 januari 2026.
- EMIL API:et visar resultaten i XML-format. EMIL API:et kommer att tas bort den 1 april 2026.
Övergång till Susa-navets nya API
Skolverket har tagit fram ett nytt API genom vilken utbildningsanordnarna kommer dela sin data genom den nya EMIL3-standarden. Därför behöver både leverantörer och användare anpassa sina system. Utbildningsanordnarna arbetar med sin omställning under 2025 och det nya API:et planeras vara tillgängligt från 1 januari 2026.
- Det nya Susa-navets API planeras vara tillgängligt från 1 januari 2026.
- API-användarnas övergång till det nya API:et måste ske under första kvartalet under 2026.
- Det nuvarande EMIL2 API:et tas bort 1 april 2026.
Vill du testa Susa-navet API version 3 i förväg? En beta version av API:et återfinns längre ner på sidan under Versionsinformation. Vid frågor kontakta susa@skolverket.se.
Viktiga förändringar i det nya API:et för Susa-navet
Vi har uppdaterat API:et för Susa-navet för att göra det smidigare att hämta information.
Förenklade filter för smidigare dataåtkomst
Majoriteten av våra användare föredrar att hämta all tillgänglig data. Därför har vi tagit bort flera sällan använda filter och behåller nu endast ett antal välvalda alternativ:
- hämta all aktuell data
- hämta endast ändringar (ny, uppdaterad eller borttagen data)
- skolform
- paginering.
Hämta endast ny eller ändrad information
Med det nya API:et kan du välja att bara hämta de förändringar som har skett sedan den senaste hämtningen. Det innebär att fullständiga datamängder kan hämtas mer sällan, medan dagliga eller veckovisa uppdateringar kan omfatta endast ny eller ändrad information.
Håll dig uppdaterad om Susa-navets API
En beta version av Susa-navets API 3.0 finns nu tillgänglig för test med begränsat innehåll. API:et återfinns under Versionsinformation. Håll dig uppdaterad om utvecklingen av Susa-navets API genom att prenumerera på information om Skolverkets tjänster och öppna data.
Prenumerera på information om Skolverkets tjänster och öppna data
Villkor för användning
Versionsinformation
En betaversion av Susa-navets API 3.0.0 är nu tillgänglig. Innehållet är begränsat men under hösten tillkommer fler utbildningar löpande.
Uppdaterad dokumentation och struktur av dokumentation.
Denna version av API togs fram 2013.
Syftet är att tillhandahålla all funktionalitet som behövs för att kunna bygga en applikation som på ett naturligt och enkelt sätt kan integrera och använda sig av den information som finns i navet. Det innehåller funktioner för att söka, lista och titta på detaljerad information om de resurser som hanteras, men också dokumentation om hur detta går till. Den information som returneras är en JSON-representation av EMIL-dokument och följer alltså inte det schema som styr hur ett EMIL-dokument ser ut.
Detta API fanns i den första versionen av navet, följer EMIL-standarden och är bakåtkompatibelt.
Syftet är att tillhandahålla möjligheten för tredje part att ladda ned stora mängder information om lärosäten, kurser och kurstillfällen för att själv bearbeta och använda data lokalt. Den information som exponeras är densamma som navet själv hämtar från de olika leverantörerna av information, det vill säga EMIL-dokument.
Innehållsjusteringar
Skolformer som finns enligt EMIL3 är just nu grundskola (GR), anpassad grundskola (GRAN), specialskola (SP), sameskola (SAM),
Gymnasieskola (GY), anpassad gymnasieskola (GYAN) och nationella yrkesutbildningar (NY).
Fler skolformer kommer att fyllas på under hösten.
Har du frågor?
Har du frågor om Susa-navet, mejla oss på: susa@skolverket.se
Senast uppdaterad 10 oktober 2025.