components:
  headers:
    API-Version:
      schema: {}
      style: simple
    Content-Security-Policy:
      schema: {}
      style: simple
    Content-Type:
      schema: {}
      style: simple
    Date:
      schema: {}
      style: simple
    Etag:
      schema: {}
      style: simple
    Strict-Transport-Security:
      schema: {}
      style: simple
    Vary:
      schema: {}
      style: simple
    X-Content-Type-Options:
      schema: {}
      style: simple
  responses:
    5XX:
      description: Technisch probleem.
      headers:
        Content-Type:
          schema: {}
          style: simple
        Date:
          $ref: '#/components/headers/Date'
        Strict-Transport-Security:
          $ref: '#/components/headers/Strict-Transport-Security'
        X-Content-Type-Options:
          $ref: '#/components/headers/X-Content-Type-Options'
    "201":
      description: Resource toegevoegd.
      headers:
        Location:
          schema:
            format: percent-encoded-uri
          style: simple
    "400":
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/message'
      description: Ongeldige opdracht.
      headers:
        API-Version:
          $ref: '#/components/headers/API-Version'
        Content-Type:
          $ref: '#/components/headers/Content-Type'
        Date:
          $ref: '#/components/headers/Date'
        Strict-Transport-Security:
          $ref: '#/components/headers/Strict-Transport-Security'
        Vary:
          $ref: '#/components/headers/Vary'
        X-Content-Type-Options:
          $ref: '#/components/headers/X-Content-Type-Options'
    "401":
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/message'
      description: Autorisatie niet geslaagd.
      headers:
        API-Version:
          $ref: '#/components/headers/API-Version'
        Content-Type:
          $ref: '#/components/headers/Content-Type'
        Date:
          $ref: '#/components/headers/Date'
        Strict-Transport-Security:
          $ref: '#/components/headers/Strict-Transport-Security'
        Vary:
          $ref: '#/components/headers/Vary'
        X-Content-Type-Options:
          $ref: '#/components/headers/X-Content-Type-Options'
    "404":
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/message'
      description: Niet gevonden.
      headers:
        API-Version:
          $ref: '#/components/headers/API-Version'
        Content-Type:
          $ref: '#/components/headers/Content-Type'
        Date:
          $ref: '#/components/headers/Date'
        Strict-Transport-Security:
          $ref: '#/components/headers/Strict-Transport-Security'
        Vary:
          $ref: '#/components/headers/Vary'
        X-Content-Type-Options:
          $ref: '#/components/headers/X-Content-Type-Options'
  schemas:
    Adres:
      properties:
        adresType:
          example: Bezoekadres
          maxLength: 250
        huisnummer:
          example: "11"
          maxLength: 50
        land:
          example: Nederland
          maxLength: 250
        openbareRuimte:
          example: Torenstraat
          maxLength: 50
          minLength: 1
        postbus:
          example: "20008"
          maxLength: 50
        postcode:
          example: 3438TT
          maxLength: 50
        provincie:
          example: https://identifier.overheid.nl/tooi/id/provincie/pv26
          pattern: ^https://identifier\.overheid\.nl/tooi/id/[^/]+/[^/]+$
        toelichting:
          example: Lorem ipsum dolor sit amet, consectetur adipi...
          maxLength: 2048
        toevoeging:
          example: Eerste etage
          maxLength: 250
        woonplaats:
          example: Utrecht
          maxLength: 2147483647
          minLength: 1
    Beschrijving:
      description: Beschrijving
      properties:
        beschrijving:
          example: Deze regeling is getroffen met het oog op het belang van de recreatieschappen.
        url:
          example: https://simpel.presurf.web
      required:
      - beschrijving
    Classificatie:
      description: Classificatie
      properties:
        eindDatum:
          format: date
        grondslagen:
          description: Lijst van grondslagen
          items:
            $ref: '#/components/schemas/Grondslag'
        startDatum:
          example: "2006-11-11"
          format: date
        toelichting:
          example: Een website voor toelichting, enz
        type:
          example: WNT-instelling
        url:
          example: https://simpel.presurf.web
      required:
      - grondslagen
      - type
    ClassificatieType:
      description: Classificatie type
      properties:
        grondslagen:
          description: Lijst van grondslagen
          items:
            $ref: '#/components/schemas/Grondslag'
        toelichting:
          example: Collectieve arbeidsovereenkomst voor overheidswerkgevers
        type:
          example: CAO
      required:
      - grondslagen
      - type
    ClassificatieUitgebreid:
      description: Classificatie uitgebreid
      properties:
        classificaties:
          description: Lijst van classificaties
          items:
            $ref: '#/components/schemas/Classificatie'
        label:
          example: Ministerie van Algemene Zaken
        type:
          description: Lijst van mogelijke TOOI definities
          enum:
          - https://identifier.overheid.nl/tooi/def/ont/CaribischOpenbaarLichaam
          - https://identifier.overheid.nl/tooi/def/ont/Gemeente
          - https://identifier.overheid.nl/tooi/def/ont/Ministerie
          - https://identifier.overheid.nl/tooi/def/ont/Overheidsorganisatie
          - https://identifier.overheid.nl/tooi/def/ont/Provincie
          - https://identifier.overheid.nl/tooi/def/ont/Rijk
          - https://identifier.overheid.nl/tooi/def/ont/Samenwerkingsorganisatie
          - https://identifier.overheid.nl/tooi/def/ont/Waterschap
          - https://identifier.overheid.nl/tooi/def/ont/Zbo
          - https://identifier.overheid.nl/tooi/def/ont/ZboCluster
          example: https://identifier.overheid.nl/tooi/def/ont/Ministerie
        uri:
          example: https://identifier.overheid.nl/tooi/id/ministerie/mnre1010
      required:
      - classificaties
    Contact:
      properties:
        contactpaginas:
          items:
            $ref: '#/components/schemas/ContactPagina'
        emailadressen:
          items:
            $ref: '#/components/schemas/Email'
        fax:
          example: (055) 527 26 00
          maxLength: 50
        internetadressen:
          items:
            $ref: '#/components/schemas/Internet'
        socialmedia:
          items:
            $ref: '#/components/schemas/SocialMedia'
        telefoonnummers:
          items:
            $ref: '#/components/schemas/Telefoon'
    ContactPagina:
      properties:
        taalcode:
          example: nl-NL
        url:
          example: https://www.vallei-veluwe.nl/over-ons/contact
          maxLength: 5000
      required:
      - taalcode
    Domein:
      properties:
        archiefUrl:
          example: https://simpel.presurf.web
        domein:
          example: https://www.simpel.web
        eindDatum:
          format: date
        gebruiksdoel:
          example: Website
        omschrijving:
          example: Een website voor informatie, aanvragen enz
        startDatum:
          example: "2006-11-11"
          format: date
      required:
      - domein
      - gebruiksdoel
    Domeinnaamregistratie:
      properties:
        administratiefContactpersoon:
          example: "null"
        doel:
          example: Hosting
        eersteRegistratieDatum:
          format: date
        eindeRegistratie:
          format: date
        houder:
          example: Gemeente Simpel
        naam:
          example: dorpswinkel.web
        registrar:
          example: The Registrar Company B.V. Jan Piet 8 4321VW Ede Nederland
        registratieDatum:
          example: "2013-04-23"
          format: date
        technischContactpersoon:
          example: "null"
      required:
      - houder
      - naam
    Email:
      properties:
        email:
          example: info@vallei-veluwe.nl
          maxLength: 250
        label:
          example: algemeen
          maxLength: 25
      required:
      - email
    ErrorRecord:
      properties:
        Error message:
          example: No organisation found for given identifier(s)
        HTTP status code error:
          example: 404
          format: int32
        Reason phrase error:
          example: Not Found
    Grondslag:
      description: Grondslag
      properties:
        opschrift:
          description: Omschrijving van de grondslag
          example: Waterschappen (Artikel 1.2, lid 1d, WNT)
        referentie:
          description: URL-referentie naar het wetsartikel
          example: http://wetten.overheid.nl/jci1.3:c:BWBR0032249&paragraaf=1&artikel=1.2&lid=1
      required:
      - opschrift
      - referentie
    IdentificatiecodeRecord:
      properties:
        btwNummer:
          example: NL817660665B01
          pattern: ^NL\d{9}B\d{2}$
        ictuCode:
          example: "04010"
        kvkNummer:
          example: "51115395"
          pattern: ^\d{8}$
        label:
          example: Streekarchivariaat de Liemers en Doesburg
        loonheffingenNummer:
          example: 817660665L01
          pattern: ^\d{9}L\d{2}$
        oin:
          example: "00000001001721951000"
          maxLength: 20
        organisatiecode:
          example: so0263
          pattern: ^col[0-9]{2}$|^gm[0-9]{4}$|^mnre[0-9]{4}$|^oorg[0-9]{5}$|^pv[0-9]{2}$|^so[0-9]{4}$|^zb[0-9]{6}$
        owmsId:
          description: Lijst van owms
          items:
            pattern: ^http://standaarden\.overheid\.nl/owms/terms/[^/]+$
        systeemId:
          example: "28772572"
        uri:
          example: https://identifier.overheid.nl/tooi/id/so/so1082
          pattern: ^https://identifier\.overheid\.nl/tooi/id/(col/col[0-9]{2}|gemeente/gm[0-9]{4}|ministerie/mnre[0-9]{4}|oorg/oorg[0-9]{5}|provincie/pv[0-9]{2}|so/so[0-9]{4}|waterschap/ws[0-9]{4}|zbo/zb[0-9]{6})$
      required:
      - label
      - systeemId
    Internet:
      properties:
        label:
          example: algemeen
          maxLength: 25
        url:
          example: https://www.vallei-veluwe.nl
          maxLength: 5000
      required:
      - url
    Overheidsorganisatie:
      discriminator:
        mapping:
          Caribisch openbaar lichaam: '#/components/schemas/col'
          Gemeente: '#/components/schemas/gemeente'
          Ministerie: '#/components/schemas/ministerie'
          Overige overheidsorganisatie: '#/components/schemas/oorg'
          Provincie: '#/components/schemas/provincie'
          Samenwerkingsorganisatie: '#/components/schemas/so'
          Waterschap: '#/components/schemas/waterschap'
          Zbo: '#/components/schemas/zbo'
          Zbo-cluster: '#/components/schemas/zbo-cluster'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/col'
      - $ref: '#/components/schemas/gemeente'
      - $ref: '#/components/schemas/ministerie'
      - $ref: '#/components/schemas/oorg'
      - $ref: '#/components/schemas/provincie'
      - $ref: '#/components/schemas/so'
      - $ref: '#/components/schemas/waterschap'
      - $ref: '#/components/schemas/zbo'
      - $ref: '#/components/schemas/zbo-cluster'
    SocialMedia:
      properties:
        gebruikersnaam:
          example: valleienveluwe
          maxLength: 255
        platform:
          example: Facebook
          maxLength: 255
        url:
          example: https://nl-nl.facebook.com/valleienveluwe
          maxLength: 5000
      required:
      - gebruikersnaam
      - platform
      - url
    SuggestIdentificatiecodeRecord:
      properties:
        btwNummer:
          example: NL817660665B01
          pattern: ^NL\d{9}B\d{2}$
        ictuCode:
          example: "04010"
        kvkNummer:
          example: "51115395"
          pattern: ^\d{8}$
        label:
          example: Streekarchivariaat de Liemers en Doesburg
        loonheffingenNummer:
          example: 817660665L01
          pattern: ^\d{9}L\d{2}$
        matchMet:
          example: systeemId
        oin:
          example: "00000001001721951000"
          maxLength: 20
        organisatiecode:
          example: so0263
          pattern: ^col[0-9]{2}$|^gm[0-9]{4}$|^mnre[0-9]{4}$|^oorg[0-9]{5}$|^pv[0-9]{2}$|^so[0-9]{4}$|^zb[0-9]{6}$
        owmsId:
          description: Lijst van owms
          items:
            pattern: ^http://standaarden\.overheid\.nl/owms/terms/[^/]+$
        systeemId:
          example: "28772572"
        uri:
          example: https://identifier.overheid.nl/tooi/id/so/so1082
          pattern: ^https://identifier\.overheid\.nl/tooi/id/(col/col[0-9]{2}|gemeente/gm[0-9]{4}|ministerie/mnre[0-9]{4}|oorg/oorg[0-9]{5}|provincie/pv[0-9]{2}|so/so[0-9]{4}|waterschap/ws[0-9]{4}|zbo/zb[0-9]{6})$
      required:
      - label
      - matchMet
      - systeemId
    Telefoon:
      properties:
        label:
          example: algemeen
          maxLength: 25
        nummer:
          example: (055) 527 26 00
          maxLength: 50
      required:
      - nummer
    Wijzigingsgebeurtenis:
      discriminator:
        mapping:
          Afsplitsing: '#/components/schemas/afsplitsing'
          Herschikking: '#/components/schemas/herschikking'
          Opheffing: '#/components/schemas/opheffing'
          Oprichting: '#/components/schemas/oprichting'
          Opsplitsing: '#/components/schemas/opsplitsing'
          Samenvoeging: '#/components/schemas/samenvoeging'
          Toestandswijziging: '#/components/schemas/toestandswijziging'
          Uitbreiding: '#/components/schemas/uitbreiding'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/afsplitsing'
      - $ref: '#/components/schemas/herschikking'
      - $ref: '#/components/schemas/opheffing'
      - $ref: '#/components/schemas/oprichting'
      - $ref: '#/components/schemas/opsplitsing'
      - $ref: '#/components/schemas/samenvoeging'
      - $ref: '#/components/schemas/toestandswijziging'
      - $ref: '#/components/schemas/uitbreiding'
    WijzigingsgebeurtenisPost:
      discriminator:
        mapping:
          Afsplitsing: '#/components/schemas/afsplitsing-post'
          Herschikking: '#/components/schemas/herschikking-post'
          Opheffing: '#/components/schemas/opheffing'
          Oprichting: '#/components/schemas/oprichting-post'
          Opsplitsing: '#/components/schemas/opsplitsing-post'
          Samenvoeging: '#/components/schemas/samenvoeging-post'
          Toestandswijziging: '#/components/schemas/toestandswijzigingPost'
          Uitbreiding: '#/components/schemas/uitbreiding'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/afsplitsing-post'
      - $ref: '#/components/schemas/herschikking-post'
      - $ref: '#/components/schemas/opheffing'
      - $ref: '#/components/schemas/oprichting-post'
      - $ref: '#/components/schemas/opsplitsing-post'
      - $ref: '#/components/schemas/samenvoeging-post'
      - $ref: '#/components/schemas/toestandswijzigingPost'
      - $ref: '#/components/schemas/uitbreiding'
    Woo:
      description: WOO informatie
      properties:
        label:
          example: Staatstoezicht op de Mijnen
        uri:
          example: https://identifier.overheid.nl/tooi/id/so/so1082
          pattern: ^https://identifier\.overheid\.nl/tooi/id/(col/col[0-9]{2}|gemeente/gm[0-9]{4}|ministerie/mnre[0-9]{4}|oorg/oorg[0-9]{5}|provincie/pv[0-9]{2}|so/so[0-9]{4}|waterschap/ws[0-9]{4}|zbo/zb[0-9]{6})$
        wooContactpersonen:
          description: Lijst van WOO contact personen
          items:
            $ref: '#/components/schemas/WooContactpersoon'
        wooIndex:
          description: Lijst van WOO indexen
          items:
            $ref: '#/components/schemas/WooIndex'
        wooInformatie:
          $ref: '#/components/schemas/WooInformatie'
        wooVerzoek:
          $ref: '#/components/schemas/WooVerzoek'
    WooContactpersoon:
      description: WOO contact persoon
      properties:
        adressen:
          description: List van adressen voor WOO informatie
          items:
            $ref: '#/components/schemas/Adres'
        contact:
          $ref: '#/components/schemas/Contact'
        naam:
          example: dhr. W. Verzoek
    WooIndex:
      description: WOO index
      properties:
        informatiecategorie:
          example: Jaarplannen en jaarverslagen
        toelichting:
          example: Jaarplannen
        url:
          example: https://www.sodm.nl/documenten?trefwoord=&startdatum=&einddatum=&onderwerp=Alle+onderwerpen&onderdeel=Alle+onderdelen&type=Jaarplan
    WooInformatie:
      description: WOO informatie urls
      properties:
        overzichtUrl:
          example: https://organisaties.overheid.nl/woo/28963273/Staatstoezicht_op_de_Mijnen
        url:
          example: https://www.sodm.nl/contact
    WooVerzoek:
      description: WOO verzoek informatie
      properties:
        email:
          example: true
        url:
          example: https://www.sodm.nl/contact
    afsplitsing:
      allOf:
      - properties:
          generated:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 1
            uniqueItems: true
          type:
            format: uri
          used:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 1
            uniqueItems: true
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - generated
      - type
      - used
      title: Afsplitsing
    afsplitsing-post:
      allOf:
      - properties:
          generated:
            items:
              $ref: '#/components/schemas/generated'
            minItems: 1
            uniqueItems: true
          type:
            format: uri
          used:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 1
            uniqueItems: true
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - generated
      - type
      - used
      title: Afsplitsing
    col:
      allOf:
      - $ref: '#/components/schemas/commonProperties'
      - $ref: '#/components/schemas/read-only'
      description: Een Caribisch openbaar lichaam is een territoriaal openbaar lichaam
        in het Caribische deel van Nederland
      properties:
        colcode:
          pattern: ^[0-9]{2}$
        organisatiecode:
          pattern: ^col[0-9]{2}$
        organisatiesoort:
          items:
            format: uri
          maxItems: 1
          minItems: 1
        type:
          format: uri
        uri:
          format: uri
          pattern: ^https://identifier\.overheid\.nl/tooi/id/col/(col[0-9]{2}|hv_[0-9]{8})$
      required:
      - colcode
      - organisatiecode
      - organisatiesoort
      - type
      - uri
      title: Caribisch openbaar lichaam
    commonProperties:
      properties:
        afkorting:
          minLength: 1
        alternatieveNaam:
          items:
            minLength: 1
          minItems: 1
          uniqueItems: true
        isPartOf:
          items:
            $ref: '#/components/schemas/organisatieUri'
          minItems: 1
          uniqueItems: true
        label:
          minLength: 1
        officieleNaamExclSoort:
          minLength: 1
        officieleNaamInclSoort:
          minLength: 1
        officieleNaamSorteer:
          minLength: 1
        owmsId:
          items:
            format: uri
            pattern: ^http://standaarden\.overheid\.nl/owms/terms/[a-zA-Z0-9_()\-]{1,200}$
          minItems: 1
        voorkeursnaamExclSoort:
          minLength: 1
        voorkeursnaamInclSoort:
          minLength: 1
        voorkeursnaamSorteer:
          minLength: 1
        wettelijkeClassificatie:
          items:
            anyOf:
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_055aa18b`'
              title: Woo-plichtig
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_df0cc565`'
              title: overheidswerkgever
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_21bfb04e`'
              title: WNT-instelling
            format: uri
          minItems: 1
          uniqueItems: true
      required:
      - label
      title: commonProperties
    gemeente:
      allOf:
      - $ref: '#/components/schemas/commonProperties'
      - $ref: '#/components/schemas/read-only'
      properties:
        gemeentecode:
          pattern: ^[0-9]{4}$
        ligtInProvincie:
          anyOf:
          - description: '`https://identifier.overheid.nl/tooi/id/provincie/pv22`'
            title: provincie Drenthe
          - description: '`https://identifier.overheid.nl/tooi/id/provincie/pv24`'
            title: provincie Flevoland
          - description: '`https://identifier.overheid.nl/tooi/id/provincie/pv21`'
            title: provincie Fryslân
          - description: '`https://identifier.overheid.nl/tooi/id/provincie/pv25`'
            title: provincie Gelderland
          - description: '`https://identifier.overheid.nl/tooi/id/provincie/pv20`'
            title: provincie Groningen
          - description: '`https://identifier.overheid.nl/tooi/id/provincie/pv31`'
            title: provincie Limburg
          - description: '`https://identifier.overheid.nl/tooi/id/provincie/pv30`'
            title: provincie Noord-Brabant
          - description: '`https://identifier.overheid.nl/tooi/id/provincie/pv27`'
            title: provincie Noord-Holland
          - description: '`https://identifier.overheid.nl/tooi/id/provincie/pv23`'
            title: provincie Overijssel
          - description: '`https://identifier.overheid.nl/tooi/id/provincie/pv26`'
            title: provincie Utrecht
          - description: '`https://identifier.overheid.nl/tooi/id/provincie/pv29`'
            title: provincie Zeeland
          - description: '`https://identifier.overheid.nl/tooi/id/provincie/pv28`'
            title: provincie Zuid-Holland
          format: uri
        organisatiecode:
          pattern: ^gm[0-9]{4}$
        organisatiesoort:
          items:
            format: uri
          maxItems: 1
          minItems: 1
        type:
          format: uri
        uri:
          format: uri
          pattern: ^https://identifier\.overheid\.nl/tooi/id/gemeente/(gm[0-9]{4}|hv_[0-9]{8})$
      required:
      - gemeentecode
      - ligtInProvincie
      - organisatiecode
      - organisatiesoort
      - type
      - uri
      title: Gemeente
    generated:
      oneOf:
      - $ref: '#/components/schemas/col'
      - $ref: '#/components/schemas/gemeente'
      - $ref: '#/components/schemas/ministerie'
      - $ref: '#/components/schemas/provincie'
      - $ref: '#/components/schemas/so'
      - $ref: '#/components/schemas/waterschap'
      - $ref: '#/components/schemas/zbo'
      - $ref: '#/components/schemas/oorg'
      title: generated
    herschikking:
      allOf:
      - properties:
          generated:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 1
            uniqueItems: true
          invalidated:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 1
            uniqueItems: true
          type:
            format: uri
          used:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 1
            uniqueItems: true
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - generated
      - invalidated
      - type
      title: Herschikking
    herschikking-post:
      allOf:
      - properties:
          generated:
            items:
              $ref: '#/components/schemas/generated'
            minItems: 1
            uniqueItems: true
          invalidated:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 1
            uniqueItems: true
          type:
            format: uri
          used:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 1
            uniqueItems: true
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - generated
      - invalidated
      - type
      title: Herschikking
    historische-versie:
      oneOf:
      - $ref: '#/components/schemas/col'
      - $ref: '#/components/schemas/gemeente'
      - $ref: '#/components/schemas/ministerie'
      - $ref: '#/components/schemas/oorg'
      - $ref: '#/components/schemas/provincie'
      - $ref: '#/components/schemas/so'
      - $ref: '#/components/schemas/waterschap'
      - $ref: '#/components/schemas/zbo'
      - $ref: '#/components/schemas/zbo-cluster'
      properties:
        einddatumHV:
          format: date
          minLength: 1
        specializationOf:
          $ref: '#/components/schemas/organisatieUri'
      title: Historische versie
    historischeVersies:
      items:
        $ref: '#/components/schemas/historische-versie'
      title: Historische versies
    hvUri:
      format: uri
      pattern: ^https://identifier\.overheid\.nl/tooi/id/(col|gemeente|ministerie|oorg|provincie|so|waterschap|zbo)/hv_[0-9]{8}$
    kaderwetVanToepassing:
      properties:
        kaderwetVanToepassing:
          oneOf:
          - description: '`ja`'
            title: ja
          - description: '`nee`'
            title: nee
          - description: '`onbekend`'
            title: onbekend
          - description: '`in voorbereiding`'
            title: in voorbereiding
      title: kaderwetVanToepassing
    message:
      properties:
        details: {}
        message:
          minLength: 1
      required:
      - message
      title: message
    ministerie:
      allOf:
      - $ref: '#/components/schemas/commonProperties'
      - $ref: '#/components/schemas/read-only'
      properties:
        ministeriecode:
          pattern: ^[0-9]{4}$
        organisatiecode:
          pattern: ^mnre[0-9]{4}$
        organisatiesoort:
          items:
            format: uri
          maxItems: 1
          minItems: 1
        type:
          format: uri
        uri:
          format: uri
          pattern: ^https://identifier\.overheid\.nl/tooi/id/ministerie/(mnre[0-9]{4}|hv_[0-9]{8})$
      required:
      - ministeriecode
      - organisatiecode
      - organisatiesoort
      - type
      - uri
      title: Ministerie
    oorg:
      allOf:
      - $ref: '#/components/schemas/commonProperties'
      - $ref: '#/components/schemas/read-only'
      properties:
        organisatiecode:
          pattern: ^oorg[0-9]{5}$
        organisatiesoort:
          items:
            anyOf:
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_ab4cf250`'
              format: uri
              title: openbaar lichaam voor beroep en bedrijf
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_1d008550`'
              format: uri
              title: kabinet van de koning
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_29b489f7`'
              format: uri
              title: Hoog College van Staat
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_81c05ccd`'
              format: uri
              title: agentschap
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_cb42e80a`'
              format: uri
              title: inspectiedienst
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_690094b5`'
              format: uri
              title: eenmalig adviescollege
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_4dec446b`'
              format: uri
              title: tijdelijk adviescollege
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_2c4326b9`'
              format: uri
              title: vast adviescollege
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_b9b318a5`'
              format: uri
              title: landelijk politiekorps
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_43418c0b`'
              format: uri
              title: rechtspraak
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_bbb05295`'
              format: uri
              title: gerechtshof
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_c6d95aea`'
              format: uri
              title: rechtbank
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_ebc71fd1`'
              format: uri
              title: koepelorganisatie
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_07d0ec18`'
              format: uri
              title: organisatieonderdeel
          maxItems: 1
          minItems: 1
        type:
          format: uri
        uri:
          format: uri
          pattern: ^https://identifier\.overheid\.nl/tooi/id/oorg/(oorg[0-9]{5}|hv_[0-9]{8})$
      required:
      - organisatiecode
      - organisatiesoort
      - type
      - uri
      title: Overige overheidsorganisatie
    opheffing:
      allOf:
      - properties:
          invalidated:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 1
            uniqueItems: true
          type:
            format: uri
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - invalidated
      - type
      title: Opheffing
    oprichting:
      allOf:
      - properties:
          generated:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 1
            uniqueItems: true
          type:
            format: uri
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - generated
      - type
      title: Oprichting
    oprichting-post:
      allOf:
      - properties:
          generated:
            items:
              $ref: '#/components/schemas/generated'
            minItems: 1
            uniqueItems: true
          type:
            format: uri
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - generated
      - type
      title: Oprichting
    opsplitsing:
      allOf:
      - properties:
          generated:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 2
            uniqueItems: true
          invalidated:
            items:
              $ref: '#/components/schemas/organisatieUri'
            maxItems: 1
            minItems: 1
            uniqueItems: true
          type:
            format: uri
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - generated
      - invalidated
      - type
      title: Opsplitsing
    opsplitsing-post:
      allOf:
      - properties:
          generated:
            items:
              $ref: '#/components/schemas/generated'
            minItems: 2
            uniqueItems: true
          invalidated:
            items:
              $ref: '#/components/schemas/organisatieUri'
            maxItems: 1
            minItems: 1
            uniqueItems: true
          type:
            format: uri
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - generated
      - invalidated
      - type
      title: Opsplitsing
    organisatieType:
      format: uri
      oneOf:
      - description: '`https://identifier.overheid.nl/tooi/def/ont/CaribischOpenbaarLichaam`'
        title: Caribisch openbaar lichaam
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Gemeente`'
        title: Gemeente
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Ministerie`'
        title: Ministerie
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Overheidsorganisatie`'
        title: Overige overheidsorganisatie
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Provincie`'
        title: Provincie
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Rijk`'
        title: Rijk
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Samenwerkingsorganisatie`'
        title: Samenwerkingsorganisatie
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Waterschap`'
        title: Waterschap
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Zbo`'
        title: Zbo
      - description: '`https://identifier.overheid.nl/tooi/def/ont/ZboCluster`'
        title: Zbo-cluster
    organisatieUri:
      format: uri
      pattern: ^https://identifier\.overheid\.nl/tooi/id/(col/col[0-9]{2}|gemeente/gm[0-9]{4}|ministerie/mnre[0-9]{4}|oorg/oorg[0-9]{5}|provincie/pv[0-9]{2}|so/so[0-9]{4}|waterschap/ws[0-9]{4}|zbo/zb[0-9]{6})$
    overheidsorganisaties:
      items:
        properties:
          label:
            minLength: 1
          type:
            format: uri
            pattern: ^https://identifier\.overheid\.nl/tooi/def/ont/*
          uri:
            $ref: '#/components/schemas/organisatieUri'
      required:
      - type
      - uri
      title: Overheidsorganisaties
    provincie:
      allOf:
      - $ref: '#/components/schemas/commonProperties'
      - $ref: '#/components/schemas/read-only'
      properties:
        organisatiecode:
          pattern: ^pv[0-9]{2}$
        organisatiesoort:
          items:
            format: uri
          maxItems: 1
          minItems: 1
        provinciecode:
          pattern: ^[0-9]{2}$
        type:
          format: uri
        uri:
          format: uri
          pattern: ^https://identifier.overheid.nl/tooi/id/provincie/(pv[0-9]{2}|hv_[0-9]{8})$
      required:
      - organisatiecode
      - organisatiesoort
      - provinciecode
      - type
      - uri
      title: Provincie
    read-only:
      properties:
        begindatum:
          format: date
          readOnly: true
        einddatum:
          format: date
          readOnly: true
        generatedAtTime:
          format: date-time
          readOnly: true
        invalidatedAtTime:
          format: date-time
          readOnly: true
      title: read-only
    samenvoeging:
      allOf:
      - properties:
          generated:
            items:
              $ref: '#/components/schemas/organisatieUri'
            maxItems: 1
            minItems: 1
            uniqueItems: true
          invalidated:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 2
            uniqueItems: true
          type:
            format: uri
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - generated
      - invalidated
      - type
      title: Samenvoeging
    samenvoeging-post:
      allOf:
      - properties:
          generated:
            items:
              $ref: '#/components/schemas/generated'
            maxItems: 1
            minItems: 1
            uniqueItems: true
          invalidated:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 2
            uniqueItems: true
          type:
            format: uri
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - generated
      - invalidated
      - type
      title: Samenvoeging
    so:
      allOf:
      - $ref: '#/components/schemas/commonProperties'
      - $ref: '#/components/schemas/read-only'
      properties:
        organisatiecode:
          pattern: ^so[0-9]{4}$
        organisatiesoort:
          items:
            anyOf:
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_a04c8796`'
              format: uri
              title: regionaal samenwerkingsorgaan
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_c7eb524c`'
              format: uri
              title: grensoverschrijdende regionale samenwerkingsorganisatie
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_ebc71fd1`'
              format: uri
              title: koepelorganisatie
          maxItems: 1
          minItems: 1
        socode:
          pattern: ^[0-9]{4}$
        type:
          format: uri
        uri:
          format: uri
          pattern: ^https://identifier\.overheid\.nl/tooi/id/so/(so[0-9]{4}|hv_[0-9]{8})$
      required:
      - organisatiecode
      - organisatiesoort
      - socode
      - type
      - uri
      title: Samenwerkingsorganisatie
    toestandswijziging:
      allOf:
      - properties:
          invalidated:
            items:
              $ref: '#/components/schemas/hvUri'
            maxItems: 1
            minItems: 1
          type:
            format: uri
          used:
            items:
              $ref: '#/components/schemas/organisatieUri'
            maxItems: 1
            minItems: 1
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - invalidated
      - type
      - used
      title: Toestandswijziging
    toestandswijzigingPost:
      allOf:
      - properties:
          properties:
            $ref: '#/components/schemas/toestandswijzigingProperties'
          type:
            format: uri
          used:
            items:
              $ref: '#/components/schemas/organisatieUri'
            maxItems: 1
            minItems: 1
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - properties
      - type
      - used
      title: Toestandswijziging
    toestandswijzigingProperties:
      allOf:
      - $ref: '#/components/schemas/commonProperties'
      - $ref: '#/components/schemas/kaderwetVanToepassing'
      - $ref: '#/components/schemas/verantwoordelijkMinisterie'
      title: toestandswijzigingProperties
    uitbreiding:
      allOf:
      - properties:
          invalidated:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 1
            uniqueItems: true
          type:
            format: uri
          used:
            items:
              $ref: '#/components/schemas/organisatieUri'
            minItems: 1
            uniqueItems: true
      - $ref: '#/components/schemas/wijzigingsgebeurtenis'
      required:
      - invalidated
      - type
      - used
      title: Uitbreiding
    verantwoordelijkMinisterie:
      properties:
        verantwoordelijkMinisterie:
          format: uri
          pattern: ^https://identifier\.overheid\.nl/tooi/id/ministerie/mnre[0-9]{4}$
      title: verantwoordelijkMinisterie
    waterschap:
      allOf:
      - $ref: '#/components/schemas/commonProperties'
      - $ref: '#/components/schemas/read-only'
      properties:
        organisatiecode:
          pattern: ^ws[0-9]{4}$
        organisatiesoort:
          items:
            format: uri
          maxItems: 1
          minItems: 1
        type:
          format: uri
        uri:
          format: uri
          pattern: ^https://identifier\.overheid\.nl/tooi/id/waterschap/(ws[0-9]{4}|hv_[0-9]{8})$
        waterschapscode:
          pattern: ^[0-9]{4}$
      required:
      - organisatiecode
      - organisatiesoort
      - type
      - uri
      - waterschapscode
      title: Waterschap
    wijzigingsgebeurtenis:
      properties:
        heeftGrondslagString:
          description: De waarde van deze property is een tekstuele verwijzing naar
            de juridische grondslag in de vorm van een string. Het gebruik van deze
            property dient beperkt te blijven tot gevallen waarin het gebruik van
            heeftJuridischeGrondslag niet mogelijk is.
          items:
            minLength: 1
          minItems: 1
          uniqueItems: true
        heeftJuridischeGrondslag:
          description: Wet, regeling of besluit waaraan de wijziging zijn rechtsgeldigheid
            ontleent
          items:
            format: uri
            minLength: 1
          minItems: 1
          uniqueItems: true
        redenWijziging:
          description: De reden voor de wijziging
          items:
            minLength: 1
          minItems: 1
          uniqueItems: true
        tijdstipRegistratie:
          description: Datum en tijdstip waarop de wijziging is geregistreerd in het
            betreffende register
          format: date-time
          minLength: 1
          readOnly: true
        tijdstipWijziging:
          description: 'Datum en tijdstip waarop de wijziging formeel is ingegaan.
            De waarde van dit veld bepaalt automatisch de waarde van de volgende velden:
            `begindatum`, `einddatum`, `generatedAtTime` en `invalidatedAtTime`. Als
            het tijdstip van `tijdstipWijziging` gelijk is aan `T00:00:00`, dan wordt
            er een dag afgetrokken van `einddatum` ten opzichte van `tijdstipWijziging`.'
          format: date-time
          minLength: 1
      title: Wijzigingsgebeurtenis
    wijzigingsgebeurtenissen:
      items:
        properties:
          type:
            format: uri
            pattern: ^https://identifier\.overheid\.nl/tooi/def/ont/*
          uri:
            $ref: '#/components/schemas/wzgUri'
      required:
      - type
      - uri
      title: Wijzigingsgebeurtenissen
    wzgType:
      format: uri
      oneOf:
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Afsplitsing`'
        title: Afsplitsing
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Herschikking`'
        title: Herschikking
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Opheffing`'
        title: Opheffing
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Oprichting`'
        title: Oprichting
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Opsplitsing`'
        title: Opsplitsing
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Samenvoeging`'
        title: Samenvoeging
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Toestandswijziging`'
        title: Toestandswijziging
      - description: '`https://identifier.overheid.nl/tooi/def/ont/Uitbreiding`'
        title: Uitbreiding
    wzgUri:
      format: uri
      pattern: ^https://identifier\.overheid\.nl/tooi/id/(col|gemeente|ministerie|oorg|provincie|so|waterschap|zbo)/wzg_[0-9]{4,8}$
    zbo:
      allOf:
      - $ref: '#/components/schemas/commonProperties'
      - $ref: '#/components/schemas/read-only'
      description: Een zelfstandig bestuursorgaan (zbo) is een bestuursorgaan van
        de centrale overheid dat niet direct onder het gezag van een minister valt.
        Het veld `organisatiesoort` bevat tenminste de soort 'zelfstandig bestuursorgaan'
        (`https://identifier.overheid.nl/tooi/def/thes/kern/c_56192790`) en optioneel
        een of meer van de andere toegestane soorten.
      properties:
        hoortBijZboCluster:
          format: uri
          pattern: ^https://identifier\.overheid\.nl/tooi/id/zbo/zb[0-9]{6}$
        kaderwetVanToepassing:
          anyOf:
          - description: '`ja`'
            title: ja
          - description: '`nee`'
            title: nee
          - description: '`onbekend`'
            title: onbekend
          - description: '`in voorbereiding`'
            title: in voorbereiding
        organisatiecode:
          pattern: ^zb[0-9]{6}$
        organisatiesoort:
          items:
            anyOf:
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_56192790`'
              title: zelfstandig bestuursorgaan
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_81c05ccd`'
              title: agentschap
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_cb42e80a`'
              title: inspectiedienst
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_690094b5`'
              title: eenmalig adviescollege
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_4dec446b`'
              title: tijdelijk adviescollege
            - description: '`https://identifier.overheid.nl/tooi/def/thes/kern/c_2c4326b9`'
              title: vast adviescollege
            format: uri
          minItems: 1
          uniqueItems: true
        type:
          format: uri
        uri:
          format: uri
          pattern: ^https://identifier\.overheid\.nl/tooi/id/zbo/(zb[0-9]{6}|hv_[0-9]{8})$
        verantwoordelijkMinisterie:
          format: uri
          pattern: ^https://identifier\.overheid\.nl/tooi/id/ministerie/mnre[0-9]{4}$
        zbocode:
          pattern: ^[0-9]{6}$
      required:
      - organisatiecode
      - organisatiesoort
      - type
      - uri
      - verantwoordelijkMinisterie
      - zbocode
      title: Zbo
    zbo-cluster:
      allOf:
      - $ref: '#/components/schemas/commonProperties'
      - $ref: '#/components/schemas/read-only'
      description: Een zelfstandig bestuursorgaan (zbo) is een bestuursorgaan van
        de centrale overheid dat niet direct onder het gezag van een minister valt
      properties:
        kaderwetVanToepassing:
          anyOf:
          - description: '`ja`'
            title: ja
          - description: '`nee`'
            title: nee
          - description: '`onbekend`'
            title: onbekend
          - description: '`in voorbereiding`'
            title: in voorbereiding
        organisatiecode:
          pattern: ^zb[0-9]{6}$
        organisatiesoort:
          items:
            format: uri
          maxItems: 1
          minItems: 1
        type:
          format: uri
        uri:
          format: uri
          pattern: ^https://identifier\.overheid\.nl/tooi/id/zbo/(zb[0-9]{6}|hv_[0-9]{8})$
        verantwoordelijkMinisterie:
          format: uri
          pattern: ^https://identifier\.overheid\.nl/tooi/id/ministerie/mnre[0-9]{4}$
        zbocode:
          pattern: ^[0-9]{6}$
      required:
      - organisatiecode
      - organisatiesoort
      - type
      - uri
      - verantwoordelijkMinisterie
      - zbocode
      title: Zbo-cluster
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: X-API-KEY
      type: apiKey
