EduAI
EduAI · GPT Actions
Skolenhetsregistret öppna API - Skolverket
Skolverkets öppna API för skolenhetsregistret innehåller uppgifter om skolenheter. Registret bygger på skolhuvudmännens egna uppgifter och omfattar aktuell organisation samt adresser till skolenheter. För att hämta alla skolenheter kan du använda den här länken: <a href="https://api.skolverket.se/skolenhetsregistret/v1/skolenhet" target="_blank">https://api.skolverket.se/skolenhetsregistret/v1/skolenhet</a>
GET /planned-educations/v3/school-units/{schoolUnitCode}/statistics/gyHämta statistik för en skolenhet med skolformen gymnasieskola baserat på skolenhetskodGET /planned-educations/v3/school-units/{schoolUnitCode}/statistics/grHämta statistik för en skolenhet med skolformen grundskola baserat på skolenhetskodGET /planned-educations/v3/school-units/{schoolUnitCode}Hämta en skolenhet baserat på skolenhetskodGET /skolenhetsregistret/v1/skolenhetHämta alla skolenheterVia detta API kan alla skolenheter hämtas
GET /skolenhetsregistret/v1/skolenhet/{schoolUnitCode}Hämta information om en skolenhetVia detta API kan detaljerad information om en skolenhet hämtas
GET /skolenhetsregistret/v1/skolenhet/{schoolUnitCode}/{searchDate}Hämta information om en skolenhet vid ett visst datumVia detta API kan detaljerad information om hur en skolenhet såg ut vid ett visst datum hämtas
GET /skolenhetsregistret/v1/skolformHämtar alla skolformerVia detta API hämtas en lista med alla aktiva skolformer
GET /skolenhetsregistret/v1/skolform/{schoolFormId}Hämta alla skolenheter för en skolformVia detta API kan alla skolenheter för en skolform hämtas
GET /skolenhetsregistret/v1/kommunHämtar alla kommunerVia detta API hämtas en lista med alla aktiva kommuner
GET /skolenhetsregistret/v1/kommun/{municipalityCode}Hämta alla skolenheter för en kommunVia detta API kan alla skolenheter för en kommun hämtas
GET /v1/huvudmanHämtar alla huvudmänVia detta API hämtas en lista med alla aktiva huvudmän
GET /skolenhetsregistret/v1/huvudman/{organisationNumber}Hämta information om en huvudmanVia detta API kan detaljerad information om en huvudman hämtas
GET /skolenhetsregistret/v1/huvudman/{organisationNumber}/{searchDate}Hämta information om en huvudman vid ett visst datumVia detta API kan detaljerad information om hur en huvudman såg ut vid ett visst datum hämtas
GET /skolenhetsregistret/v1/skolenhet/huvudman/{organisationNumber}Hämta alla skolenheter för en huvudmanVia detta API kan alla skolenheter för en huvudman hämtas
GET /skolenhetsregistret/v1/harbetygsrattHämta alla skolenheter med betygsrattVia detta API kan alla skolenheter med betygsrätt hämtas
GET /skolenhetsregistret/v1/diff/skolenhet/{date}Lista skolenhetskod för alla skolenheter som ändrats sedan angivet datumVia detta API kan skolenhetskod för alla skolenheter som ändrats sedan angivet datum hämtas
GET /skolenhetsregistret/v1/diff/huvudman/{date}Lista organisationsnummer för alla huvudmän som ändrats sedan angivet datumVia detta API kan organisationsnummer för alla huvudmän som ändrats sedan angivet datum hämtas
GET /syllabus/v1/subjectsHämta lista med ämnen.Här returneras översiktlig information om ämnen i <b>SubjectsResponse</b>. Med tidsintervall kan du styra om hämtning av gällande, framtida, upphörda alternativt modifierade ämnen ska ske, default är LATEST, vilket innebär att gällande ämnen hämtas. Det finns även möjlighet att filtrera på skoltyp,
GET /syllabus/v1/subjects/{code}Hämta gällande ämne för valt datum.Här returneras detaljerad information om den version av ett ämne som gäller vid angivet sökdatum i <b>SubjectResponse</b>.
GET /syllabus/v1/subjects/{code}/versionsHämta lista med samtliga versioner av ett ämne.Här returneras översiktlig information om samtliga versioner av ett ämne i <b>SubjectsResponse</b>.
GET /syllabus/v1/subjects/{code}/versions/{version}Hämta en specifik version av ett ämne.Här returneras detaljerad information om angiven version av ett ämne i <b>SubjectResponse</b>.
原始 API 定义
{
"openapi": "3.0.0",
"info": {
"version": "1.0.0",
"title": "Skolenhetsregistret öppna API - Skolverket",
"description": "Skolverkets öppna API för skolenhetsregistret innehåller uppgifter om skolenheter. Registret bygger på skolhuvudmännens egna uppgifter och omfattar aktuell organisation samt adresser till skolenheter.\n\nFör att hämta alla skolenheter kan du använda den här länken: <a href=\"https://api.skolverket.se/skolenhetsregistret/v1/skolenhet\" target=\"_blank\">https://api.skolverket.se/skolenhetsregistret/v1/skolenhet</a>\n"
},
"servers": [
{
"url": "https://api.skolverket.se/"
}
],
"paths": {
"/planned-educations/v3/school-units/{schoolUnitCode}/statistics/gy": {
"get": {
"tags": [
"3. Statistik"
],
"summary": "Hämta statistik för en skolenhet med skolformen gymnasieskola baserat på skolenhetskod",
"operationId": "getSecondarySchoolUnitStatsByCodeUsingGET",
"parameters": [
{
"name": "schoolUnitCode",
"in": "path",
"description": "skolenhetskod",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/vnd.skolverket.plannededucations.api.v3.hal+json": {
"schema": {
"$ref": "#/components/schemas/ApiResponse«object»"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {}
},
"403": {
"description": "Forbidden",
"content": {}
},
"404": {
"description": "Not Found",
"content": {}
}
}
}
},
"/planned-educations/v3/school-units/{schoolUnitCode}/statistics/gr": {
"get": {
"tags": [
"3. Statistik"
],
"summary": "Hämta statistik för en skolenhet med skolformen grundskola baserat på skolenhetskod",
"operationId": "getCompulsorySchoolUnitStatsByCodeUsingGET",
"parameters": [
{
"name": "schoolUnitCode",
"in": "path",
"description": "skolenhetskod",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/vnd.skolverket.plannededucations.api.v3.hal+json": {
"schema": {
"$ref": "#/components/schemas/ApiResponse«object»"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {}
},
"403": {
"description": "Forbidden",
"content": {}
},
"404": {
"description": "Not Found",
"content": {}
}
}
}
},
"/planned-educations/v3/school-units/{schoolUnitCode}": {
"get": {
"tags": [
"1. Skolenheter"
],
"summary": "Hämta en skolenhet baserat på skolenhetskod",
"operationId": "getByIdUsingGET_1",
"parameters": [
{
"name": "schoolUnitCode",
"in": "path",
"description": "skolenhetskod",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/vnd.skolverket.plannededucations.api.v3.hal+json": {
"schema": {
"$ref": "#/components/schemas/ApiResponse«object»"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {}
},
"403": {
"description": "Forbidden",
"content": {}
},
"404": {
"description": "Not Found",
"content": {}
}
}
}
},
"/skolenhetsregistret/v1/skolenhet": {
"get": {
"tags": [
"1. Skolenhet"
],
"summary": "Hämta alla skolenheter",
"description": "Via detta API kan alla skolenheter hämtas",
"operationId": "getSchoolUnits",
"responses": {
"200": {
"description": "Svarskod för om det gick att hämta alla skolenheter",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SkolenhetResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/SkolenhetResponse"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/skolenhetsregistret/v1/skolenhet/{schoolUnitCode}": {
"get": {
"tags": [
"1. Skolenhet"
],
"summary": "Hämta information om en skolenhet",
"description": "Via detta API kan detaljerad information om en skolenhet hämtas",
"operationId": "getSchoolUnit",
"parameters": [
{
"name": "schoolUnitCode",
"in": "path",
"description": "Skolenhetskod",
"required": true,
"schema": {
"type": "string",
"example": "14562312"
}
}
],
"responses": {
"200": {
"description": "Svarskod för om det gick att hämta skolenheten",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SkolenhetInfoResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/SkolenhetInfoResponse"
}
}
}
},
"400": {
"description": "Svarskod för om ogiltig data skickades in i parameter för anropet",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Skolenhetskoden är ogiltig"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Skolenhetskoden är ogiltig"
}
}
}
},
"404": {
"description": "Svarskod för om den angivna skolenheten inte hittades",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Skolenheten X finns inte"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Skolenheten X finns inte"
}
}
}
},
"410": {
"description": "Svarskod för om den angivna skolenheten har upphört",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Skolenheten X har upphört"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Skolenheten X har upphört"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/skolenhetsregistret/v1/skolenhet/{schoolUnitCode}/{searchDate}": {
"get": {
"tags": [
"1. Skolenhet"
],
"summary": "Hämta information om en skolenhet vid ett visst datum",
"description": "Via detta API kan detaljerad information om hur en skolenhet såg ut vid ett visst datum hämtas",
"operationId": "getSchoolUnitForDate",
"parameters": [
{
"name": "schoolUnitCode",
"in": "path",
"description": "Skolenhetskod",
"required": true,
"schema": {
"type": "string",
"example": "14562312"
}
},
{
"name": "searchDate",
"in": "path",
"description": "Sökdatum",
"required": true,
"schema": {
"type": "string",
"example": "20210301"
}
}
],
"responses": {
"200": {
"description": "Svarskod för om det gick att hämta skolenheten",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SkolenhetInfoResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/SkolenhetInfoResponse"
}
}
}
},
"400": {
"description": "Svarskod för om ogiltig data skickades in någon parameter för anropet",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Felaktigt datum"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Felaktigt datum"
}
}
}
},
"404": {
"description": "Svarskod för om den angivna skolenheten inte hittades",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Skolenheten X finns inte"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Skolenheten X finns inte"
}
}
}
},
"410": {
"description": "Svarskod för om den angivna skolenheten har upphört",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Skolenheten X har upphört"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Skolenheten X har upphört"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/skolenhetsregistret/v1/skolform": {
"get": {
"tags": [
"2. Skolform"
],
"summary": "Hämtar alla skolformer",
"description": "Via detta API hämtas en lista med alla aktiva skolformer",
"operationId": "getSchoolForms",
"responses": {
"200": {
"description": "Svarskod för om det gick att hämta alla skolformer",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SkolformResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/SkolformResponse"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/skolenhetsregistret/v1/skolform/{schoolFormId}": {
"get": {
"tags": [
"2. Skolform"
],
"summary": "Hämta alla skolenheter för en skolform",
"description": "Via detta API kan alla skolenheter för en skolform hämtas",
"operationId": "getSchoolUnitsForSchoolform",
"parameters": [
{
"name": "schoolFormId",
"in": "path",
"description": "Id för den skolform som skolenheter ska hämtas för",
"required": true,
"schema": {
"type": "string",
"example": "5"
}
}
],
"responses": {
"200": {
"description": "Svarskod för om det gick att hämta alla skolenheter",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SkolenhetResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/SkolenhetResponse"
}
}
}
},
"400": {
"description": "Svarskod för om ogiltig data skickades in någon parameter för anropet",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Failed to convert value of type java.lang.String to required type java.lang.Long;"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Failed to convert value of type java.lang.String to required type java.lang.Long;"
}
}
}
},
"404": {
"description": "Svarskod för om den angivna skolformen inte hittades",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Skolformen finns inte"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Skolformen finns inte"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/skolenhetsregistret/v1/kommun": {
"get": {
"tags": [
"3. Kommun"
],
"summary": "Hämtar alla kommuner",
"description": "Via detta API hämtas en lista med alla aktiva kommuner",
"operationId": "getMunicipalities",
"responses": {
"200": {
"description": "Svarskod för om det gick att hämta alla kommuner",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/KommunResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/KommunResponse"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/skolenhetsregistret/v1/kommun/{municipalityCode}": {
"get": {
"tags": [
"3. Kommun"
],
"summary": "Hämta alla skolenheter för en kommun",
"description": "Via detta API kan alla skolenheter för en kommun hämtas",
"operationId": "getSchoolUnitsForMunicipality",
"parameters": [
{
"name": "municipalityCode",
"in": "path",
"description": "Kommunkod för den kommun som skolenheter ska hämtas för",
"required": true,
"schema": {
"type": "string",
"example": "1285"
}
}
],
"responses": {
"200": {
"description": "Svarskod för om det gick att hämta alla skolenheter",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SkolenhetResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/SkolenhetResponse"
}
}
}
},
"400": {
"description": "Svarskod för om ogiltig data skickades in i parameter för anropet",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Ogiltig kommunkod"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Ogiltig kommunkod"
}
}
}
},
"404": {
"description": "Svarskod för om den angivna kommunen inte hittades",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Okänd kommunkod"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Okänd kommunkod"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/v1/huvudman": {
"get": {
"tags": [
"4. Huvudman"
],
"summary": "Hämtar alla huvudmän",
"description": "Via detta API hämtas en lista med alla aktiva huvudmän",
"operationId": "getOrganisations",
"responses": {
"200": {
"description": "Svarskod för om det gick att hämta alla huvudmän",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HuvudmanResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/HuvudmanResponse"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/skolenhetsregistret/v1/huvudman/{organisationNumber}": {
"get": {
"tags": [
"4. Huvudman"
],
"summary": "Hämta information om en huvudman",
"description": "Via detta API kan detaljerad information om en huvudman hämtas",
"operationId": "getOrganisation",
"parameters": [
{
"name": "organisationNumber",
"in": "path",
"description": "Organisationsnummer för den huvudman som ska hämtas",
"required": true,
"schema": {
"type": "string",
"example": "2120000142"
}
}
],
"responses": {
"200": {
"description": "Svarskod för om det gick att hämta huvudman",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HuvudmanInfoResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/HuvudmanInfoResponse"
}
}
}
},
"400": {
"description": "Svarskod för om ogiltig data skickades in i parameter för anropet",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Organisationsnummer är ogiltigt"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Organisationsnummer är ogiltigt"
}
}
}
},
"404": {
"description": "Svarskod för om den angivna huvudmannen inte hittades",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Data saknas för datum 2022-06-22"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Data saknas för datum 2022-06-22"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/skolenhetsregistret/v1/huvudman/{organisationNumber}/{searchDate}": {
"get": {
"tags": [
"4. Huvudman"
],
"summary": "Hämta information om en huvudman vid ett visst datum",
"description": "Via detta API kan detaljerad information om hur en huvudman såg ut vid ett visst datum hämtas",
"operationId": "getOrganisationForDate",
"parameters": [
{
"name": "organisationNumber",
"in": "path",
"description": "Organisationsnummer för den huvudman som ska hämtas",
"required": true,
"schema": {
"type": "string",
"example": "2120000142"
}
},
{
"name": "searchDate",
"in": "path",
"description": "Sökdatum",
"required": true,
"schema": {
"type": "string",
"example": "20210301"
}
}
],
"responses": {
"200": {
"description": "Svarskod för om det gick att hämta huvudman",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HuvudmanInfoResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/HuvudmanInfoResponse"
}
}
}
},
"400": {
"description": "Svarskod för om ogiltig data skickades in i parameter för anropet",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Felaktigt datum"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Felaktigt datum"
}
}
}
},
"404": {
"description": "Svarskod för om den angivna huvudmannen inte hittades",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Data saknas för datum 2022-06-22"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Data saknas för datum 2022-06-22"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/skolenhetsregistret/v1/skolenhet/huvudman/{organisationNumber}": {
"get": {
"tags": [
"4. Huvudman"
],
"summary": "Hämta alla skolenheter för en huvudman",
"description": "Via detta API kan alla skolenheter för en huvudman hämtas",
"operationId": "getSchoolUnitsForOrganisation",
"parameters": [
{
"name": "organisationNumber",
"in": "path",
"description": "Organisationsnummer för den huvudman som skolenheter ska hämtas för",
"required": true,
"schema": {
"type": "string",
"example": "2120000142"
}
}
],
"responses": {
"200": {
"description": "Svarskod för om det gick att hämta alla skolenheter",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SkolenhetResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/SkolenhetResponse"
}
}
}
},
"400": {
"description": "Svarskod för om ogiltig data skickades in i parameter för anropet",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Organisationsnummer är ogiltigt"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Organisationsnummer är ogiltigt"
}
}
}
},
"404": {
"description": "Svarskod för om den angivna huvudmannen inte hittades",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Okänd huvudman"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Okänd huvudman"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/skolenhetsregistret/v1/harbetygsratt": {
"get": {
"tags": [
"5. Betygsrätt"
],
"summary": "Hämta alla skolenheter med betygsratt",
"description": "Via detta API kan alla skolenheter med betygsrätt hämtas",
"operationId": "getGradingRights",
"responses": {
"200": {
"description": "Svarskod för om det gick att hämta alla skolenheter",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BetygsrattResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/BetygsrattResponse"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/skolenhetsregistret/v1/diff/skolenhet/{date}": {
"get": {
"tags": [
"6. Diff"
],
"summary": "Lista skolenhetskod för alla skolenheter som ändrats sedan angivet datum",
"description": "Via detta API kan skolenhetskod för alla skolenheter som ändrats sedan angivet datum hämtas",
"operationId": "getSchoolUnitsDiff",
"parameters": [
{
"name": "date",
"in": "path",
"description": "Sökdatum",
"required": true,
"schema": {
"type": "string",
"example": "20220301"
}
}
],
"responses": {
"200": {
"description": "Svarskod för om det gick att lista med skolenhetskoder",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SkolenhetDiffResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/SkolenhetDiffResponse"
}
}
}
},
"400": {
"description": "Svarskod för om ogiltig data skickades in i parameter för anropet",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Felaktigt datum"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Felaktigt datum"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/skolenhetsregistret/v1/diff/huvudman/{date}": {
"get": {
"tags": [
"6. Diff"
],
"summary": "Lista organisationsnummer för alla huvudmän som ändrats sedan angivet datum",
"description": "Via detta API kan organisationsnummer för alla huvudmän som ändrats sedan angivet datum hämtas",
"operationId": "getDiff",
"parameters": [
{
"name": "date",
"in": "path",
"description": "Sökdatum",
"required": true,
"schema": {
"type": "string",
"example": "20220301"
}
}
],
"responses": {
"200": {
"description": "Svarskod för om det gick att lista med organisationsnummer",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HuvudmanDiffResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/HuvudmanDiffResponse"
}
}
}
},
"400": {
"description": "Svarskod för om ogiltig data skickades in i parameter för anropet",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Felaktigt datum"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Felaktigt datum"
}
}
}
},
"500": {
"$ref": "#/components/responses/500"
}
}
}
},
"/syllabus/v1/subjects": {
"get": {
"tags": [
"1. Ämnen"
],
"summary": "Hämta lista med ämnen.",
"description": "Här returneras översiktlig information om ämnen i <b>SubjectsResponse</b>. Med tidsintervall kan du styra om hämtning av gällande, framtida, upphörda alternativt modifierade ämnen ska ske, default är LATEST, vilket innebär att gällande ämnen hämtas. Det finns även möjlighet att filtrera på skoltyp, ",
"operationId": "listSubjects",
"parameters": [
{
"name": "schooltype",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "<b>Skoltyp</b><br/>Ange kod för skoltyp (val av skoltyp aktiverar även inkludering av kurser i svaret). <br/> <br/>Möjliga värden på skoltyp finns att hämta under <i>Skoltyper</i> på sidan med värdeförråd i Syllabus API <a href=\"https://api.skolverket.se/syllabus/v1/valuestore/schooltypes\">https://api.skolverket.se/syllabus/v1/valuestore/schooltypes</a> (i rullgardinsmenyn i övre högra hörnet på sidan).<br/><br/>Om ingen skoltyp anges hämtas ämnen för samtliga skoltyper."
},
{
"name": "timespan",
"in": "query",
"required": false,
"schema": {
"type": "string",
"enum": [
"LATEST",
"FUTURE",
"EXPIRED",
"MODIFIED"
],
"default": "LATEST"
},
"description": "<b>Tidsintervall</b></br> Välj tidsintervall utifrån något av nedanstående alternativ: <ul> <li>LATEST (<b>default</b>) - Hämtar senast gällande version vid angivet sökdatum (`max(version) för max(startDate)` som har `startDate <= Sökdatum`)</li> <li>FUTURE - Hämtar version/er som börjar gälla efter angivet sökdatum (`startDate > Sökdatum`)</li> <li>EXPIRED - Hämtar utgångna ämnen vid sökdatum (`endDate < Sökdatum` för senaste versionen av ett ämne)</li> <li>MODIFIED - Hämtar ändrade versioner med ändringsdatum från och med angivet sökdatum (`modifiedDate >= Sökdatum`)</li> </ul>\n"
},
{
"name": "typeOfSyllabus",
"in": "query",
"required": false,
"schema": {
"type": "string",
"enum": [
"ALL",
"SUBJECT_SYLLABUS",
"SUBJECT_AREA_SYLLABUS",
"GRADE_SUBJECT_SYLLABUS",
"GRADE_SUBJECT_AREA_SYLLABUS",
"GRVUX_COURSE",
"GRVUX_PARTIAL_COURSE",
"SFI_SUBJECT_SYLLABUS",
"COURSE_SYLLABUS",
"OTHER_COURSE_SYLLABUS",
"COURSE_SYLLABUS_SPAN"
],
"default": "ALL"
},
"description": "<b>Typ av ämne</b> <br> Filtrera på önskad ämnestyp, enligt nedan:<br/> \n<ul> <li>ALL (<b>default</b>) - Hämtar alla, oavsett ämnestyp</li><br>\n<li>SUBJECT_SYLLABUS - Hämtar ämnesplaner med <b>kurser</b></li>\n<li>GRADE_SUBJECT_SYLLABUS - Hämtar ämnesplaner med <b>nivåer</b></li><br/>\n<li>SUBJECT_AREA_SYLLABUS - Hämtar kursplaner för ämnesområden och ämnesområden med <b>kurser</b></li>\n<li>GRADE_SUBJECT_AREA_SYLLABUS - Hämtar ämnesområdesplaner med <b>nivåer</b></li><br/>\n<li>GRVUX_COURSE - Hämtar kursplaner för kommunal vuxenutbildning på grundläggande nivå och som anpassad utbildning på grundläggande nivå</li> \n<li>GRVUX_PARTIAL_COURSE - Hämtar n"
},
{
"name": "date",
"in": "query",
"required": false,
"schema": {
"type": "string",
"format": "date"
},
"description": "<b>Sökdatum</b> <br/> Format YYYY-MM-DD med <i>idag</i> som <b>default </b>, dvs om inget datum anges så används dagens datum."
}
],
"responses": {
"200": {
"description": "Exempel på respons. Exemplet speglar anrop med Skoltyp där även kurser listas. Sker anrop utan skoltyp innehåller svaret inga kurser.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubjectsResponse"
}
}
}
},
"400": {
"description": "Svarskod vid felaktigt anrop.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"errorCode": 400,
"message": "Felaktigt anrop"
}
}
}
},
"404": {
"description": "Svarskod vid tomt responsobjekt.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"errorCode": 404,
"message": "Tomt svar"
}
}
}
},
"500": {
"description": "Svarskod vid internt serverfel",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"errorCode": 500,
"message": "Internt serverfel"
}
}
}
}
}
}
},
"/syllabus/v1/subjects/{code}": {
"get": {
"tags": [
"2. Ämne"
],
"summary": "Hämta gällande ämne för valt datum.",
"description": "Här returneras detaljerad information om den version av ett ämne som gäller vid angivet sökdatum i <b>SubjectResponse</b>.\n",
"operationId": "readSubject",
"parameters": [
{
"name": "code",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "<b>Ämneskod</b><br/>Ange fullständig ämneskod. Hämta mer detaljerad information om ämnen som listats ovan alternativt hämta giltiga ämneskoder under <i>Kodlistor</i> på sidan med värdeförråd i Syllabus API <a href=\"https://api.skolverket.se/syllabus/v1/valuestore/subjectandcoursecodes\">https://api.skolverket.se/syllabus/v1/valuestore/subjectandcoursecodes</a> eller på <a href=\"https://www.skolverket.se\">https://www.skolverket.se</a>."
},
{
"name": "date",
"in": "query",
"required": false,
"schema": {
"type": "string",
"format": "date",
"nullable": true
},
"description": "<b>Sökdatum</b> <br/> Format YYYY-MM-DD med <i>idag</i> som <b>default </b>, dvs om inget datum anges så används dagens datum.<br/>(`max(version) för max(startDate) där startDate <= Sökdatum`)"
}
],
"responses": {
"200": {
"description": "Exempel på respons",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubjectResponse"
}
}
}
},
"400": {
"description": "Svarskod vid felaktigt anrop",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"errorCode": 400,
"message": "Felaktigt anrop"
}
}
}
},
"404": {
"description": "Svarskod vid tomt responsobjekt.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"errorCode": 404,
"message": "Tomt svar"
}
}
}
},
"500": {
"description": "Svarskod vid internt serverfel",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"errorCode": 500,
"message": "Internt serverfel"
}
}
}
}
}
}
},
"/syllabus/v1/subjects/{code}/versions": {
"get": {
"tags": [
"2. Ämne"
],
"summary": "Hämta lista med samtliga versioner av ett ämne.",
"description": "Här returneras översiktlig information om samtliga versioner av ett ämne i <b>SubjectsResponse</b>.\n",
"parameters": [
{
"name": "code",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "<b>Ämneskod</b><br/>Ange fullständig ämneskod. Hämta mer detaljerad information om ämnen som listats ovan alternativt hämta giltiga ämneskoder under <i>Kodlistor</i> på sidan med värdeförråd i Syllabus API <a href=\"https://api.skolverket.se/syllabus/v1/valuestore/subjectandcoursecodes\">https://api.skolverket.se/syllabus/v1/valuestore/subjectandcoursecodes</a> eller på <a href=\"https://www.skolverket.se\">https://www.skolverket.se</a>. Ämnen i svaret sorteras efter <i>senast gällande</i> i fallande ordning (`startDate DESC, version DESC`)."
}
],
"responses": {
"200": {
"description": "Exempel på respons",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubjectsResponse"
}
}
}
},
"400": {
"description": "Svarskod vid felaktigt anrop",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"errorCode": 400,
"message": "Felaktigt anrop"
}
}
}
},
"404": {
"description": "Svarskod vid tomt responsobjekt.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"errorCode": 404,
"message": "Tomt svar"
}
}
}
},
"500": {
"description": "Svarskod vid internt serverfel",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"errorCode": 500,
"message": "Internt serverfel"
}
}
}
}
},
"operationId": "getSubjectVersions"
}
},
"/syllabus/v1/subjects/{code}/versions/{version}": {
"get": {
"tags": [
"2. Ämne"
],
"summary": "Hämta en specifik version av ett ämne.",
"description": "Här returneras detaljerad information om angiven version av ett ämne i <b>SubjectResponse</b>.\n",
"operationId": "readSubjectVersion",
"parameters": [
{
"name": "code",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "<b>Ämneskod</b><br/>Ange fullständig ämneskod. Hämta mer detaljerad information om ämnen som listats ovan alternativt hämta giltiga ämneskoder under <i>Kodlistor</i> på sidan med värdeförråd i Syllabus API <a href=\"https://api.skolverket.se/syllabus/v1/valuestore/subjectandcoursecodes\">https://api.skolverket.se/syllabus/v1/valuestore/subjectandcoursecodes</a> eller på <a href=\"https://www.skolverket.se\">https://www.skolverket.se</a>."
},
{
"name": "version",
"in": "path",
"required": true,
"schema": {
"type": "integer",
"format": "int32"
},
"description": "<b>Version</b> (Siffror)"
}
],
"responses": {
"200": {
"description": "Exempel på respons",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubjectResponse"
}
}
}
},
"400": {
"description": "Svarskod vid felaktigt anrop",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"errorCode": 400,
"message": "Felaktigt anrop"
}
}
}
},
"404": {
"description": "Svarskod vid tomt responsobjekt.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"errorCode": 404,
"message": "Tomt svar"
}
}
}
},
"500": {
"description": "Svarskod vid internt serverfel",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"errorCode": 500,
"message": "Internt serverfel"
}
}
}
}
}
}
}
},
"tags": [
{
"name": "1. Skolenhet",
"description": ""
},
{
"name": "2. Skolform",
"description": ""
},
{
"name": "3. Kommun",
"description": ""
},
{
"name": "4. Huvudman",
"description": ""
},
{
"name": "5. Betygsrätt",
"description": ""
},
{
"name": "6. Diff",
"description": ""
}
],
"components": {
"schemas": {
"Category": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "Kapitel 4-ämne"
},
"code": {
"type": "string",
"example": "COMMON2"
}
}
},
"CentralContent": {
"type": "object",
"properties": {
"text": {
"type": "string",
"example": "<h4>Undervisningen i kursen ska behandla följande centrala innehåll:</h4><p><strong>Matematik inom ..."
},
"year": {
"type": "string",
"example": "1-3"
},
"typeOfCentralContent": {
"type": "string",
"example": "WITHIN_STUDENT_CHOICE"
}
}
},
"Course": {
"type": "object",
"properties": {
"codeHeading": {
"type": "string",
"example": "<h3>Kurskod: MATMAT01a</h3>"
},
"code": {
"type": "string",
"example": "MATMAT01a"
},
"previousCode": {
"type": "string",
"example": "MATMAN01a"
},
"nameHeading": {
"type": "string",
"example": "<h2>Matematik 1a, 100 poäng</h2>"
},
"name": {
"type": "string",
"example": "Matematik 1a"
},
"englishName": {
"type": "string",
"example": "Mathematics 1a"
},
"points": {
"type": "string",
"example": "100"
},
"typeOfSyllabus": {
"type": "string",
"example": "COURSE_IN_SUBJECT_SYLLABUS"
},
"sortOrder": {
"type": "integer",
"format": "int32",
"example": "1"
},
"description": {
"type": "string",
"example": "<p>Kursen matematik 1a omfattar punkterna 1–6 under rubriken Ämnets syfte. I kursen behandlas grundläggande kunskaper i ämnet.</p>"
},
"version": {
"type": "integer",
"format": "int32",
"example": 3
},
"versionInfo": {
"type": "string",
"example": "Kunskapskrav har bytt namn till betygskriterier ..."
},
"modifiedDate": {
"type": "string",
"example": "2023-01-01"
},
"subjectCode": {
"type": "string",
"example": ""
},
"applianceDate": {
"type": "string",
"example": "2023-01-01"
},
"validTo": {
"type": "string",
"example": "2023-01-01"
},
"centralCntHeading": {
"type": "string",
"example": "<h3>Centralt innehåll</h3>"
},
"centralContent": {
"$ref": "#/components/schemas/CentralContent"
},
"knowledgeReqsHeading": {
"type": "string",
"example": "<h3>Betygskriterier</h3>"
},
"knowledgeRequirements": {
"type": "array",
"items": {
"$ref": "#/components/schemas/KnowledgeRequirement"
}
},
"gers": {
"type": "string",
"example": "B1/B1+ (endast i SFI)"
},
"studyPathDescription": {
"type": "string",
"example": "SFIKUD91, SFIKUD92, SFIKUD93 (endast i SFI)"
}
}
},
"KnowledgeRequirement": {
"type": "object",
"properties": {
"text": {
"type": "string",
"example": "<p>\"<h4>Betyget E</h4><p>Eleven beskriver <strong>grundläggande</strong> begrepp och samband..."
},
"gradeStep": {
"type": "string",
"example": "GK"
}
}
},
"Subject": {
"type": "object",
"properties": {
"code": {
"type": "string",
"example": "MAT"
},
"name": {
"type": "string",
"example": "Matematik"
},
"englishName": {
"type": "string",
"example": "Mathematics"
},
"typeOfSyllabus": {
"type": "string",
"example": "SUBJECT_SYLLABUS"
},
"startDate": {
"type": "string",
"example": "2023-01-01"
},
"endDate": {
"type": "string",
"example": "2025-01-01"
},
"modifiedDate": {
"type": "string",
"example": "2023-01-01"
},
"validTo": {
"type": "string",
"example": "2025-01-01"
},
"version": {
"type": "integer",
"format": "int32",
"example": "1"
},
"versionInfo": {
"type": "string",
"example": "Info om varför denna version är skapad ..."
},
"pointHeading": {
"type": "string",
"example": "<h2>Verksamhetspoäng: 350</h2>"
},
"points": {
"type": "string",
"example": "100"
},
"skolfsGrund": {
"type": "string",
"example": "2022:17"
},
"skolfsAndring": {
"type": "string",
"example": "2022:17"
},
"gradeScale": {
"type": "string",
"example": "A-F"
},
"nameHeading": {
"type": "string",
"example": "<h2>Matematik</h2>"
},
"description": {
"type": "string",
"example": "<p>Matematiken har en flertusenårig historia med bidrag från många kulturer. Den utvecklas såväl..."
},
"purposeHeading": {
"type": "string",
"example": "<h3>Syfte</h3>"
},
"purpose": {
"type": "string",
"example": "<p>Undervisningen i ämnet matematik ska syfta till att eleverna utvecklar kunskaper om matematik och matematikens användning ..."
},
"categories": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Category"
}
},
"schoolTypes": {
"type": "array",
"items": {
"type": "string"
},
"example": [
"GY",
"GYAN"
]
},
"courses": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Course"
}
},
"centralCntHeading": {
"type": "string",
"example": "<h3>Centralt innehåll</h3>"
},
"centralContents": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CentralContent"
}
},
"knowledgeReqsHeading": {
"type": "string",
"example": "<h2>KRITERIER FÖR BEDÖMNING AV KUNSKAPER OCH BETYGSKRITERIER I ÄMNET MATEMATIK</h2>"
},
"knowledgeRequirements": {
"type": "array",
"items": {
"$ref": "#/components/schemas/KnowledgeRequirement"
}
}
}
},
"CourseCoreInfo": {
"type": "object",
"properties": {
"code": {
"type": "string",
"example": "MATMAT01a"
},
"name": {
"type": "string",
"example": "Matematik 1a"
},
"point": {
"type": "string",
"example": "100"
},
"sortOrder": {
"type": "integer",
"format": "int32",
"example": "1"
}
}
},
"SubjectInfo": {
"type": "object",
"properties": {
"code": {
"type": "string",
"example": "MAT"
},
"name": {
"type": "string",
"example": "Matematik"
},
"version": {
"type": "integer",
"format": "int32",
"example": "1"
},
"startDate": {
"type": "string",
"example": "2022-07-01"
},
"endDate": {
"type": "string",
"example": "2025-06-31"
},
"points": {
"type": "string",
"example": "100"
},
"modifiedDate": {
"type": "string",
"example": "2023-04-14"
},
"skolfsGrund": {
"type": "string",
"example": "2022:17 (Visas endast vid anrop via ListSubjectVersions)"
},
"skolfsAndring": {
"type": "string",
"example": "2022:17 (Visas endast vid anrop via ListSubjectVersions)"
},
"typeOfSyllabus": {
"type": "string",
"example": "SUBJECT_SYLLABUS"
},
"categories": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Category"
}
},
"schoolTypes": {
"type": "array",
"items": {
"type": "string",
"example": [
"GY",
"VUXGY"
]
}
},
"courses": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CourseCoreInfo"
}
}
}
},
"SubjectResponse": {
"type": "object",
"properties": {
"dataOrigin": {
"type": "string",
"example": "Syllabus API - Skolverket"
},
"calledMethod": {
"type": "string",
"example": "ReadSubject/ReadSubjectVersion"
},
"totalElements": {
"type": "integer",
"format": "int32",
"example": "1"
},
"processingTime": {
"type": "string",
"example": "CACHED 1 min, until 2023-04-17T14:20:45.912404400 / 153 ms"
},
"startedCaching": {
"type": "string",
"format": "date-time",
"example": "2023-03-15T14:11:19.7781738"
},
"codeParam": {
"type": "string",
"example": "MAT"
},
"dateParam": {
"type": "string",
"example": "2023-03-15"
},
"versionParam": {
"type": "integer",
"format": "int32",
"example": "1"
},
"subject": {
"$ref": "#/components/schemas/Subject"
}
}
},
"SubjectsResponse": {
"type": "object",
"properties": {
"dataOrigin": {
"type": "string",
"example": "Syllabus API - Skolverket"
},
"calledMethod": {
"type": "string",
"example": "ListSubjects/ListSubjectVersions"
},
"totalElements": {
"type": "integer",
"format": "int32",
"example": "2"
},
"processingTime": {
"type": "string",
"example": "CACHED 1 min, until 2023-04-17T14:20:45.912404400 / 153 ms"
},
"startedCaching": {
"type": "string",
"format": "date-time",
"example": "2023-03-15T14:11:19.7781738"
},
"codeParam": {
"type": "string",
"example": "MAT"
},
"dateParam": {
"type": "string",
"example": "2023-03-15"
},
"versionParam": {
"type": "integer",
"format": "int32",
"example": "1"
},
"timeSpanParam": {
"type": "string",
"example": "LATEST"
},
"schoolTypeParam": {
"type": "string",
"example": "GY"
},
"subjects": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SubjectInfo"
}
}
}
},
"Error": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"example": 404
},
"message": {
"type": "string",
"example": "Tomt svar"
}
}
},
"SkolenhetResponse": {},
"SkolenhetInfoResponse": {},
"SkolformResponse": {},
"KommunResponse": {},
"HuvudmanResponse": {},
"HuvudmanInfoResponse": {},
"BetygsrattResponse": {},
"SkolenhetDiffResponse": {},
"HuvudmanDiffResponse": {}
},
"responses": {
"500": {
"description": "Svarskod för om det har skett ett internt fel i applikationen",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Internt fel"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/RestApiErrorResponse"
},
"example": {
"Message": "Internt fel"
}
}
}
}
}
}
}