Hämta många placeringar baserat på en lista av ID:n eller av Id från personer.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

expand

enum<string>[]

Beskriver om expanderade data ska hämtas

Available options:

child,

owners

expandReferenceNames

boolean

Returnera displayName för alla refererade objekt.

Body

application/json

ids

string<uuid>[]

personIds

string<uuid>[]

Response

Anropet lyckades.

string<uuid>

required

meta

Meta · object

required

Show child attributes

meta.created

string<date-time>

required

Datum och tid för när entiteten skapades (RFC 3339 format tex "2015-12-12T10:30:00+01:00").

meta.modified

string<date-time>

required

Datum och tid för när entiteten senast uppdaterades (RFC 3339 format tex "2015-12-12T10:30:00+01:00"). Tidpunkten avser den senaste tidpunkt när något av de attribut som direkt tillhör entiteten har ändrats. Attribut som kan tas fram med parametrarna expand eller expandReferenceNames räknas inte som ett attribut till entiteten, och ska således inte påverka detta värde.

Example:

{
  "created": "2000-01-23T04:56:07.000Z",
  "modified": "2000-01-23T04:56:07.000Z"
}

placedAt

OrganisationReference · object

required

Skolenhet där barnet är placerat.

Show child attributes

placedAt.id

string<uuid>

required

placedAt.displayName

string

Namn för visningsyfte för det refererade objektet. Skall endast returneras när query parametern expandReferenceNames är satt till "true".

child

PersonReference · object

required

Identifierare av person som placeringen avser.

Show child attributes

child.id

string<uuid>

required

child.displayName

string

Namn för visningsyfte för det refererade objektet. Skall endast returneras när query parametern expandReferenceNames är satt till "true".

child.securityMarking

enum<string>

Återspeglar värdet från folkbokföringsregistret.

Available options:

Ingen,

Sekretessmarkering,

Skyddad folkbokföring

schoolType

enum<string>

required

Skolform för placeringen, förskola eller fritidshem

Available options:

FS,

FTH,

OPPFTH

startDate

string<date>

required

Startdatum för placeringen (RFC 3339-format, t.ex. "2016-10-15"). Inkluderande.

group

GroupReference · object

Barngrupp eller avdelning knutet till denna placering.

Show child attributes

group.id

string<uuid>

required

group.displayName

string

Namn för visningsyfte för det refererade objektet. Skall endast returneras när query parametern expandReferenceNames är satt till "true".

owners

PersonReference · object[]

En lista med identifierare för de personer som äger placeringen. Används primärt för att styra vilka som skall kunna se och lägga schema.

Show child attributes

owners.id

string<uuid>

required

owners.displayName

string

Namn för visningsyfte för det refererade objektet. Skall endast returneras när query parametern expandReferenceNames är satt till "true".

owners.securityMarking

enum<string>

Återspeglar värdet från folkbokföringsregistret.

Available options:

Ingen,

Sekretessmarkering,

Skyddad folkbokföring

endDate

string<date>

Slutdatum för placeringen (RFC 3339-format, t.ex. "2016-10-15"). Inkluderande.

reason

enum<string>

En kod för att beskriva orsak för placeringen.

Available options:

Omsorgsbehov,

Erbjuden tid,

Eget behov

maxWeeklyScheduleHours

integer

Anger maximal schematid per vecka för barnets placering.

_embedded

object

Show child attributes

_embedded.child

object

Show child attributes

_embedded.child.id

string<uuid>

required

Ett objekt ska ha samma överförings-ID mellan samtliga ingående system och således är det ett enda namespace för de gemensamma ID:na. Objektidentifikatorn är den nyckel som skall vara persistent mellan olika processer (enl figur 1).

_embedded.child.meta

Meta · object

required

Show child attributes

_embedded.child.meta.created

string<date-time>

required

Datum och tid för när entiteten skapades (RFC 3339 format tex "2015-12-12T10:30:00+01:00").

_embedded.child.meta.modified

string<date-time>

required

Example:

