> ## 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 en lista med organisationer.



## OpenAPI

````yaml https://meitner-api-docs.s3.eu-north-1.amazonaws.com/meitner_ss12000_version2_1_0.yaml get /organisations
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:
  /organisations:
    get:
      tags:
        - Organisation
      summary: Hämta en lista med organisationer.
      parameters:
        - description: Begränsa urvalet till utpekade organisations-ID:n.
          in: query
          name: parent
          schema:
            items:
              format: uuid
              type: string
            type: array
        - description: >
            Begränsa urvalet till de skolenheter som har den angivna
            Skolenhetskoden. En Identifierare för skolenheten enligt Skolverket.
          in: query
          name: schoolUnitCode
          schema:
            items:
              type: string
            type: array
        - description: >
            Begränsa urvalet till de organisationselement som har den angivna
            koden.
          in: query
          name: organisationCode
          schema:
            items:
              type: string
            type: array
        - description: >
            Begränsa urvalet till de organisationselement som har angiven
            kommunkod.
          in: query
          name: municipalityCode
          schema:
            type: string
        - description: Begränsa urvalet till utpekade typ.
          in: query
          name: type
          schema:
            items:
              $ref: '#/components/schemas/OrganisationTypeEnum'
            type: array
        - description: >
            Begränsa urvalet till de organisationselement som har den angivna
            skolformen.
          in: query
          name: schoolTypes
          schema:
            items:
              $ref: '#/components/schemas/SchoolTypesEnum'
            type: array
        - description: >
            Begränsa urvalet till organisationselement som har ett startDate
            värde innan eller på det angivna datumet (RFC 3339-format, t.ex.
            "2016-10-15"). 

            Poster med ett endDate som ej är satt, tas alltid med.
          in: query
          name: startDate.onOrBefore
          schema:
            format: date
            type: string
        - description: >
            Begränsa urvalet till organisationselement som har ett startDate
            värde på eller efter det angivna datumet (RFC 3339-format, t.ex.
            "2016-10-15"). 

            Poster med ett endDate som ej är satt, tas alltid med.
          in: query
          name: startDate.onOrAfter
          schema:
            format: date
            type: string
        - description: >
            Begränsa urvalet till organisationselement som har ett endDate värde
            innan eller på det angivna datumet (RFC 3339-format, t.ex.
            "2016-10-15"). 

            Poster med ett endDate som ej är satt, tas alltid med.
          in: query
          name: endDate.onOrBefore
          schema:
            format: date
            type: string
        - description: >
            Begränsa urvalet till organisationselement som har ett endDate värde
            på eller efter det angivna datumet (RFC 3339-format, t.ex.
            "2016-10-15"). 

            Poster med ett endDate som ej är satt, tas alltid med.
          in: query
          name: endDate.onOrAfter
          schema:
            format: date
            type: string
        - description: >
            Endast poster skapade på eller före detta timestamp (RFC 3339
            format, tex "2015-12-12T10:30:00+01:00"). Inkluderande.
          in: query
          name: meta.created.before
          schema:
            format: date-time
            type: string
        - description: >
            Endast poster skapade efter detta timestamp (RFC 3339 format, tex
            "2015-12-12T10:30:00+01:00"). Exkluderande.
          in: query
          name: meta.created.after
          schema:
            format: date-time
            type: string
        - description: >
            Endast poster modifierade på eller före detta timestamp (RFC 3339
            format, tex "2015-12-12T10:30:00+01:00"). Inkluderande.
          in: query
          name: meta.modified.before
          schema:
            format: date-time
            type: string
        - description: >
            Endast poster modifierade efter detta timestamp (RFC 3339 format,
            tex "2015-12-12T10:30:00+01:00"). Exkluderande.
          in: query
          name: meta.modified.after
          schema:
            format: date-time
            type: string
        - description: Returnera `displayName` för alla refererade objekt.
          in: query
          name: expandReferenceNames
          schema:
            type: boolean
        - in: query
          name: sortkey
          schema:
            enum:
              - ModifiedDesc
              - DisplayNameAsc
            type: string
        - description: >
            Antal poster som ska visas i resultatet. Utelämnas det så returnas
            så många poster som möjligt av servern, se `pageToken`.
          in: query
          name: limit
          required: false
          schema:
            minimum: 1
            type: integer
        - description: >
            Ett opakt värde som servern givit som svar på en tidigare ställd
            fråga. Kan inte komibineras med andra filter men väl med `limit`.
          in: query
          name: pageToken
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Organisations'
          description: Anropet lyckades.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            Filter (ex `sortkey`, `meta.modified.after`, `meta.modified.before`,
            `meta.created.after`, `meta.created.before` etc.) kan inte
            kombineras med `pageToken`.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Åtkomst nekad.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Okänt fel.
