Till innehållet
homeStartsida
searchSök

Förslag

    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.

    API-dokumentation för skolenhetsregistret (SwaggerUI) 

    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 (Creative Commons)

    Innehållsjusteringar

    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).

    Versionsinformation

    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.

     

    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 skolenhetsregistret

    På huvudsidan för skolenhetsregistret finns det mer information om registret och e-tjänsten samt kontaktuppgifter.

    Skolenhetsregistret

    Senast uppdaterad 30 mars 2026.