{
  "created": "2000-01-23T04:56:07.000Z",
  "modified": "2000-01-23T04:56:07.000Z"
}

_embedded.child.givenName

string

required

Förnamn.

_embedded.child.familyName

string

required

Efternamn.

_embedded.child.middleName

string

Mellannamn.

_embedded.child.eduPersonPrincipalNames

string[]

De identifierare som ska användas för att identifiera användaren i skilda e-tjänster. Identifieraren ska vara en spårbar, persistent och globalt unik sträng. Den ska bestå av en lokalt unik användaridentifierare, ett '@' och en domän. En domän är ofta, men inte nödvändigtvis, samma som organisationens internet-domännamn. Exempel: [email protected]

_embedded.child.externalIdentifiers

externalIdentifier · object[]

Show child attributes

_embedded.child.externalIdentifiers.value

string

required

Identifierare för användaren.

_embedded.child.externalIdentifiers.context

string

required

Anger för vilket sammanhang användaridentifieraren ska användas. Beskriv med en URI. Värdet kan överenskommas bilateralt mellan två integrerande parter.

Example:

"http://linkoping.se/AD"

_embedded.child.externalIdentifiers.globallyUnique

boolean

required

Anger om identifieraren är så utformad att den kan anses vara globalt unik.

_embedded.child.civicNo

object

Personnummer.

Show child attributes

_embedded.child.civicNo.value

string

required

Svenskt personnummer, tilldelat personnummer eller Skatteverkets samordningsnummer för personen. Ska anges med 12 siffror utan separatorer. Exempel: 200112240123

Samordningsnummer ska anges med 12 siffror utan separator. Födelsedagen adderas med talet 60, det vill säga någon född den 24 i en månad får talet 84 som dag. Exempel: 200112840123

Saknas både personnummer och samordningsnummer så förekommer det att "tillfälligt personnummer" definieras i elevregistret. Dessa är möjliga att beskriva i detta fält och i så fall tillåts de två första positionerna efter datumdelen att vara bokstäver. Exempel: 20130101TF01

_embedded.child.civicNo.nationality

string

default:SE

Landskod för det land som personnumret härstammar från, enligt ISO 3166-1 alpha-2.

Example:

{ "nationality": "SE", "value": "value" }

_embedded.child.birthDate

string<date>

Födelsedatum (RFC 3339-format, t.ex. "2016-10-15")

_embedded.child.sex

enum<string>

Biologiskt kön

Available options:

Man,

Kvinna,

Okänt

_embedded.child.securityMarking

enum<string>

Återspeglar värdet från folkbokföringsregistret.

Available options:

Ingen,

Sekretessmarkering,

Skyddad folkbokföring

_embedded.child.personStatus

enum<string>

default:Aktiv

Anger ifall en person har en aktiv status eller en annan status, såsom utvandrad eller avliden.

Available options:

Aktiv,

Utvandrad,

Avliden

_embedded.child.emails

Email · object[]

En lista med personens epostadresser

Show child attributes

_embedded.child.emails.value

string<email>

required

_embedded.child.emails.type

enum<string>

required

Available options:

Privat,

Skola elev,

Skola personal,

Arbete övrigt

_embedded.child.phoneNumbers

Phonenumber · object[]

En lista med telefonnummer till personen.

Show child attributes

_embedded.child.phoneNumbers.value

string

required

Telefonnumret.

_embedded.child.phoneNumbers.type

enum<string>

required

Available options:

Hem,

Arbete

_embedded.child.phoneNumbers.mobile

boolean

default:true

required

_embedded.child.addresses

object[]

En lista med personens postadresser

Show child attributes

_embedded.child.addresses.streetAddress

string

required

Gatuadress.

_embedded.child.addresses.locality

string

required

Postort.

_embedded.child.addresses.postalCode

string

required

Postadress.

_embedded.child.addresses.country

string

required

Land.

_embedded.child.addresses.type

enum<string>

default:Folkbokföring

Available options:

Folkbokföring,

Särskild postadress,

Tillfällig adress,

Postadress

_embedded.child.addresses.countyCode

integer

Län, kod

