> ## 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 organisation baserat på ID



## OpenAPI

````yaml https://meitner-api-docs.s3.eu-north-1.amazonaws.com/meitner_ss12000_version2_1_0.yaml get /organisations/{id}
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/{id}:
    get:
      tags:
        - Organisation
      summary: Hämta en organisation baserat på ID
      parameters:
        - description: ID för organisationen som ska hämtas
          in: path
          name: id
          required: true
          schema:
            format: uuid
            type: string
        - description: Returnera `displayName` för alla refererade objekt.
          in: query
          name: expandReferenceNames
          schema:
            type: boolean
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Organisation'
          description: Anropet lyckades.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Felaktigt id.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Åtkomst nekad.
        '404':
          description: Posten hittades inte.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Okänt fel.
components:
  schemas:
    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
    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
    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
    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
    Organisation_parentOrganisation:
      allOf:
        - $ref: '#/components/schemas/OrganisationReference'
        - description: >
            Identifierare för en eventellt överliggande organisation. Kan ej
            peka på organisationer av typen _Skolenhet_.
    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
    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

````