> ## 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 placeringar baserat på en lista av ID:n eller av Id från personer.


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




## OpenAPI

````yaml https://meitner-api-docs.s3.eu-north-1.amazonaws.com/meitner_ss12000_version2_1_0.yaml post /placements/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:
  /placements/lookup:
    post:
      tags:
        - Person
      summary: >
        Hämta många placeringar baserat på en lista av ID:n eller av Id från
        personer.
      description: >
        Istället för att hämta placeringar en i taget med en loop av GET-anrop
        så finns det även möjlighet att hämta många placeringar på en gång genom
        att skicka ett anrop med en lista med önskade placeringar.
      parameters:
        - description: Beskriver om expanderade data ska hämtas
          in: query
          name: expand
          schema:
            items:
              enum:
                - child
                - owners
              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/_placements_lookup_post_request'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlacementsArray'
          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:
    _placements_lookup_post_request:
      properties:
        ids:
          items:
            format: uuid
            type: string
          type: array
        personIds:
          items:
            format: uuid
            type: string
          type: array
      type: object
    PlacementsArray:
      items:
        $ref: '#/components/schemas/PlacementExpanded'
      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
    PlacementExpanded:
      allOf:
        - $ref: '#/components/schemas/Placement'
        - $ref: '#/components/schemas/PlacementExpanded_allOf'
    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
    PlacementExpanded_allOf:
      properties:
        _embedded:
          $ref: '#/components/schemas/PlacementExpanded_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
    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.
    PersonReference:
      allOf:
        - $ref: '#/components/schemas/ObjectReference'
        - $ref: '#/components/schemas/PersonReference_1'
    PlacementExpanded_allOf__embedded:
      properties:
        child:
          $ref: '#/components/schemas/Person'
        owners:
          items:
            $ref: '#/components/schemas/Person'
          type: array
      type: object
    SchoolUnitReference:
      allOf:
        - $ref: '#/components/schemas/ObjectReference'
        - description: Referens till ett organisationselement av typen skolenhet.
          title: OrganisationReference
    GroupReference:
      allOf:
        - $ref: '#/components/schemas/ObjectReference'
        - description: Referens till en grupp
          title: GroupReference
    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
    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
    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
    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
    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
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      scheme: bearer
      type: http

````