_embedded.child.addresses.municipalityCode

integer

Kommun, kod

_embedded.child.addresses.realEstateDesignation

string

Fastighetsbeteckning

_embedded.child.photo

string<uri>

Pekar ut en resurs med en bild på personen, specificeras som en URI enligt RFC 3986.

_embedded.child.enrolments

Enrolment · object[]

En lista med inskrivningar för personen

Show child attributes

_embedded.child.enrolments.enroledAt

OrganisationReference · object

required

Referens till ett organisationselement av typen skolenhet.

Show child attributes

_embedded.child.enrolments.enroledAt.id

string<uuid>

required

_embedded.child.enrolments.enroledAt.displayName

string

Namn för visningsyfte för det refererade objektet. Skall endast returneras när query parametern expandReferenceNames är satt till "true".

_embedded.child.enrolments.schoolType

enum<string>

required

Följande värden används för att beskriva skolform:

FS - Förskola
FKLASS - Förskoleklass
FTH - Fritidshem
OPPFTH - Öppen fritidsverksamhet
GR - Grundskola
GRS - Grundsärskola
TR - Träningsskolan
SP - Specialskola
SAM - Sameskola
GY - Gymnasieskola
GYS - Gymnasiesärskola
VUX - Kommunal vuxenutbildning
VUXSFI - Kommunal vuxenutbildning i svenska för invandrare
VUXGR - Kommunal vuxenutbildning på grundläggande nivå
VUXGY - Kommunal vuxenutbildning på gymnasial nivå
VUXSARGR - Kommunal vuxenutbildning som särskild utbildning på grundläggande nivå
VUXSARTR - Kommunal vuxenutbildning som särskild utbildning som motsvarar träningsskolan
VUXSARGY - Kommunal vuxenutbildning som särskild utbildning på gymnasial nivå
SFI - Utbildning i svenska för invandrare
SARVUX - Särskild utbildning för vuxna
SARVUXGR - Särskild utbildning för vuxna på grundläggande nivå
SARVUXGY - Särskild utbildning för vuxna på gymnasial nivå
SFI - Kommunal vuxenutbildning i svenska för invandrare
KU - Kulturskola
YH - Yrkeshögskola
FHS - Folkhögskola
STF - Studieförbund
KKU - Konst- och kulturutbildning
HS - Högskola
ABU - Arbetsmarknadsutbildning
AU - Annan undervisning

Available options:

FS,

FKLASS,

FTH,

OPPFTH,

GR,

GRS,

TR,

SP,

SAM,

GY,

GYS,

VUX,

VUXSFI,

VUXGR,

VUXGY,

VUXSARGR,

VUXSARTR,

VUXSARGY,

SFI,

SARVUX,

SARVUXGR,

SARVUXGY,

KU,

YH,

FHS,

STF,

KKU,

HS,

ABU,

AU

_embedded.child.enrolments.startDate

string<date>

required

Startdatum för inskrivningen (RFC 3339-format, t.ex. "2016-10-15").Inkluderande.

_embedded.child.enrolments.schoolYear

integer

Värdet årskurs anger det år efter skolstarten för vilket en student följer undervisningen.

Required range: 0 <= x <= 10

_embedded.child.enrolments.endDate

string<date>

Slutdatum för inskrivningen (RFC 3339-format, t.ex. "2016-10-15"). Inkluderande.

_embedded.child.enrolments.cancelled

boolean

Inskrivningen har avbrutits i förväg.

_embedded.child.enrolments.educationCode

string

Studievägskod för den aktuella inskrivningen.

_embedded.child.enrolments.specification

string

Kompletterande information angående innehåll i elevens utbildning, används som avgränsning av ett visst utbildningsalternativ för exempelvis lärlingsutbildning.

_embedded.child.responsibles

object[]

Personens vårdnadshavare eller motsvarande relationer så som familjehemsförälder. Denna relation beskriver ett officiellt ansvarsförhållande.

Show child attributes

_embedded.child.responsibles.person

PersonReference · object

Referens till en person

Show child attributes