components:
  schemas:
    OrganisationTypeEnum:
      description: >
        Typ av organisation. Notera att Stadsdel är deprekerad och kommer tas
        bort i nästa version. Rimlig synonym är Förvaltning.
      enum:
        - Huvudman
        - Verksamhetsområde
        - Förvaltning
        - Rektorsområde
        - Skola
        - Skolenhet
        - Varumärke
        - Bolag
        - Övrigt
      title: Code_OrganisationType
      type: string
    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
    Organisations:
      example:
        data:
          - address:
              country: country
              countyCode: 0
              streetAddress: streetAddress
              postalCode: postalCode
              locality: locality
              type: Besöksadress
              municipalityCode: 6
              realEstateDesignation: realEstateDesignation
            contactInfo:
              - infoType: Support
                info: info
              - infoType: Support
                info: info
            endDate: '2000-01-23T00:00:00.000Z'
            displayName: displayName
            municipalityCode: municipalityCode
            url: https://openapi-generator.tech
            organisationType: null
            schoolTypes:
              - null
              - null
            phoneNumber: phoneNumber
            organisationCode: organisationCode
            meta:
              created: '2000-01-23T04:56:07.000Z'
              modified: '2000-01-23T04:56:07.000Z'
            id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
            parentOrganisation: null
            organisationNumber: organisationNumber
            schoolUnitCode: schoolUnitCode
            email: email
            startDate: '2000-01-23T00:00:00.000Z'
          - address:
              country: country
              countyCode: 0
              streetAddress: streetAddress
              postalCode: postalCode
              locality: locality
              type: Besöksadress
              municipalityCode: 6
              realEstateDesignation: realEstateDesignation
            contactInfo:
              - infoType: Support
                info: info
              - infoType: Support
                info: info
            endDate: '2000-01-23T00:00:00.000Z'
            displayName: displayName
            municipalityCode: municipalityCode
            url: https://openapi-generator.tech
            organisationType: null
            schoolTypes:
              - null
              - null
            phoneNumber: phoneNumber
            organisationCode: organisationCode
            meta:
              created: '2000-01-23T04:56:07.000Z'
              modified: '2000-01-23T04:56:07.000Z'
            id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
            parentOrganisation: null
            organisationNumber: organisationNumber
            schoolUnitCode: schoolUnitCode
            email: email
            startDate: '2000-01-23T00:00:00.000Z'
        pageToken: pageToken
      properties:
        data:
          items:
            $ref: '#/components/schemas/Organisation'
          type: array
        pageToken:
          description: >
            Om värdet är null finns inget mer att hämta på det token som
            skickades in som query parameter.
          nullable: true
          type: string
      required:
        - data
      type: object
    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
    Organisation:
      description: En skolhuvudman eller annan slags organisatorisk enhet.
      example:
        address:
          country: country
          countyCode: 0
          streetAddress: streetAddress
          postalCode: postalCode
          locality: locality
          type: Besöksadress
          municipalityCode: 6
          realEstateDesignation: realEstateDesignation
        contactInfo:
          - infoType: Support
            info: info
          - infoType: Support
            info: info
        endDate: '2000-01-23T00:00:00.000Z'
        displayName: displayName
        municipalityCode: municipalityCode
        url: https://openapi-generator.tech
        organisationType: null
        schoolTypes:
          - null
          - null
        phoneNumber: phoneNumber
        organisationCode: organisationCode
        meta:
          created: '2000-01-23T04:56:07.000Z'
          modified: '2000-01-23T04:56:07.000Z'
        id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        parentOrganisation: null
        organisationNumber: organisationNumber
        schoolUnitCode: schoolUnitCode
        email: email
        startDate: '2000-01-23T00:00:00.000Z'
      properties:
        id:
          format: uuid
          type: string
        meta:
          $ref: '#/components/schemas/Meta'
        displayName:
          description: Namn på organisationen
          type: string
        organisationCode:
          description: >-
            En kod för att identifiera organisationselementet inom
            organisationen.
          type: string
        organisationType:
          $ref: '#/components/schemas/OrganisationTypeEnum'
        organisationNumber:
          description: |
            Identitetsbeteckning för juridiska personer såsom kommun eller bolag
          type: string
        parentOrganisation:
          $ref: '#/components/schemas/Organisation_parentOrganisation'
        schoolUnitCode:
          description: >
            Skolenhetskod. Identifierare för skolenheten enligt Skolverket.
            Används för de skolformer där skolverket bestämmer en skolenhetskod
            för varje enhet.
          type: string
        schoolTypes:
          description: Anges endas för organisationselement typen Skolenhet.
          items:
            $ref: '#/components/schemas/SchoolTypesEnum'
          type: array
          uniqueItems: true
        address:
          $ref: '#/components/schemas/Organisation_address'
        municipalityCode:
          description: >
            Kommunkod. Län och kommunkod för den kommun där skolan är belägen,
            exempelvis 0180 där 01 anger länet och 80 anger kommunen.
          type: string
        url:
          description: >
            Länk till en websida med information om skolan eller
            organisationselementet.
          format: uri
          type: string
        email:
          description: |
            Epost-adress till skolan eller organisationselementet.
          format: email
          type: string
        phoneNumber:
          description: |
            Telefonnummer till en skolan eller organisationselementet.
          type: string
        contactInfo:
          items:
            $ref: '#/components/schemas/ContactInfo'
          type: array
        startDate:
          description: >
            Startdatum för organisationensdelens giltighetstid (RFC 3339-format,
            t.ex. "2016-10-15"). Gäller för alla underliggande element som inte
            har ett mer restrektivt värde. Inkluderande.
          format: date
          type: string
        endDate:
          description: >
            Slutdatum för organisationensdelens giltighetstid (RFC 3339-format,
            t.ex. "2016-10-15"). Gäller för alla underliggande element som inte
            har ett mer restrektivt värde. Inkluderande.
          format: date
          type: string
      required:
        - displayName
        - id
        - meta
        - organisationType
      title: Organisation
      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
    Organisation_parentOrganisation:
      allOf:
        - $ref: '#/components/schemas/OrganisationReference'
        - description: >
            Identifierare för en eventellt överliggande organisation. Kan ej
            peka på organisationer av typen _Skolenhet_.
    Organisation_address:
      description: Organisationens postadress
      example:
        country: country
        countyCode: 0
        streetAddress: streetAddress
        postalCode: postalCode
        locality: locality
        type: Besöksadress
        municipalityCode: 6
        realEstateDesignation: realEstateDesignation
      properties:
        type:
          enum:
            - Besöksadress
            - Leveransadress
            - Postadress
            - Fakturaadress
          title: Code_OrganisationAddressType
          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:
        - locality
        - postalCode
        - streetAddress
      type: object
    ContactInfo:
      description: >
        Kontaktuppgifter till skolan eller organisationselementet. Kan användas
        för supportkontakt och andra publika kontaktuppgifter.
      example:
        infoType: Support
        info: info
      properties:
        infoType:
          description: >
            Typ av kontaktuppgift. Publika uppgifter avser uppgifter som kan
            visas för allmänheten, såsom adress och telefonnummer till skolan.
          enum:
            - Support
            - Publik
          title: Code_OrganisationContactInfoType
          type: string
        info:
          description: >
            Beskrivning i fritext av kontaktuppgifter till skolan eller
            organisationsenheten.
          type: string
      title: ContactInfo
      type: object
    OrganisationReference:
      allOf:
        - $ref: '#/components/schemas/ObjectReference'
        - description: Referens till ett organisationselement.
          title: OrganisationReference
    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
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      scheme: bearer
      type: http

````