> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meitner.se/llms.txt
> Use this file to discover all available pages before exploring further.

# Hämta många personer baserat på en lista av ID:n eller personnummer.

> Istället för att hämta personer en i taget med en loop av GET-anrop så finns det även möjlighet att hämta många personer på en gång genom att skicka ett anrop med en lista med önskade personer.




## OpenAPI

````yaml https://meitner-api-docs.s3.eu-north-1.amazonaws.com/meitner_ss12000_version2_1_0.yaml post /persons/lookup
openapi: 3.0.2
info:
  contact:
    email: tk450@sis.se
  description: >
    Detta är en implementationsspecifikation av SS12000:2020
    [TK450](https://www.sis.se/standardutveckling/tksidor/tk400499/sistk450/)
  termsOfService: https://www.sis.se/standardutveckling/tksidor/tk400499/sistk450/
  title: SS12000
  version: 2.1.0
servers:
  - url: https://ss12000.staging.meitner.se/api/v1
    description: Staging server
  - url: https://ss12000.meitner.se/api/v1
    description: Production server
  - url: http://localhost:8600/api/v1
    description: Development server
security:
  - BearerAuth: []
tags:
  - description: Skolans organisation och grundläggande administration.
    name: Organisation
  - description: Hanterar personer och personers relationer.
    name: Person
  - description: Grupper.
    name: Grupper
  - description: Information om kurser, ämnen, program och studieplaner.
    name: Studieinformation
  - description: Aktiviteter knyter ihop lärare och elever med ämne eller kurs.
    name: Aktiviteter
externalDocs:
  description: För mer information hämtas från SIS - TK450
  url: https://sis.se/standardutveckling/tksidor/tk400499/sistk450/
paths:
  /persons/lookup:
    post:
      tags:
        - Person
      summary: Hämta många personer baserat på en lista av ID:n eller personnummer.
      description: >
        Istället för att hämta personer en i taget med en loop av GET-anrop så
        finns det även möjlighet att hämta många personer på en gång genom att
        skicka ett anrop med en lista med önskade personer.
      parameters:
        - description: Beskriver om expanderade data ska hämtas
          in: query
          name: expand
          schema:
            items:
              enum:
                - duties
                - responsibleFor
                - placements
                - ownedPlacements
                - groupMemberships
              type: string
            type: array
        - description: Returnera `displayName` för alla refererade objekt.
          in: query
          name: expandReferenceNames
          schema:
            type: boolean
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_persons_lookup_post_request'
        description: |
          En lista med personnummer och / eller uuid:n på personer.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PersonsExpandedArray'
          description: Anropet lyckades.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Åtkomst nekad.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Svaret är förstort för servern att hantera.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Okänt fel.
components:
  schemas:
    _persons_lookup_post_request:
      example:
        ids:
          - d544563a-747a-42d3-8d37-415a101537fa
        civicNos:
          - '201002037271'
      properties:
        ids:
          items:
            format: uuid
            type: string
          type: array
        civicNos:
          items:
            description: >
              Personnummer, samordningsnummer eller tillfälliga personnummer,
              och motsvarande för andra länder. För svenska personnummner
              **ska** formatet 12 tecken utan divis användas. Se exempel.
            type: string
          type: array
      type: object
    PersonsExpandedArray:
      items:
        $ref: '#/components/schemas/PersonExpanded'
      type: array
    Error:
      properties:
        code:
          description: >-
            Teknisk kod för att beskriva fel, varje källa bestämmer själv över
            möjliga felkoder.
          type: string
        message:
          description: Text för att beskriva felet.
          type: string
      required:
        - code
        - message
      type: object
    PersonExpanded:
      allOf:
        - $ref: '#/components/schemas/Person'
        - $ref: '#/components/schemas/PersonExpanded_allOf'
    Person:
      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
      properties:
        id:
          description: >
            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).
          format: uuid
          type: string
        meta:
          $ref: '#/components/schemas/Meta'
        givenName:
          description: Förnamn.
          type: string
        middleName:
          description: Mellannamn.
          type: string
        familyName:
          description: Efternamn.
          type: string
        eduPersonPrincipalNames:
          description: >
            De identifierare som ska användas för att identifiera användaren
            i skilda e-tjänster. Identifieraren ska vara en spårbar,
            persistent och globalt unik sträng. Den ska bestå av en lokalt
            unik användaridentifierare, ett '@' och en domän. En domän är
            ofta, men inte nödvändigtvis, samma som organisationens
            internet-domännamn. _Exempel: kalko@edu.goteborg.se_
          items:
            type: string
          type: array
          uniqueItems: true
        externalIdentifiers:
          items:
            $ref: '#/components/schemas/externalIdentifier'
          type: array
        civicNo:
          $ref: '#/components/schemas/Person_civicNo'
        birthDate:
          description: Födelsedatum (RFC 3339-format, t.ex. "2016-10-15")
          format: date
          type: string
        sex:
          description: Biologiskt kön
          enum:
            - Man
            - Kvinna
            - Okänt
          title: Code_Sex
          type: string
        securityMarking:
          description: |
            Återspeglar värdet från folkbokföringsregistret.
          enum:
            - Ingen
            - Sekretessmarkering
            - Skyddad folkbokföring
          title: Code_SecurityMarking
          type: string
        personStatus:
          default: Aktiv
          description: >
            Anger ifall en person har en aktiv status eller en annan status,
            såsom utvandrad eller avliden.
          enum:
            - Aktiv
            - Utvandrad
            - Avliden
          title: Code_PersonStatus
          type: string
        emails:
          description: En lista med personens epostadresser
          items:
            $ref: '#/components/schemas/Email'
          type: array
        phoneNumbers:
          description: En lista med telefonnummer till personen.
          items:
            $ref: '#/components/schemas/Phonenumber'
          type: array
        addresses:
          description: En lista med personens postadresser
          items:
            $ref: '#/components/schemas/Person_addresses_inner'
          type: array
        photo:
          description: >
            Pekar ut en resurs med en bild på personen, specificeras som en URI
            enligt RFC 3986.
          format: uri
          type: string
        enrolments:
          description: En lista med inskrivningar för personen
          items:
            $ref: '#/components/schemas/Enrolment'
          type: array
        responsibles:
          description: >
            Personens vårdnadshavare eller motsvarande relationer så som
            familjehemsförälder. Denna relation beskriver ett officiellt
            ansvarsförhållande.
          items:
            $ref: '#/components/schemas/Person_responsibles_inner'
          type: array
      required:
        - familyName
        - givenName
        - id
        - meta
      type: object
    PersonExpanded_allOf:
      properties:
        _embedded:
          $ref: '#/components/schemas/PersonExpanded_allOf__embedded'
      type: object
    Meta:
      example:
        created: '2000-01-23T04:56:07.000Z'
        modified: '2000-01-23T04:56:07.000Z'
      properties:
        created:
          description: >
            Datum och tid för när entiteten skapades (RFC 3339 format tex
            "2015-12-12T10:30:00+01:00").
          format: date-time
          type: string
        modified:
          description: >
            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.
          format: date-time
          type: string
      readOnly: true
      required:
        - created
        - modified
      title: Meta
      type: object
    externalIdentifier:
      example:
        globallyUnique: true
        context: http://linkoping.se/AD
        value: value
      properties:
        value:
          description: Identifierare för användaren.
          type: string
        context:
          description: >
            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
          type: string
        globallyUnique:
          description: >
            Anger om identifieraren är så utformad att den kan anses vara
            globalt unik.
          type: boolean
      required:
        - context
        - globallyUnique
        - value
      title: externalIdentifier
      type: object
    Person_civicNo:
      description: Personnummer.
      example:
        nationality: SE
        value: value
      properties:
        value:
          description: >
            Svenskt personnummer, tilldelat personnummer eller Skatteverkets

            samordningsnummer för personen. **Ska** anges med 12 siffror utan

            separatorer. _Exempel: 200112240123_


            Samordningsnummer ska anges med 12 siffror utan separator.

            Födelsedagen adderas med talet 60, det vill säga någon född den
            24

            i en månad få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_
          type: string
        nationality:
          default: SE
          description: >
            Landskod för det land som personnumret härstammar från, enligt ISO
            3166-1 alpha-2.
          type: string
      required:
        - value
      type: object
    Email:
      example:
        type: Privat
        value: value
      properties:
        value:
          format: email
          type: string
        type:
          enum:
            - Privat
            - Skola elev
            - Skola personal
            - Arbete övrigt
          title: Code_EmailType
          type: string
      required:
        - type
        - value
      title: Email
      type: object
    Phonenumber:
      example:
        mobile: true
        type: Hem
        value: value
      properties:
        value:
          description: Telefonnumret.
          type: string
        type:
          enum:
            - Hem
            - Arbete
          title: Code_PhoneNumberType
          type: string
        mobile:
          default: true
          type: boolean
      required:
        - mobile
        - type
        - value
      title: Phonenumber
      type: object
    Person_addresses_inner:
      example:
        country: country
        countyCode: 0
        streetAddress: streetAddress
        postalCode: postalCode
        locality: locality
        type: Folkbokföring
        municipalityCode: 6
        realEstateDesignation: realEstateDesignation
      properties:
        type:
          default: Folkbokföring
          enum:
            - Folkbokföring
            - Särskild postadress
            - Tillfällig adress
            - Postadress
          title: Code_AddressType
          type: string
        streetAddress:
          description: Gatuadress.
          type: string
        locality:
          description: Postort.
          type: string
        postalCode:
          description: Postadress.
          type: string
        countyCode:
          description: Län, kod
          type: integer
        municipalityCode:
          description: Kommun, kod
          type: integer
        realEstateDesignation:
          description: Fastighetsbeteckning
          type: string
        country:
          description: Land.
          type: string
      required:
        - country
        - locality
        - postalCode
        - streetAddress
      type: object
    Enrolment:
      example:
        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'
      properties:
        enroledAt:
          $ref: '#/components/schemas/SchoolUnitReference'
        schoolYear:
          description: >
            Värdet årskurs anger det år efter skolstarten för vilket en student
            följer undervisningen.
          maximum: 10
          minimum: 0
          type: integer
        schoolType:
          $ref: '#/components/schemas/SchoolTypesEnum'
        startDate:
          description: >
            Startdatum för inskrivningen (RFC 3339-format, t.ex.
            "2016-10-15").Inkluderande.
          format: date
          type: string
        endDate:
          description: >
            Slutdatum för inskrivningen (RFC 3339-format, t.ex. "2016-10-15").
            Inkluderande.
          format: date
          type: string
        cancelled:
          description: Inskrivningen har avbrutits i förväg.
          type: boolean
        educationCode:
          description: Studievägskod för den aktuella inskrivningen.
          type: string
        specification:
          description: >
            Kompletterande information angående innehåll i elevens utbildning,
            används som avgränsning av ett visst utbildningsalternativ för
            exempelvis lärlingsutbildning.
          type: string
      required:
        - enroledAt
        - schoolType
        - startDate
      title: Enrolment
      type: object
    Person_responsibles_inner:
      example:
        relationType: null
        person: null
      properties:
        person:
          $ref: '#/components/schemas/PersonReference'
        relationType:
          $ref: '#/components/schemas/RelationTypesEnum'
      type: object
    PersonExpanded_allOf__embedded:
      properties:
        responsibleFor:
          description: |
            De barn/barnen vilka personen har ansvar för.
          items:
            $ref: '#/components/schemas/Person_responsibles_inner'
          type: array
        placements:
          description: |
            En lista med placeringar för personen.
          items:
            $ref: '#/components/schemas/Placement'
          type: array
        ownedPlacements:
          description: |
            En lista med placeringar där personen är satt som ägare.
          items:
            $ref: '#/components/schemas/Placement'
          type: array
        duties:
          description: Personens aktuella tjänstgöring
          items:
            $ref: '#/components/schemas/Duty'
          type: array
        groupMemberships:
          description: |
            En lista med grupper där personen är medlem i
          items:
            $ref: >-
              #/components/schemas/PersonExpanded_allOf__embedded_groupMemberships
          type: array
      type: object
    SchoolUnitReference:
      allOf:
        - $ref: '#/components/schemas/ObjectReference'
        - description: Referens till ett organisationselement av typen skolenhet.
          title: OrganisationReference
    SchoolTypesEnum:
      description: |
        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
      enum:
        - 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
      title: Code_SchoolType
      type: string
    PersonReference:
      allOf:
        - $ref: '#/components/schemas/ObjectReference'
        - $ref: '#/components/schemas/PersonReference_1'
    RelationTypesEnum:
      description: >
        Värdeförråd som skall användas för olika typer av relationer till ett
        barn eller en elev.
      enum:
        - Vårdnadshavare
        - Annan ansvarig
        - God man
        - Utsedd behörig
      title: Code_RelationType
      type: string
    Placement:
      properties:
        id:
          format: uuid
          type: string
        meta:
          $ref: '#/components/schemas/Meta'
        placedAt:
          $ref: '#/components/schemas/Placement_placedAt'
        group:
          $ref: '#/components/schemas/Placement_group'
        child:
          $ref: '#/components/schemas/Placement_child'
        owners:
          description: >
            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.
          items:
            $ref: '#/components/schemas/PersonReference'
          type: array
        schoolType:
          description: Skolform för placeringen, förskola eller fritidshem
          enum:
            - FS
            - FTH
            - OPPFTH
          title: Code_SchoolType
          type: string
        startDate:
          description: >
            Startdatum för placeringen (RFC 3339-format, t.ex. "2016-10-15").
            Inkluderande.
          format: date
          type: string
        endDate:
          description: >
            Slutdatum för placeringen (RFC 3339-format, t.ex. "2016-10-15").
            Inkluderande.
          format: date
          type: string
        reason:
          description: En kod för att beskriva orsak för placeringen.
          enum:
            - Omsorgsbehov
            - Erbjuden tid
            - Eget behov
          title: Code_Reason
          type: string
        maxWeeklyScheduleHours:
          description: Anger maximal schematid per vecka för barnets placering.
          type: integer
      required:
        - child
        - id
        - meta
        - placedAt
        - schoolType
        - startDate
      title: Placement
      type: object
    Duty:
      description: referens till ett Dutyobjekt
      properties:
        id:
          description: Ett ID för tjänsten.
          format: uuid
          type: string
        meta:
          $ref: '#/components/schemas/Meta'
        person:
          $ref: '#/components/schemas/Duty_person'
        assignmentRole:
          description: >-
            Datatyp som ska användas för att beskriva arbetsuppgifter för en
            person i relation till elevgrupp. Lärares undervisning ska inte
            uttryckas som en arbetsuppgift, för detta syfte används i stället
            Aktivitet.
          items:
            $ref: '#/components/schemas/Duty_assignmentRole_inner'
          type: array
        dutyAt:
          $ref: '#/components/schemas/OrganisationReference'
        dutyRole:
          allOf:
            - $ref: '#/components/schemas/DutyRole'
            - description: >
                Syfte med tjänsten, den roll tjänsen avser, till exempel lärare
                eller rektor.
        description:
          description: >-
            Arbetsområde. Kompletterande information till personalkategori,
            exempelvis Bibliotekarie.
          type: string
        signature:
          description: En signatur för tjänstgöringen exempelvis NJN, JOAN.
          type: string
        dutyPercent:
          description: Tjänstgöringsgrad i procent
          type: integer
        hoursPerYear:
          description: Antalet timmar tjänstgöringen omfattar under ett år.
          type: integer
        startDate:
          description: >
            Startdatum för personens anställning på en viss skolenhet eller
            skola (RFC 3339-format, t.ex. "2016-10-15"). Inkluderande.
          format: date
          type: string
        endDate:
          description: >
            Slutdatum för personens anställning på en viss skolenhet eller skola
            (RFC 3339-format, e.g. "2016-10-15"). Inkluderande.
          format: date
          type: string
      required:
        - dutyAt
        - dutyRole
        - id
        - meta
        - startDate
      title: Duty
      type: object
    PersonExpanded_allOf__embedded_groupMemberships:
      properties:
        group:
          $ref: '#/components/schemas/GroupFragment'
        startDate:
          description: >
            Startdatum för personens medlemskap i gruppen (RFC 3339-format,
            t.ex. "2016-10-15"). Inkluderande.
          format: date
          type: string
        endDate:
          description: >
            Slutdatum för personens medlemskap i gruppen (RFC 3339-format, t.ex.
            "2016-10-15"). Inkluderande.
          format: date
          type: string
      type: object
    ObjectReference:
      properties:
        id:
          format: uuid
          type: string
        displayName:
          description: >
            Namn för visningsyfte för det refererade objektet. Skall endast
            returneras när query parametern `expandReferenceNames` är satt till
            "true".
          readOnly: true
          type: string
      required:
        - id
      title: ObjectReference
      type: object
    PersonReference_1:
      description: Referens till en person
      properties:
        securityMarking:
          description: |
            Återspeglar värdet från folkbokföringsregistret.
          enum:
            - Ingen
            - Sekretessmarkering
            - Skyddad folkbokföring
          title: Code_SecurityMarking
          type: string
      title: PersonReference
    Placement_placedAt:
      allOf:
        - $ref: '#/components/schemas/SchoolUnitReference'
        - description: Skolenhet där barnet är placerat.
    Placement_group:
      allOf:
        - $ref: '#/components/schemas/GroupReference'
        - description: Barngrupp eller avdelning knutet till denna placering.
    Placement_child:
      allOf:
        - $ref: '#/components/schemas/PersonReference'
        - description: Identifierare av person som placeringen avser.
    Duty_person:
      allOf:
        - $ref: '#/components/schemas/PersonReference'
        - description: Identifierare av person som tjänsten är knuten till.
    Duty_assignmentRole_inner:
      properties:
        group:
          $ref: '#/components/schemas/GroupReference'
        assignmentRoleType:
          $ref: '#/components/schemas/AssignmentRoleTypeEnum'
        startDate:
          description: >
            Startdatum för tjänstens relation till gruppen (RFC 3339-format,
            t.ex. "2016-10-15"). Inkluderande.
          format: date
          type: string
        endDate:
          description: >
            Slutdatum för tjänstens relation till gruppen (RFC 3339-format,
            t.ex. "2016-10-15"). Inkluderande.
          format: date
          type: string
      required:
        - assignmentRoleType
        - group
      type: object
    OrganisationReference:
      allOf:
        - $ref: '#/components/schemas/ObjectReference'
        - description: Referens till ett organisationselement.
          title: OrganisationReference
    DutyRole:
      description: >-
        Roller för en Duty. Förskolechef och Övriga pedagogisk personal är
        deprekerade och kommer tas bort till nästa version.
      enum:
        - Rektor
        - Lärare
        - Förskollärare
        - Barnskötare
        - Bibliotekarie
        - Lärarassistent
        - Fritidspedagog
        - Annan personal
        - Studie- och yrkesvägledare
        - Förstelärare
        - Kurator
        - Skolsköterska
        - Skolläkare
        - Skolpsykolog
        - Speciallärare/specialpedagog
        - Skoladministratör
        - Övrig arbetsledning
        - Övrig pedagogisk personal
        - Förskolechef
      title: Code_DutyRole
      type: string
    GroupFragment:
      description: >
        Group kan innehålla personer eller bara vara en tom "platshållare" utan
        medlemmar, som kan populeras vid ett senare tillfälle. Notera att
        gruppens koppling till ämnen/kurser och lärare görs via Aktivitet.
        Grupper har olika egenskaper baserat på grupptyp. Individer kan ha olika
        roller i relation till en viss grupp. Grupper har specifika egenskaper.
      example:
        groupType: null
        endDate: '2000-01-23T00:00:00.000Z'
        meta:
          created: '2000-01-23T04:56:07.000Z'
          modified: '2000-01-23T04:56:07.000Z'
        displayName: displayName
        schoolType: null
        organisation: null
        id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        startDate: '2000-01-23T00:00:00.000Z'
      properties:
        id:
          description: Identifierare för gruppen
          format: uuid
          type: string
        meta:
          $ref: '#/components/schemas/Meta'
        displayName:
          description: Gruppens benämning.
          type: string
        startDate:
          description: >
            Startdatum för gruppens giltighetstid (RFC 3339-format, t.ex.
            "2016-10-15"). Inkluderande.
          format: date
          type: string
        endDate:
          description: >
            Slutdatum för gruppens giltighetstid (RFC 3339-format, t.ex.
            "2016-10-15"). Inkluderande.
          format: date
          type: string
        groupType:
          $ref: '#/components/schemas/GroupTypesEnum'
        schoolType:
          $ref: '#/components/schemas/SchoolTypesEnum'
        organisation:
          $ref: '#/components/schemas/OrganisationReference'
      required:
        - displayName
        - groupType
        - id
        - meta
        - organisation
        - startDate
      title: Group
      type: object
    GroupReference:
      allOf:
        - $ref: '#/components/schemas/ObjectReference'
        - description: Referens till en grupp
          title: GroupReference
    AssignmentRoleTypeEnum:
      enum:
        - Mentor
        - Förskollärare
        - Barnskötare
        - Fritidspedagog
        - Specialpedagog
        - Elevhälsopersonal
        - Pedagogisk ledare
        - Schemaläggare
        - Lärarassistent
        - Administrativ personal
      title: Code_AssignmentRole
      type: string
    GroupTypesEnum:
      description: >
        Grupptyp anger vad en grupp ska användas till.

        Ett värdeförråd för att indikera anger vilka grupptyper som finns.

        * _Undervisning_ - Undervisningsgruppen är en grupp som har koppling
          till ett ämne eller en kurs, och som ska schemaläggas med undervisningstid
          ihop med en lärare.
        * _Klass_ - Klassen är en organisatorisk grupp med elever som är
        skolplacerade
          på en skola med skolform FSK, GR, GRS, SP, SAM, GY eller GYS.
          Varje elev ska vara placerad i endast en klass. Klassen kan schemaläggas
          med undervisning enligt timplan. "Klassföreståndare" kan beskrivas genom att
          koppla en _AssignmentRole_ av typen _Mentor_.
        * _Mentor_ - Grupp med elever vilka delar samma mentor/mentorer. 
          Mentor kopplas till gruppen genom en _AssignmentRole_.
        * _Provgrupp_ - Grupp med elever vilka ska genomföra ett eller flera
        prov. 

        * _Schema_ - Schemagrupper är grupper som utgör ett komplement till
          grupper av typen Undervisning. Schemagrupper ska schemaläggas för att
          åstadkomma anpassningar av schemat för enskilda elever eller grupper
          av elever. Exempel på schemagrupper är delgrupper och grupper som
          används för stödundervisning eller läxhjälp.
        * _Avdelning_ - Avdelningen är en grupp för placering inom skolformerna
          förskola eller fritidshem.
        * _Personalgrupp_ - En grupp vars medlemmar utgörs av personal.

        * _Övrigt_ - Övriga grupper är andra grupper som inte är något av
        ovanstående.
      enum:
        - Undervisning
        - Klass
        - Mentor
        - Provgrupp
        - Schema
        - Avdelning
        - Personalgrupp
        - Övrigt
      title: Code_GroupType
      type: string
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      scheme: bearer
      type: http

````