_embedded.child.responsibles.person.id

string<uuid>

required

_embedded.child.responsibles.person.displayName

string

Namn för visningsyfte för det refererade objektet. Skall endast returneras när query parametern expandReferenceNames är satt till "true".

_embedded.child.responsibles.person.securityMarking

enum<string>

Återspeglar värdet från folkbokföringsregistret.

Available options:

Ingen,

Sekretessmarkering,

Skyddad folkbokföring

_embedded.child.responsibles.relationType

enum<string>

Värdeförråd som skall användas för olika typer av relationer till ett barn eller en elev.

Available options:

Vårdnadshavare,

Annan ansvarig,

God man,

Utsedd behörig

Example:

{
  "personStatus": "Aktiv",
  "addresses": [
    {
      "country": "country",
      "countyCode": 0,
      "streetAddress": "streetAddress",
      "postalCode": "postalCode",
      "locality": "locality",
      "type": "Folkbokföring",
      "municipalityCode": 6,
      "realEstateDesignation": "realEstateDesignation"
    },
    {
      "country": "country",
      "countyCode": 0,
      "streetAddress": "streetAddress",
      "postalCode": "postalCode",
      "locality": "locality",
      "type": "Folkbokföring",
      "municipalityCode": 6,
      "realEstateDesignation": "realEstateDesignation"
    }
  ],
  "securityMarking": "Ingen",
  "givenName": "givenName",
  "sex": "Man",
  "photo": "https://openapi-generator.tech",
  "birthDate": "2000-01-23T00:00:00.000Z",
  "civicNo": { "nationality": "SE", "value": "value" },
  "phoneNumbers": [
    {
      "mobile": true,
      "type": "Hem",
      "value": "value"
    },
    {
      "mobile": true,
      "type": "Hem",
      "value": "value"
    }
  ],
  "externalIdentifiers": [
    {
      "globallyUnique": true,
      "context": "http://linkoping.se/AD",
      "value": "value"
    },
    {
      "globallyUnique": true,
      "context": "http://linkoping.se/AD",
      "value": "value"
    }
  ],
  "emails": [
    { "type": "Privat", "value": "value" },
    { "type": "Privat", "value": "value" }
  ],
  "eduPersonPrincipalNames": [
    "eduPersonPrincipalNames",
    "eduPersonPrincipalNames"
  ],
  "meta": {
    "created": "2000-01-23T04:56:07.000Z",
    "modified": "2000-01-23T04:56:07.000Z"
  },
  "familyName": "familyName",
  "middleName": "middleName",
  "enrolments": [
    {
      "endDate": "2000-01-23T00:00:00.000Z",
      "schoolType": null,
      "schoolYear": 1,
      "cancelled": true,
      "specification": "specification",
      "enroledAt": null,
      "educationCode": "educationCode",
      "programme": null,
      "startDate": "2000-01-23T00:00:00.000Z"
    },
    {
      "endDate": "2000-01-23T00:00:00.000Z",
      "schoolType": null,
      "schoolYear": 1,
      "cancelled": true,
      "specification": "specification",
      "enroledAt": null,
      "educationCode": "educationCode",
      "programme": null,
      "startDate": "2000-01-23T00:00:00.000Z"
    }
  ],
  "responsibles": [
    { "relationType": null, "person": null },
    { "relationType": null, "person": null }
  ],
  "id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91"
}

_embedded.owners

object[]

Show child attributes

_embedded.owners.id

string<uuid>

required

_embedded.owners.meta

Meta · object

required

Show child attributes

_embedded.owners.meta.created

string<date-time>

required

Datum och tid för när entiteten skapades (RFC 3339 format tex "2015-12-12T10:30:00+01:00").

_embedded.owners.meta.modified

string<date-time>

required

Example:

{
  "created": "2000-01-23T04:56:07.000Z",
  "modified": "2000-01-23T04:56:07.000Z"
}

_embedded.owners.givenName

string

required

Förnamn.

_embedded.owners.familyName

string

required

Efternamn.

_embedded.owners.middleName

string

Mellannamn.