info:
  title: API Overheidorganisaties
  version: 1.0.20
openapi: 3.0.3
paths:
  /v1/overheidsorganisaties:
    get:
      description: Vraag van alle overheidsorganisaties het label, het type en de
        URI op. Filteren op type is mogelijk.
      operationId: overheidsorganisaties
      parameters:
      - allowReserved: true
        examples:
          Caribisch openbaar lichaam:
            value: https://identifier.overheid.nl/tooi/def/ont/CaribischOpenbaarLichaam
          Gemeente:
            value: https://identifier.overheid.nl/tooi/def/ont/Gemeente
          Ministerie:
            value: https://identifier.overheid.nl/tooi/def/ont/Ministerie
          Overige overheidsorganisatie:
            value: https://identifier.overheid.nl/tooi/def/ont/Overheidsorganisatie
          Provincie:
            value: https://identifier.overheid.nl/tooi/def/ont/Provincie
          Rijk:
            value: https://identifier.overheid.nl/tooi/def/ont/Rijk
          Samenwerkingsorganisatie:
            value: https://identifier.overheid.nl/tooi/def/ont/Samenwerkingsorganisatie
          Waterschap:
            value: https://identifier.overheid.nl/tooi/def/ont/Waterschap
          Zbo:
            value: https://identifier.overheid.nl/tooi/def/ont/Zbo
          Zbo-cluster:
            value: https://identifier.overheid.nl/tooi/def/ont/ZboCluster
        explode: true
        in: query
        name: type
        required: false
        schema:
          $ref: '#/components/schemas/organisatieType'
        style: form
      responses:
        5XX:
          $ref: '#/components/responses/5XX'
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/overheidsorganisaties'
          description: Een lijst van overheidsorganisaties.
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
            Content-Security-Policy:
              $ref: '#/components/headers/Content-Security-Policy'
            Content-Type:
              $ref: '#/components/headers/Content-Type'
            Date:
              $ref: '#/components/headers/Date'
            Etag:
              $ref: '#/components/headers/Etag'
            Strict-Transport-Security:
              $ref: '#/components/headers/Strict-Transport-Security'
            Vary:
              $ref: '#/components/headers/Vary'
            X-Content-Type-Options:
              $ref: '#/components/headers/X-Content-Type-Options'
        "400":
          $ref: '#/components/responses/400'
      summary: Overheidsorganisaties
      tags:
      - Overheidsorganisaties
  /v1/overheidsorganisaties/{organisatieUri}:
    get:
      description: Vraag een specifieke overheidsorganisatie op aan de hand van de
        bijbehorende URI.
      operationId: overheidsorganisatie
      parameters:
      - examples:
          Gemeente:
            value: https://identifier.overheid.nl/tooi/id/gemeente/gm0785
          Ministerie:
            value: https://identifier.overheid.nl/tooi/id/ministerie/mnre1058
          Overige overheidsorganisatie:
            value: https://identifier.overheid.nl/tooi/id/oorg/oorg10117
        explode: false
        in: path
        name: organisatieUri
        required: true
        schema:
          $ref: '#/components/schemas/organisatieUri'
        style: simple
      responses:
        5XX:
          $ref: '#/components/responses/5XX'
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Overheidsorganisatie'
          description: Een overheidsorganisatie.
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
            Content-Security-Policy:
              $ref: '#/components/headers/Content-Security-Policy'
            Content-Type:
              $ref: '#/components/headers/Content-Type'
            Date:
              $ref: '#/components/headers/Date'
            Etag:
              $ref: '#/components/headers/Etag'
            Strict-Transport-Security:
              $ref: '#/components/headers/Strict-Transport-Security'
            Vary:
              $ref: '#/components/headers/Vary'
            X-Content-Type-Options:
              $ref: '#/components/headers/X-Content-Type-Options'
        "404":
          $ref: '#/components/responses/404'
      summary: Overheidsorganisatie via URI
      tags:
      - Overheidsorganisaties
  /v1/overheidsorganisaties/{organisatieUri}/adressen:
    get:
      description: Vraag alle adressen van een specifieke overheidsorganisatie op
        aan de hand van de bijbehorende URI.
      operationId: getAdressen
      parameters:
      - description: Organisatie URI
        explode: false
        in: path
        name: organisatieUri
        required: true
        schema:
          pattern: ^https://identifier\.overheid\.nl/tooi/id/[^/]+/[^/]+$
        style: simple
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/Adres'
          description: Een lijst van adressen.
          headers:
            API-Version:
              description: header met de API versie
              examples:
                API-Version:
                  description: API-Version
                  value: 1.0.1
              schema: {}
              style: simple
        "400":
          content:
            application/json:
              examples:
                400 Error response:
                  description: 400 Error response
                  value:
                    error: Bad Request
                    message: Invalid identifier provided
                    status: 400
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Ongeldige opdracht.
        "404":
          content:
            application/json:
              examples:
                404 Error response:
                  description: 404 Error response
                  value:
                    error: Not Found
                    message: No organisation found for given identifier
                    status: 404
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Niet gevonden.
        "500":
          content:
            application/json:
              examples:
                500 Error response:
                  description: 500 Error response
                  value:
                    error: Internal Server Error
                    message: Internal error occurred
                    status: 500
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Technisch probleem.
      summary: Adressen via URI
      tags:
      - Adressen
  /v1/overheidsorganisaties/{organisatieUri}/beschrijving:
    get:
      description: Vraag op basis van de TOOI-URI de beschrijving van een organisatie
        op en/of een link naar meer informatie over de organisatie.
      operationId: getBeschrijvingTOOI
      parameters:
      - description: Organisatie URI
        explode: false
        in: path
        name: organisatieUri
        required: true
        schema:
          pattern: ^https://identifier\.overheid\.nl/tooi/id/[^/]+/[^/]+$
        style: simple
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Beschrijving'
          description: Beschrijving.
          headers:
            API-Version:
              description: header met de API versie
              examples:
                API-Version:
                  description: API-Version
                  value: 1.0.1
              schema: {}
              style: simple
        "400":
          content:
            application/json:
              examples:
                400 Error response:
                  description: 400 Error response
                  value:
                    error: Bad Request
                    message: Invalid identifier provided
                    status: 400
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Ongeldige opdracht.
        "404":
          content:
            application/json:
              examples:
                404 Error response:
                  description: 404 Error response
                  value:
                    error: Not Found
                    message: No organisation found for given identifier
                    status: 404
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Niet gevonden.
        "500":
          content:
            application/json:
              examples:
                500 Error response:
                  description: 500 Error response
                  value:
                    error: Internal Server Error
                    message: Internal error occurred
                    status: 500
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Technisch probleem.
      summary: Beschrijving via URI
      tags:
      - Beschrijving
  /v1/overheidsorganisaties/{organisatieUri}/classificaties:
    get:
      description: Vraag alle classificaties van een specifieke overheidsorganisatie
        op aan de hand van de bijbehorende URI.
      operationId: getClassificaties
      parameters:
      - description: Organisatie URI
        explode: false
        in: path
        name: organisatieUri
        required: true
        schema:
          example: https://identifier.overheid.nl/tooi/id/ministerie/mnre1010
          pattern: ^https://identifier\.overheid\.nl/tooi/id/[^/]+/[^/]+$
        style: simple
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/Classificatie'
          description: Een lijst van classificaties.
          headers:
            API-Version:
              description: header met de API versie
              examples:
                API-Version:
                  description: API-Version
                  value: 1.0.1
              schema: {}
              style: simple
        "400":
          content:
            application/json:
              examples:
                400 Error response:
                  description: 400 Error response
                  value:
                    error: Bad Request
                    message: Invalid identifier provided
                    status: 400
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Ongeldige opdracht.
        "404":
          content:
            application/json:
              examples:
                404 Error response:
                  description: 404 Error response
                  value:
                    error: Not Found
                    message: No organisation found for given identifier
                    status: 404
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Niet gevonden.
        "500":
          content:
            application/json:
              examples:
                500 Error response:
                  description: 500 Error response
                  value:
                    error: Internal Server Error
                    message: Internal error occurred
                    status: 500
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Technisch probleem.
      summary: Classificaties via URI
      tags:
      - Classificatie
  /v1/overheidsorganisaties/{organisatieUri}/contact:
    get:
      description: Vraag de contactgegevens van een specifieke overheidsorganisatie
        op aan de hand van de bijbehorende URI.
      operationId: getContact
      parameters:
      - description: Organisatie URI
        explode: false
        in: path
        name: organisatieUri
        required: true
        schema:
          pattern: ^https://identifier\.overheid\.nl/tooi/id/[^/]+/[^/]+$
        style: simple
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Contact'
          description: De contactgegevens.
          headers:
            API-Version:
              description: header met de API versie
              examples:
                API-Version:
                  description: API-Version
                  value: 1.0.1
              schema: {}
              style: simple
        "400":
          content:
            application/json:
              examples:
                400 Error response:
                  description: 400 Error response
                  value:
                    error: Bad Request
                    message: Invalid identifier provided
                    status: 400
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Ongeldige opdracht.
        "404":
          content:
            application/json:
              examples:
                404 Error response:
                  description: 404 Error response
                  value:
                    error: Not Found
                    message: No organisation found for given identifier
                    status: 404
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Niet gevonden.
        "500":
          content:
            application/json:
              examples:
                500 Error response:
                  description: 500 Error response
                  value:
                    error: Internal Server Error
                    message: Internal error occurred
                    status: 500
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Technisch probleem.
      summary: Contactgegevens via URI
      tags:
      - Contactgegevens
  /v1/overheidsorganisaties/{organisatieUri}/domeinen:
    get:
      description: Vraag alle domeinen van een specifieke overheidsorganisatie op
        aan de hand van de bijbehorende URI.
      operationId: getDomeinen
      parameters:
      - description: Organisatie URI
        explode: false
        in: path
        name: organisatieUri
        required: true
        schema:
          pattern: ^https://identifier\.overheid\.nl/tooi/id/[^/]+/[^/]+$
        style: simple
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/Domein'
          description: Een lijst van domeinen.
          headers:
            API-Version:
              description: header met de API versie
              examples:
                API-Version:
                  description: API-Version
                  value: 1.0.1
              schema: {}
              style: simple
        "400":
          content:
            application/json:
              examples:
                400 Error response:
                  description: 400 Error response
                  value:
                    error: Bad Request
                    message: Invalid identifier provided
                    status: 400
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Ongeldige opdracht.
        "404":
          content:
            application/json:
              examples:
                404 Error response:
                  description: 404 Error response
                  value:
                    error: Not Found
                    message: No organisation found for given identifier
                    status: 404
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Niet gevonden.
        "500":
          content:
            application/json:
              examples:
                500 Error response:
                  description: 500 Error response
                  value:
                    error: Internal Server Error
                    message: Internal error occurred
                    status: 500
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Technisch probleem.
      summary: Domeinen via URI
      tags:
      - Domeinen en domeinnaamregistraties
  /v1/overheidsorganisaties/{organisatieUri}/domeinnaamregistraties:
    get:
      description: Vraag alle domeinnaamregistraties van een specifieke overheidsorganisatie
        op aan de hand van de bijbehorende URI.
      operationId: getDomeinnaamregistraties
      parameters:
      - description: Organisatie URI
        explode: false
        in: path
        name: organisatieUri
        required: true
        schema:
          pattern: ^https://identifier\.overheid\.nl/tooi/id/[^/]+/[^/]+$
        style: simple
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/Domeinnaamregistratie'
          description: Een lijst van domeinnaamregistraties.
          headers:
            API-Version:
              description: header met de API versie
              examples:
                API-Version:
                  description: API-Version
                  value: 1.0.1
              schema: {}
              style: simple
        "400":
          content:
            application/json:
              examples:
                400 Error response:
                  description: 400 Error response
                  value:
                    error: Bad Request
                    message: Invalid identifier provided
                    status: 400
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Ongeldige opdracht.
        "404":
          content:
            application/json:
              examples:
                404 Error response:
                  description: 404 Error response
                  value:
                    error: Not Found
                    message: No organisation found for given identifier
                    status: 404
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Niet gevonden.
        "500":
          content:
            application/json:
              examples:
                500 Error response:
                  description: 500 Error response
                  value:
                    error: Internal Server Error
                    message: Internal error occurred
                    status: 500
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Technisch probleem.
      summary: Domeinnaamregistraties via URI
      tags:
      - Domeinen en domeinnaamregistraties
  /v1/overheidsorganisaties/{organisatieUri}/historische-versies:
    get:
      description: Vraag alle historische versies van een specifieke overheidsorganisatie
        op. Indien er geen historische versies bij de organisatie zijn, wordt een
        lege array teruggegeven.
      operationId: historische-versies
      parameters:
      - examples:
          Ministerie:
            value: https://identifier.overheid.nl/tooi/id/ministerie/mnre1058
        explode: false
        in: path
        name: organisatieUri
        required: true
        schema:
          $ref: '#/components/schemas/organisatieUri'
        style: simple
      responses:
        5XX:
          $ref: '#/components/responses/5XX'
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/historischeVersies'
          description: Een lijst van historische versies van overheidsorganisaties.
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
            Content-Security-Policy:
              $ref: '#/components/headers/Content-Security-Policy'
            Content-Type:
              $ref: '#/components/headers/Content-Type'
            Date:
              $ref: '#/components/headers/Date'
            Etag:
              $ref: '#/components/headers/Etag'
            Strict-Transport-Security:
              $ref: '#/components/headers/Strict-Transport-Security'
            Vary:
              $ref: '#/components/headers/Vary'
            X-Content-Type-Options:
              $ref: '#/components/headers/X-Content-Type-Options'
        "404":
          $ref: '#/components/responses/404'
      summary: Historische versies
      tags:
      - Overheidsorganisaties
  /v1/overheidsorganisaties/{organisatieUri}/historische-versies/{hvUri}:
    get:
      description: Vraag een specifieke historische versie van een overheidsorganisatie
        op.
      operationId: historische-versie
      parameters:
      - examples:
          Ministerie:
            value: https://identifier.overheid.nl/tooi/id/ministerie/mnre1058
        explode: false
        in: path
        name: organisatieUri
        required: true
        schema:
          $ref: '#/components/schemas/organisatieUri'
        style: simple
      - examples:
          ministerie van Justitie:
            value: https://identifier.overheid.nl/tooi/id/ministerie/hv_04793043
          ministerie van Veiligheid en Justitie:
            value: https://identifier.overheid.nl/tooi/id/ministerie/hv_04795600
        explode: false
        in: path
        name: hvUri
        required: true
        schema:
          $ref: '#/components/schemas/hvUri'
        style: simple
      responses:
        5XX:
          $ref: '#/components/responses/5XX'
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/historische-versie'
          description: Een historische versie van een overheidsorganisatie.
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
            Content-Security-Policy:
              $ref: '#/components/headers/Content-Security-Policy'
            Content-Type:
              $ref: '#/components/headers/Content-Type'
            Date:
              $ref: '#/components/headers/Date'
            Etag:
              $ref: '#/components/headers/Etag'
            Strict-Transport-Security:
              $ref: '#/components/headers/Strict-Transport-Security'
            Vary:
              $ref: '#/components/headers/Vary'
            X-Content-Type-Options:
              $ref: '#/components/headers/X-Content-Type-Options'
        "404":
          $ref: '#/components/responses/404'
      summary: Historische versie via URI
      tags:
      - Overheidsorganisaties
  /v1/overheidsorganisaties/{organisatieUri}/identificatie:
    get:
      description: Vraag op basis van de TOOI-URI alle identificatiecodes die de organisatie
        heeft
      operationId: getIdentificatiecodeTOOI
      parameters:
      - description: Organisatie URI
        explode: false
        in: path
        name: organisatieUri
        required: true
        schema:
          pattern: ^https://identifier\.overheid\.nl/tooi/id/[^/]+/[^/]+$
        style: simple
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdentificatiecodeRecord'
          description: Identificatiecodes.
          headers:
            API-Version:
              description: header met de API versie
              examples:
                API-Version:
                  description: API-Version
                  value: 1.0.1
              schema: {}
              style: simple
        "400":
          content:
            application/json:
              examples:
                400 Error response:
                  description: 400 Error response
                  value:
                    error: Bad Request
                    message: Invalid identifier provided
                    status: 400
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Ongeldige opdracht.
        "404":
          content:
            application/json:
              examples:
                404 Error response:
                  description: 404 Error response
                  value:
                    error: Not Found
                    message: No organisation found for given identifier
                    status: 404
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Niet gevonden.
        "500":
          content:
            application/json:
              examples:
                500 Error response:
                  description: 500 Error response
                  value:
                    error: Internal Server Error
                    message: Internal error occurred
                    status: 500
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Technisch probleem.
      summary: Identificatiecodes via URI
      tags:
      - Identificatiecodes
  /v1/overheidsorganisaties/{organisatieUri}/woo:
    get:
      description: Vraag op basis van de TOOI-URI WOO informatie van organisatie op
      operationId: getWooByTOOI
      parameters:
      - description: Organisatie URI
        explode: false
        in: path
        name: organisatieUri
        required: true
        schema:
          pattern: ^https://identifier\.overheid\.nl/tooi/id/[^/]+/[^/]+$
        style: simple
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Woo'
          description: WOO informatie.
          headers:
            API-Version:
              description: header met de API versie
              examples:
                API-Version:
                  description: API-Version
                  value: 1.0.1
              schema: {}
              style: simple
        "400":
          content:
            application/json:
              examples:
                400 Error response:
                  description: 400 Error response
                  value:
                    error: Bad Request
                    message: Invalid identifier provided
                    status: 400
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Ongeldige opdracht.
        "404":
          content:
            application/json:
              examples:
                404 Error response:
                  description: 404 Error response
                  value:
                    error: Not Found
                    message: No organisation found for given identifier
                    status: 404
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Niet gevonden.
        "500":
          content:
            application/json:
              examples:
                500 Error response:
                  description: 500 Error response
                  value:
                    error: Internal Server Error
                    message: Internal error occurred
                    status: 500
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Technisch probleem.
      summary: WOO informatie via URI
      tags:
      - WOO
  /v1/overheidsorganisaties/classificaties:
    get:
      description: Lijst van organisaties met (een bepaalde) classificatie(s) van
        een bepaald grondslag/geldigheid.
      operationId: getAllOrFiltered
      parameters:
      - description: Type classificatie
        example: WNT-instelling
        explode: true
        in: query
        name: type
        required: false
        schema: {}
        style: form
      - description: Is de classificatie actief
        example: true
        explode: true
        in: query
        name: actief
        required: false
        schema: {}
        style: form
      - description: Grondslag uit waardelijst
        example: Gemeenten (Artikel 1.2, lid 1c, WNT)
        explode: true
        in: query
        name: grondslag
        required: false
        schema: {}
        style: form
      - description: Entiteit type URI
        examples:
          Caribisch openbaar lichaam:
            description: Caribisch openbaar lichaam
            value: https://identifier.overheid.nl/tooi/def/ont/CaribischOpenbaarLichaam
          Gemeente:
            description: Gemeente
            value: https://identifier.overheid.nl/tooi/def/ont/Gemeente
          Ministerie:
            description: Ministerie
            value: https://identifier.overheid.nl/tooi/def/ont/Ministerie
          Overige overheidsorganisatie:
            description: Overige overheidsorganisatie
            value: https://identifier.overheid.nl/tooi/def/ont/Overheidsorganisatie
          Provincie:
            description: Provincie
            value: https://identifier.overheid.nl/tooi/def/ont/Provincie
          Rijk:
            description: Rijk
            value: https://identifier.overheid.nl/tooi/def/ont/Rijk
          Samenwerkingsorganisatie:
            description: Samenwerkingsorganisatie
            value: https://identifier.overheid.nl/tooi/def/ont/Samenwerkingsorganisatie
          Waterschap:
            description: Waterschap
            value: https://identifier.overheid.nl/tooi/def/ont/Waterschap
          Zbo:
            description: Zbo
            value: https://identifier.overheid.nl/tooi/def/ont/Zbo
          Zbo-cluster:
            description: Zbo-cluster
            value: https://identifier.overheid.nl/tooi/def/ont/ZboCluster
        explode: true
        in: query
        name: entiteitType
        required: false
        schema: {}
        style: form
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ClassificatieUitgebreid'
          description: Lijst van organisaties met (gefilterde) classificaties
          headers:
            API-Version:
              description: header met de API versie
              schema: {}
              style: simple
        "400":
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Ongeldige query-parameters
        "500":
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Technisch probleem
      summary: Lijst van organisaties met classificaties (gefilterd)
      tags:
      - Classificatie
  /v1/overheidsorganisaties/classificaties/types:
    get:
      description: Lijst met classificatie types.
      operationId: getClassificatieTypes
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ClassificatieType'
          description: Een lijst van classificatie types.
          headers:
            API-Version:
              description: header met de API versie
              examples:
                API-Version:
                  description: API-Version
                  value: 1.0.1
              schema: {}
              style: simple
        "400":
          content:
            application/json:
              examples:
                400 Error response:
                  description: 400 Error response
                  value:
                    error: Bad Request
                    message: Invalid identifier provided
                    status: 400
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Ongeldige opdracht.
        "404":
          content:
            application/json:
              examples:
                404 Error response:
                  description: 404 Error response
                  value:
                    error: Not Found
                    message: No organisation found for given identifier
                    status: 404
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Niet gevonden.
        "500":
          content:
            application/json:
              examples:
                500 Error response:
                  description: 500 Error response
                  value:
                    error: Internal Server Error
                    message: Internal error occurred
                    status: 500
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Technisch probleem.
      summary: Classificatie types
      tags:
      - Classificatie
  /v1/overheidsorganisaties/identificatie:
    get:
      description: Vraag op basis van een identificatiecode alle identificatiecodes
        die de organisatie heeft. <br/> Minimaal 1 code als zoekargument is verplicht
      operationId: findIdentificatiecodeForQueryParam
      parameters:
      - explode: true
        in: query
        name: btwNummer
        required: false
        schema:
          pattern: ^NL\d{9}B\d{2}$
        style: form
      - explode: true
        in: query
        name: ictuCode
        required: false
        schema: {}
        style: form
      - explode: true
        in: query
        name: kvkNummer
        required: false
        schema:
          pattern: ^\d{8}$
        style: form
      - explode: true
        in: query
        name: loonheffingennummer
        required: false
        schema:
          pattern: ^\d{9}L\d{2}$
        style: form
      - explode: true
        in: query
        name: oin
        required: false
        schema:
          maxLength: 20
        style: form
      - explode: true
        in: query
        name: organisatiecode
        required: false
        schema:
          pattern: ^col[0-9]{2}$|^gm[0-9]{4}$|^mnre[0-9]{4}$|^oorg[0-9]{5}$|^pv[0-9]{2}$|^so[0-9]{4}$|^zb[0-9]{6}$
        style: form
      - explode: true
        in: query
        name: owmsId
        required: false
        schema:
          pattern: ^http://standaarden\.overheid\.nl/owms/terms/[^/]+$
        style: form
      - explode: true
        in: query
        name: systeemId
        required: false
        schema: {}
        style: form
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdentificatiecodeRecord'
          description: Identificatiecodes.
          headers:
            API-Version:
              description: header met de API versie
              examples:
                API-Version:
                  description: API-Version
                  value: 1.0.1
              schema: {}
              style: simple
        "400":
          content:
            application/json:
              examples:
                400 Error response:
                  description: 400 Error response
                  value:
                    error: Bad Request
                    message: Invalid identifier provided
                    status: 400
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Ongeldige opdracht.
        "404":
          content:
            application/json:
              examples:
                404 Error response:
                  description: 404 Error response
                  value:
                    error: Not Found
                    message: No organisation found for given identifier
                    status: 404
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Niet gevonden.
        "500":
          content:
            application/json:
              examples:
                500 Error response:
                  description: 500 Error response
                  value:
                    error: Internal Server Error
                    message: Internal error occurred
                    status: 500
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Technisch probleem.
      summary: Identificatiecodes via code
      tags:
      - Identificatiecodes
  /v1/overheidsorganisaties/identificatie/suggest:
    get:
      description: Vraag op basis van een code een lijst van organisaties en hun identificatiecodes  waar
        een van de identificatiecodes het gegeven zoekargument bevat. <br/> Het veld
        matchMet geeft aan welke identificatiecode een match geeft
      operationId: findSuggest
      parameters:
      - explode: true
        in: query
        name: code
        required: true
        schema: {}
        style: form
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/SuggestIdentificatiecodeRecord'
          description: Identificatiecodes.
          headers:
            API-Version:
              description: header met de API versie
              examples:
                API-Version:
                  description: API-Version
                  value: 1.0.1
              schema: {}
              style: simple
        "400":
          content:
            application/json:
              examples:
                400 Error response:
                  description: 400 Error response
                  value:
                    error: Bad Request
                    message: Invalid identifier provided
                    status: 400
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Ongeldige opdracht.
        "404":
          content:
            application/json:
              examples:
                404 Error response:
                  description: 404 Error response
                  value:
                    error: Not Found
                    message: No organisation found for given identifier
                    status: 404
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Niet gevonden.
        "500":
          content:
            application/json:
              examples:
                500 Error response:
                  description: 500 Error response
                  value:
                    error: Internal Server Error
                    message: Internal error occurred
                    status: 500
              schema:
                $ref: '#/components/schemas/ErrorRecord'
          description: Technisch probleem.
      summary: Identificatiecodes via suggest code
      tags:
      - Identificatiecodes
  /v1/wijzigingsgebeurtenissen:
    get:
      description: Vraag van alle wijzigingsgebeurtenissen de URI en het type op.
        Het is mogelijk te filteren op basis van type.
      operationId: wijzigingsgebeurtenissen
      parameters:
      - allowReserved: true
        examples:
          Afsplitsing:
            value: https://identifier.overheid.nl/tooi/def/ont/Afsplitsing
          Herschikking:
            value: https://identifier.overheid.nl/tooi/def/ont/Herschikking
          Opheffing:
            value: https://identifier.overheid.nl/tooi/def/ont/Opheffing
          Oprichting:
            value: https://identifier.overheid.nl/tooi/def/ont/Oprichting
          Opsplitsing:
            value: https://identifier.overheid.nl/tooi/def/ont/Opsplitsing
          Samenvoeging:
            value: https://identifier.overheid.nl/tooi/def/ont/Samenvoeging
          Toestandswijziging:
            value: https://identifier.overheid.nl/tooi/def/ont/Toestandswijziging
          Uitbreiding:
            value: https://identifier.overheid.nl/tooi/def/ont/Uitbreiding
        explode: true
        in: query
        name: type
        required: false
        schema:
          $ref: '#/components/schemas/wzgType'
        style: form
      responses:
        5XX:
          $ref: '#/components/responses/5XX'
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/wijzigingsgebeurtenissen'
          description: Een lijst van wijzigingsgebeurtenissen.
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
            Content-Security-Policy:
              $ref: '#/components/headers/Content-Security-Policy'
            Content-Type:
              $ref: '#/components/headers/Content-Type'
            Date:
              $ref: '#/components/headers/Date'
            Etag:
              $ref: '#/components/headers/Etag'
            Strict-Transport-Security:
              $ref: '#/components/headers/Strict-Transport-Security'
            Vary:
              $ref: '#/components/headers/Vary'
            X-Content-Type-Options:
              $ref: '#/components/headers/X-Content-Type-Options'
        "400":
          $ref: '#/components/responses/400'
      summary: Wijzigingsgebeurtenissen
      tags:
      - Wijzigingsgebeurtenissen
    post:
      description: |
        Lever een nieuwe wijzigingsgebeurtenis aan. De betrokken organisaties (`used`, `generated`, `invalidated`) worden gelinkt aan de wijzigingsgebeurtenis. Hieronder volgt meer informatie over deze drie properties:

        * `used`: de organisatie zelf verandert niet; alleen de URI van de organisatie wordt gekoppeld aan de nieuwe wijzigingsgebeurtenis.
        * `generated`: de organisatie wordt toegevoegd als nieuwe resource met alle eigenschappen binnen deze property. Daarnaast worden de properties `begindatum` en `generatedAtTime` automatisch toegevoegd aan de nieuwe organisatie als afgeleiden van `tijdstipWijziging`. Indien `tijdstipWijziging` niet wordt meegegeven, dan zullen de properties `begindatum` en `generatedAtTime` niet worden aangemaakt bij de organisatie.
        * `invalidated`: als de property `tijdstipWijziging` wordt meegegeven, dan worden de properties `einddatum` en `invalidatedAtTime` automatisch toegevoegd aan de betreffende organisatie. Anders vinden er aan de resource van de betreffende organisatie geen wijzigingen plaats.

        ### Toestandswijzigingen
        Bij het type toestandswijziging kan een beperkte set eigenschappen worden meegegeven in het object `properties`. Eigenschappen die daarin niet worden meegeleverd, worden verwijderd ten opzichte van de oude toestand. Eigenschappen die niet kunnen worden aangeleverd bij een toestandswijziging (zoals `uri`,`organisatiecode` en `begindatum`), worden overgenomen van de oude toestand.
      operationId: wijzigingsgebeurtenisPost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WijzigingsgebeurtenisPost'
      responses:
        5XX:
          $ref: '#/components/responses/5XX'
        "201":
          $ref: '#/components/responses/201'
        "400":
          $ref: '#/components/responses/400'
        "401":
          $ref: '#/components/responses/401'
      security:
      - ApiKeyAuth: []
      summary: Wijzigingsgebeurtenis aanleveren
      tags:
      - Wijzigingsgebeurtenissen
  /v1/wijzigingsgebeurtenissen/{wzgUri}:
    get:
      description: Vraag een specifieke wijzigingsgebeurtenis op aan de hand van de
        bijbehorende URI.
      operationId: wijzigingsgebeurtenis
      parameters:
      - examples:
          Samenvoeging:
            value: https://identifier.overheid.nl/tooi/id/gemeente/wzg_08566218
        explode: false
        in: path
        name: wzgUri
        required: true
        schema:
          $ref: '#/components/schemas/wzgUri'
        style: simple
      responses:
        5XX:
          $ref: '#/components/responses/5XX'
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Wijzigingsgebeurtenis'
          description: Een specifieke wijzigingsgebeurtenis.
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
            Content-Security-Policy:
              $ref: '#/components/headers/Content-Security-Policy'
            Content-Type:
              $ref: '#/components/headers/Content-Type'
            Date:
              $ref: '#/components/headers/Date'
            Etag:
              $ref: '#/components/headers/Etag'
            Strict-Transport-Security:
              $ref: '#/components/headers/Strict-Transport-Security'
            Vary:
              $ref: '#/components/headers/Vary'
            X-Content-Type-Options:
              $ref: '#/components/headers/X-Content-Type-Options'
        "404":
          $ref: '#/components/responses/404'
      summary: Wijzigingsgebeurtenis via URI
      tags:
      - Wijzigingsgebeurtenissen
servers:
- url: /
tags:
- name: Overheidsorganisaties
- name: Wijzigingsgebeurtenissen
