API för skolenhetsregistret
Registret bygger på skolhuvudmännens egna uppgifter och omfattar aktuell organisation samt dess skolenheter och eventuella övriga utbildningsverksamheter. I registret finns även information om utbildningsamordnare och folkhögskolor som har tilldelats betygsrätt. Uppgifterna i skolenhetsregistret finns tillgängliga via ett öppet API som uppdateras dagligen.
Skolenhetsregistrets öppna API
API-specifikationen för skolenhetsregistret
Nyheter för skolenhetsregistrets öppna API
Skolenhetsregistrets API finns i två versioner och Skolverket rekommenderar användning av version 2 som nu är den aktiva versionen. Avveckling av API version 1 är planerad till årsskiftet 2025/2026.
Om API:et
Format
Api:et är ett REST-api som returnerar data som JSON eller XML baserat på Accept-headern.
Villkor för användning
Villkoren i Skolverkets källicens
Versionsinformation
Följande har gjorts i version 2 av skolenhetsregistret.
Signaturbyten
- /v2/school-units/{school-unit-code} har bytt signatur till /v2/school-units/{schoolUnitCode}
- /v2/organizers/{organization-number} har bytt signatur till /v2/organizers/{organizationNumber}
- /v2/education-providers/{education-provider-code} har bytt signatur till /v2/education-providers/{educationProviderCode}
- /v2/contracts/{organization-number}/{education-provider-code} har bytt signatur till /v2/contracts/{organizationNumber}/{educationProviderCode}
Namnbyten
- Code_SchoolType har bytt namn till CodeSchoolType
- Code_SchoolUnitStatus har bytt namn till CodeSchoolUnitStatus
- Code_SchoolUnitType har bytt namn till CodeSchoolUnitType
- Code_OrganizerType har bytt namn till CodeOrganizerType
- Code_SchoolTypePartVux har bytt namn till CodeSchoolTypePartVux
- Code_OrientationType har bytt namn till CodeOrientationType
- Code_LegalEntityStatus har bytt namn till CodeLegalEntityStatus
- Code_CompanyStatus har bytt namn till CodeCompanyStatus
- Code_ProviderType har bytt namn till CodeProviderType
- Code_ReportType har bytt namn till CodeReportType
- ApiInfo har bytt namn till ApiInfoResponse
Nya objekt
- AddressTypeEnum
- SchoolUnitResponseData
- SchoolUnitInfoResponseData
- EducationProviderResponseData
- EducationProviderInfoResponseData
- ContractResponseData
- OrganizerResponseData
- OrganizerInfoResponseData
- ContractInfoResponseData
- AddressTypeEnum
- OrganizerIncludedAttributes
- WrappedLink
- LinkWithRelatedLinks
- RelatedLink
Nya referenser
- SchoolUnitResponse refererar till schema SchoolUnitResponseData i stället för ett anonymt inline-objekt
- SchoolUnitInfoResponse refererar till schema Link i stället för SchoolUnitSelfLink
- SchoolUnitInfoResponse refererar till schema SchoolUnitInfoResponseData i stället för ett anonymt inline-objekt
- EducationProviderResponse refererar till schema EducationProviderResponseData i stället för ett anonymt inline-objekt
- EducationProviderInfoResponse refererar till schema Link i stället för EducationProviderSelfLink
- EducationProviderInfoResponse refererar till schema EducationProviderInfoResponseData i stället för ett anonymt inline-objekt
- ContractResponse refererar till schema ContractResponseData i stället för ett anonymt inline-objekt
- OrganizerResponse refererar till schema OrganizerResponseData i stället för ett anonymt inline-objekt
- OrganizerInfoResponse refererar till schema Link i stället för OrganizerSelfLink
- OrganizerInfoResponse refererar till schema OrganizerInfoResponseData i stället för ett anonymt inline-objekt
- ContractInfoResponse refererar till schema Link i stället för ContractSelfLink
- ContractInfoResponse refererar till schema ContractInfoResponseData i stället för ett anonymt inline-objekt
- OrganizationAddress refererar till schema AddressTypeEnum i stället för en inline-string
- SchoolUnitAddress refererar till schema AddressTypeEnum i stället för en inline-string
- EducationProviderAddress refererar till schema AddressTypeEnum i stället för en inline-string
- OrganizerIncluded refererar till schema OrganizerIncludedAttributes i stället för ett anonymt inline-objekt
- OrganizerIncluded refererar till schema Link i stället för ett anonymt inline-objekt
- ContractInfoResponseDataRelationships refererar till schema WrappedLink i stället för OrganizerLinksWrapper
- ContractInfoResponseDataRelationships refererar till schema WrappedLink i stället för EducationProviderLinksWrapper
- OrgSchoolUnitRelation refererar till schema LinkWithRelatedLinks i stället för OrganizationLinks
- OrgContractRelation refererar till schema LinkWithRelatedLinks i stället för ContractLinks
Borttagna objekt
- SchoolUnitArrayResponse
- SchoolUnitArrayInfo
- SchoolUnitSelfLink
- OrganizerSelfLink
- EducationProviderSelfLink
- OrganizationLinks
- OrganizerLinksWrapper
- OrganizerRelatedLinks
- OrganizerLinks
- EducationProviderLinks
- Rättade till felaktigt parameternamn för utbildningsanordnarens organisationsnummer i /v2/contracts.
- Rättningar i dokumentationen för v2.
- Justering av API v2 för att följa specifikationen.
- Om en variabel är tom (null) skickas den inte med i svaret från API:et (v1 och v2).
Aktiv version från 2024-12-13.
- Anpassat API till rekommenderad REST API-profil för offentliga aktörer.
- Översatt namn på bland annat tjänster och parametrar till engelska. Detta är ett delsteg i en framtida anpassning till standarden SS 12000.
- Lagt till möjlighet att kombinera sökparametrar vid sökning av skolenheter och huvudmän.
- Tillgängliggjort upphörda skolenheter i API.
- Tagit bort tjänster för att lista kommuner och skolformer.
- Ersatt tjänsten harbetygsratt med sökparameter i tjänsten School-units (School-units?grading_rights=true).
- Ersatt diff-tjänster med sökparameter i tjänsten School-units (School-units?meta_modified_after).
- Lagt till möjlighet att hitta information om Komvux på entreprenad och utbildningsanordnare i tjänsterna Education-providers och Contracts.
- Lagt till möjlighet att hitta information om skolenheter med program enligt Gy25 och Gyan25.
- Flyttat Skolenhetsregistrets öppna API från SCB till Skolverket.
- Tjänster är oförändrade.
Om skolenhetsregistret
På huvudsidan för skolenhetsregistret finns det mer information om registret och e-tjänsten samt kontaktuppgifter.
Senast uppdaterad 23 oktober 2025.