_embedded.owners.eduPersonPrincipalNames

string[]

_embedded.owners.externalIdentifiers

externalIdentifier · object[]

Show child attributes

_embedded.owners.externalIdentifiers.value

string

required

Identifierare för användaren.

_embedded.owners.externalIdentifiers.context

string

required

Anger för vilket sammanhang användaridentifieraren ska användas. Beskriv med en URI. Värdet kan överenskommas bilateralt mellan två integrerande parter.

Example:

"http://linkoping.se/AD"

_embedded.owners.externalIdentifiers.globallyUnique

boolean

required

Anger om identifieraren är så utformad att den kan anses vara globalt unik.

_embedded.owners.civicNo

object

Personnummer.

Show child attributes

_embedded.owners.civicNo.value

string

required

Svenskt personnummer, tilldelat personnummer eller Skatteverkets samordningsnummer för personen. Ska anges med 12 siffror utan separatorer. Exempel: 200112240123

Samordningsnummer ska anges med 12 siffror utan separator. Födelsedagen adderas med talet 60, det vill säga någon född den 24 i en månad får talet 84 som dag. Exempel: 200112840123

_embedded.owners.civicNo.nationality

string

default:SE

Landskod för det land som personnumret härstammar från, enligt ISO 3166-1 alpha-2.

Example:

{ "nationality": "SE", "value": "value" }

_embedded.owners.birthDate

string<date>

Födelsedatum (RFC 3339-format, t.ex. "2016-10-15")

_embedded.owners.sex

enum<string>

Biologiskt kön

Available options:

Man,

Kvinna,

Okänt

_embedded.owners.securityMarking

enum<string>

Återspeglar värdet från folkbokföringsregistret.

Available options:

Ingen,

Sekretessmarkering,

Skyddad folkbokföring

_embedded.owners.personStatus

enum<string>

default:Aktiv

Anger ifall en person har en aktiv status eller en annan status, såsom utvandrad eller avliden.

Available options:

Aktiv,

Utvandrad,

Avliden

_embedded.owners.emails

Email · object[]

En lista med personens epostadresser

Show child attributes

_embedded.owners.emails.value

string<email>

required

_embedded.owners.emails.type

enum<string>

required

Available options:

Privat,

Skola elev,

Skola personal,

Arbete övrigt

_embedded.owners.phoneNumbers

Phonenumber · object[]

En lista med telefonnummer till personen.

Show child attributes

_embedded.owners.phoneNumbers.value

string

required

Telefonnumret.

_embedded.owners.phoneNumbers.type

enum<string>

required

Available options:

Hem,

Arbete

_embedded.owners.phoneNumbers.mobile

boolean

default:true

required

_embedded.owners.addresses

object[]

En lista med personens postadresser

Show child attributes

_embedded.owners.addresses.streetAddress

string

required

Gatuadress.

_embedded.owners.addresses.locality

string

required

Postort.

_embedded.owners.addresses.postalCode

string

required

Postadress.

_embedded.owners.addresses.country

string

required

Land.

_embedded.owners.addresses.type

enum<string>

default:Folkbokföring

Available options:

Folkbokföring,

Särskild postadress,

Tillfällig adress,

Postadress

_embedded.owners.addresses.countyCode

integer

Län, kod

_embedded.owners.addresses.municipalityCode

integer

Kommun, kod

_embedded.owners.addresses.realEstateDesignation

string

Fastighetsbeteckning

_embedded.owners.photo

string<uri>

Pekar ut en resurs med en bild på personen, specificeras som en URI enligt RFC 3986.

_embedded.owners.enrolments

Enrolment · object[]

En lista med inskrivningar för personen

Show child attributes

_embedded.owners.enrolments.enroledAt

OrganisationReference · object

required

Referens till ett organisationselement av typen skolenhet.

Show child attributes

_embedded.owners.enrolments.enroledAt.id

string<uuid>

required

_embedded.owners.enrolments.enroledAt.displayName

string

Namn för visningsyfte för det refererade objektet. Skall endast returneras när query parametern expandReferenceNames är satt till "true".

_embedded.owners.enrolments.schoolType

enum<string>

required

Följande värden används för att beskriva skolform:

FS - Förskola
FKLASS - Förskoleklass
FTH - Fritidshem
OPPFTH - Öppen fritidsverksamhet
GR - Grundskola
GRS - Grundsärskola
TR - Träningsskolan
SP - Specialskola
SAM - Sameskola
GY - Gymnasieskola
GYS - Gymnasiesärskola
VUX - Kommunal vuxenutbildning
VUXSFI - Kommunal vuxenutbildning i svenska för invandrare
VUXGR - Kommunal vuxenutbildning på grundläggande nivå
VUXGY - Kommunal vuxenutbildning på gymnasial nivå
VUXSARGR - Kommunal vuxenutbildning som särskild utbildning på grundläggande nivå
VUXSARTR - Kommunal vuxenutbildning som särskild utbildning som motsvarar träningsskolan
VUXSARGY - Kommunal vuxenutbildning som särskild utbildning på gymnasial nivå
SFI - Utbildning i svenska för invandrare
SARVUX - Särskild utbildning för vuxna
SARVUXGR - Särskild utbildning för vuxna på grundläggande nivå
SARVUXGY - Särskild utbildning för vuxna på gymnasial nivå
SFI - Kommunal vuxenutbildning i svenska för invandrare
KU - Kulturskola
YH - Yrkeshögskola
FHS - Folkhögskola
STF - Studieförbund
KKU - Konst- och kulturutbildning
HS - Högskola
ABU - Arbetsmarknadsutbildning
AU - Annan undervisning

Available options:

FS,

FKLASS,

FTH,

OPPFTH,

GR,

GRS,

TR,

SP,

SAM,

GY,

GYS,

VUX,

VUXSFI,

VUXGR,

VUXGY,

VUXSARGR,

VUXSARTR,

VUXSARGY,

SFI,

SARVUX,

SARVUXGR,

SARVUXGY,

KU,

YH,

FHS,

STF,

KKU,

HS,

ABU,

AU

_embedded.owners.enrolments.startDate

string<date>

required

Startdatum för inskrivningen (RFC 3339-format, t.ex. "2016-10-15").Inkluderande.

_embedded.owners.enrolments.schoolYear

integer

Värdet årskurs anger det år efter skolstarten för vilket en student följer undervisningen.

Required range: 0 <= x <= 10

_embedded.owners.enrolments.endDate

string<date>

Slutdatum för inskrivningen (RFC 3339-format, t.ex. "2016-10-15"). Inkluderande.

_embedded.owners.enrolments.cancelled

boolean

Inskrivningen har avbrutits i förväg.

_embedded.owners.enrolments.educationCode

string

Studievägskod för den aktuella inskrivningen.

_embedded.owners.enrolments.specification

string

Kompletterande information angående innehåll i elevens utbildning, används som avgränsning av ett visst utbildningsalternativ för exempelvis lärlingsutbildning.

_embedded.owners.responsibles

object[]

Personens vårdnadshavare eller motsvarande relationer så som familjehemsförälder. Denna relation beskriver ett officiellt ansvarsförhållande.

Show child attributes

_embedded.owners.responsibles.person

PersonReference · object

Referens till en person

Show child attributes

_embedded.owners.responsibles.person.id

string<uuid>

required

_embedded.owners.responsibles.person.displayName

string

Namn för visningsyfte för det refererade objektet. Skall endast returneras när query parametern expandReferenceNames är satt till "true".

_embedded.owners.responsibles.person.securityMarking

enum<string>

Återspeglar värdet från folkbokföringsregistret.

Available options:

Ingen,

Sekretessmarkering,

Skyddad folkbokföring

_embedded.owners.responsibles.relationType

enum<string>

Värdeförråd som skall användas för olika typer av relationer till ett barn eller en elev.

Available options:

Vårdnadshavare,

Annan ansvarig,

God man,

Utsedd behörig

Getting started

Reference

Authorizations

Query Parameters

Body

Response