components:
  parameters:
    AcceptCrsHeader:
      description: |
        De EPSG code van het coordinaatstelsel van de geometrie van het verzoek welke dient te worden teruggegeven. RD of ETRS89.
        Indien deze niet word gevuld zal ETRS89 worden gebruikt.
      in: header
      name: Accept-Crs
      schema:
        default: EPSG:4258
        enum:
        - EPSG:28992
        - EPSG:4258
        example: EPSG:28992
        type: string
    AcceptStamHeader:
      description: Via de accept header kan de STAM-versie worden aangegeven middels
        een extra argument van het media type, bijvoorbeeld `application/xml;stam=5`
        of `application/hal+json;stam=6`. Ondersteunende STAM versies zijn 5 en 6.
      in: header
      name: Accept
      required: false
      schema:
        example: application/xml;stam=6
        type: string
    ContentCrsHeader:
      description: De EPSG code van het coordinaatstelsel van de meegegeven geometrie.
        RD of ETRS89.
      in: header
      name: Content-Crs
      schema:
        enum:
        - EPSG:28992
        - EPSG:4258
        example: EPSG:28992
        type: string
    documentId:
      description: id van het document
      in: path
      name: documentId
      required: true
      schema:
        type: string
    page:
      description: De pagina van het zoekresultaat die moet worden teruggeven.
      in: query
      name: page
      schema:
        default: 0
        example: 0
        format: int32
        type: integer
    size:
      description: Het aantal resultaten dat per pagina moet worden teruggegeven.
      in: query
      name: size
      schema:
        default: 20
        example: 20
        format: int32
        maximum: 200
        minimum: 1
        type: integer
    verzoeknummerInPath:
      description: nummer van het verzoek
      in: path
      name: verzoeknummer
      required: true
      schema:
        example: "2019090600002"
        maxLength: 13
        type: string
  schemas:
    "401":
      allOf:
      - properties:
          instance:
            type: string
          status:
            format: int64
            type: integer
          title:
            type: string
          type:
            type: string
        required:
        - type
        - title
        - status
      example:
        detail: U bent niet geautoriseerd voor dit verzoek.
        instance: 539f14d69f2fba81
        status: 401
        title: Authenticatiegegevens ontbreken of zijn onjuist.
        type: https://content.omgevingswet.overheid.nl/id/concept/Ongeautoriseerd
      properties:
        detail:
          type: string
    "404":
      allOf:
      - properties:
          instance:
            type: string
          status:
            format: int64
            type: integer
          title:
            type: string
          type:
            type: string
        required:
        - type
        - title
        - status
      example:
        detail: Verzoek niet gevonden.
        instance: 539f14d69f2fba81
        status: 404
        title: Niet gevonden.
        type: https://content.omgevingswet.overheid.nl/id/concept/BestaatNiet
      properties:
        detail:
          type: string
    "406":
      allOf:
      - properties:
          instance:
            type: string
          status:
            format: int64
            type: integer
          title:
            type: string
          type:
            type: string
        required:
        - type
        - title
        - status
      example:
        detail: 'Beschikbare stam versies: 5, 6'
        instance: 539f14d69f2fba81
        status: 406
        title: De gevraagde STAM versie is niet beschikbaar.
        type: https://content.omgevingswet.overheid.nl/id/concept/StamVersieNietAcceptabel
      properties:
        detail:
          type: string
    "409":
      allOf:
      - properties:
          instance:
            type: string
          status:
            format: int64
            type: integer
          title:
            type: string
          type:
            type: string
        required:
        - type
        - title
        - status
      example:
        detail: Probeer het later nog eens, nadat de aanvulling is verwerkt.
        instance: 539f14d69f2fba81
        status: 409
        title: Conflict
        type: https://content.omgevingswet.overheid.nl/id/concept/Conflict
      properties:
        detail:
          type: string
    "500":
      allOf:
      - properties:
          instance:
            type: string
          status:
            format: int64
            type: integer
          title:
            type: string
          type:
            type: string
        required:
        - type
        - title
        - status
      example:
        detail: Er is iets mis gegaan.
        instance: 539f14d69f2fba81
        status: 500
        title: Interne serverfout
        type: https://content.omgevingswet.overheid.nl/id/concept/ServerFout
      properties:
        detail:
          type: string
    Activiteit:
      properties:
        id:
          description: De 'functioneleStructuurReferentie' van de activiteit.
          type: string
        naam:
          description: De 'naam' van de activiteit.
          type: string
        subactiviteit:
          description: een sub-activiteit. Gevuld indien er sprake is van een sub-activiteit.
          items:
            properties:
              id:
                description: De 'functioneleStructuurReferentie' van de subactiviteit.
                type: string
              naam:
                description: De 'naam' van de subactiviteit.
                type: string
              urn:
                description: De 'urn' van de subactiviteit. Ook wel imow-id genoemd.
                type: string
            required:
            - id
            - urn
            - naam
            type: object
          type: array
        urn:
          description: De 'urn' van de activiteit. Ook wel imow-id genoemd.
          type: string
      required:
      - id
      - urn
      - naam
      type: object
    BehandeldienstWijzigen:
      example:
        oinBehandeldienst: "00000000000987654321"
        oinBevoegdGezag: "00000000000123456789"
      properties:
        oinBehandeldienst:
          description: Organisatie identificatie nummer van behandeldienst. Indien
            geen OIN wordt opgegeven of null dan wordt deze verwijderd.
          nullable: true
          pattern: ^\d{20}$
          type: string
        oinBevoegdGezag:
          description: Organisatie identificatie nummer van bevoegd gezag. Indien
            deze niet hetzelfde is als het huidige bevoegd gezag dan wordt deze gewijzigd.
          pattern: ^\d{20}$
          type: string
      required:
      - oinBevoegdGezag
      type: object
    BevoegdGezag:
      example:
        naam: Provincie Zuid-Holland
        organisatieIdentificatieNummer: "00000000000123456789"
      properties:
        naam:
          type: string
        organisatieIdentificatieNummer:
          pattern: ^\d{20}$
          type: string
      required:
      - organisatieIdentificatieNummer
      - naam
      type: object
    BevoegdGezagWijzigen:
      example:
        organisatieIdentificatieNummer: "00000000000123456789"
      properties:
        organisatieIdentificatieNummer:
          pattern: ^\d{20}$
          type: string
      required:
      - organisatieIdentificatieNummer
      type: object
    Document:
      example:
        _links:
          content:
            href: https://api.dso.nl/verzoeken/2017010100001/documenten/1/content
          self:
            href: https://api.dso.nl/verzoeken/2017010100001/documenten/1
        documentId: 51c4275449f3760f9cabad9e6c1478764e19be6802a900b188248b068403f912
        metadata:
          bestandsnaam: Tekening_van_de_uitbouw.pdf
          documentOmschrijving: Overig
          formaat: application/pdf
          vertrouwelijkAanduiding: Vertrouwelijk
      properties:
        _links:
          properties:
            content:
              example:
                href: https://api.dso.nl/verzoeken/2017010100001
              properties:
                href:
                  type: string
              required:
              - href
            self:
              example:
                href: https://api.dso.nl/verzoeken/2017010100001
              properties:
                href:
                  type: string
              required:
              - href
          type: object
        documentId:
          maxLength: 128
          type: string
        id:
          type: integer
        metadata:
          description: metadata
          properties:
            bestandsnaam:
              type: string
            documentOmschrijving:
              description: aanduiding van de aard van de gevraagde bijlage zoals gehanteerd
                door de zaakbehandelende organisatie, gebaseerd op 'documenttypeGeneriek'.
                Bevat een lege string als de documentOmschrijving niet bekend is.
              type: string
            formaat:
              description: het MIME-type
              type: string
            vertrouwelijkAanduiding:
              description: geeft aan of het document als vertrouwelijk moet worden
                behandeld.
              enum:
              - Vertrouwelijk
              - Niet vertrouwelijk
              type: string
          required:
          - bestandsnaam
          - vertrouwelijkAanduiding
          - documentOmschrijving
          - formaat
          type: object
      required:
      - id
      - documentId
      - metadata
      type: object
    DoelVerzoekStam5And6:
      description: Het doel van het verzoek. Op basis van de gevraagde STAM-versie
        zal de corresponderende enumeratie worden teruggegeven.
      enum:
      - Indienen
      - Aanvullen
      - Intrekken
      type: string
    Fout:
      properties:
        instance:
          type: string
        status:
          format: int64
          type: integer
        title:
          type: string
        type:
          type: string
      required:
      - type
      - title
      - status
    GeometryCollection:
      description: GeoJSON GeometryCollection gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.8
        Alleen een GeometryCollection met Polygonen wordt ondersteund.
      example:
        geometries:
        - coordinates:
          - - - 92879.88
              - 436405.07
            - - 93390.88
              - 436893.58
            - - 92968.36
              - 436872.3
            - - 92879.88
              - 436405.07
          - - - 92870.88
              - 436400.07
            - - 93390.88
              - 436893.58
            - - 92968.36
              - 436872.3
            - - 92870.88
              - 436400.07
          type: Polygon
        - coordinates:
          - - - 92879.88
              - 436405.07
            - - 93390.88
              - 436893.58
            - - 92968.36
              - 436872.3
            - - 92879.88
              - 436405.07
          - - - 92870.88
              - 436400.07
            - - 93390.88
              - 436893.58
            - - 92968.36
              - 436872.3
            - - 92870.88
              - 436400.07
          type: Polygon
        type: GeometryCollection
      properties:
        geometries:
          description: De geometries van de GeometryCollection volgens https://tools.ietf.org/html/rfc7946#section-3.1.8
          items:
            description: GeoJSON Polygon gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
            example:
              coordinates:
              - - - 92879.88
                  - 436405.07
                - - 93390.88
                  - 436893.58
                - - 92968.36
                  - 436872.3
                - - 92879.88
                  - 436405.07
              - - - 92870.88
                  - 436400.07
                - - 93390.88
                  - 436893.58
                - - 92968.36
                  - 436872.3
                - - 92870.88
                  - 436400.07
              type: Polygon
            properties:
              coordinates:
                description: De coördinaten van het polygoon volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                items:
                  items:
                    description: |
                      De coördinaten van het punt waarbij het 1e item de
                      x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                      volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                      ```
                      RD; [92949.643, 436720.672]
                      WGS84; [4.48531, 51.915512]
                      ETRS89; [4.48531, 51.915512]
                      ```
                    example:
                    - 92949.643
                    - 436720.672
                    items:
                      type: number
                    minItems: 2
                    type: array
                  minItems: 4
                  type: array
                type: array
              type:
                enum:
                - Polygon
                type: string
            required:
            - type
            - coordinates
            title: Vlak
            type: object
          type: array
        type:
          enum:
          - GeometryCollection
          type: string
      required:
      - type
      - geometries
      title: Vlak
      type: object
    HalLink:
      example:
        href: https://api.dso.nl/verzoeken/2017010100001
      properties:
        href:
          type: string
      required:
      - href
    HalPaginationLinks:
      description: uri's voor het gebruik van paginering
      properties:
        first:
          allOf:
          - example:
              href: https://api.dso.nl/verzoeken/2017010100001
            properties:
              href:
                type: string
            required:
            - href
          description: uri voor het opvragen van de eerste pagina van deze collectie
          properties:
            title:
              example: Eerste pagina
              type: string
        last:
          allOf:
          - example:
              href: https://api.dso.nl/verzoeken/2017010100001
            properties:
              href:
                type: string
            required:
            - href
          description: uri voor het opvragen van de laatste pagina van deze collectie
          properties:
            title:
              example: Laatste pagina
              type: string
        next:
          allOf:
          - example:
              href: https://api.dso.nl/verzoeken/2017010100001
            properties:
              href:
                type: string
            required:
            - href
          description: uri voor het opvragen van de volgende pagina van deze collectie
          properties:
            title:
              example: Volgende pagina
              type: string
        prev:
          allOf:
          - example:
              href: https://api.dso.nl/verzoeken/2017010100001
            properties:
              href:
                type: string
            required:
            - href
          description: uri voor het opvragen van de vorige pagina van deze collectie
          properties:
            title:
              example: Vorige pagina
              type: string
      type: object
    Health:
      description: Health
      example:
        groups:
        - downstreamServices
        - self
        status: UP
      properties:
        groups:
          items:
            type: string
          type: array
        status:
          enum:
          - UP
          - DOWN
          - OUT_OF_SERVICE
          type: string
    Info:
      description: Info
      example:
        name: Verzoek afhandelen
        stamVersion:
        - "5"
        - "6"
        version: 3.1.0
      properties:
        name:
          type: string
        stamVersion:
          items:
            type: string
          type: array
        version:
          type: string
      required:
      - name
      - version
      - stamVersion
    InvalidParams:
      properties:
        name:
          type: string
        reason:
          type: string
        type:
          type: string
      required:
      - type
      - name
      - reason
    Locatie:
      description: Locatie waar het project is uitgevoerd. De geometrie van de locatie
        is standaard in ETRS89.
      example:
        geometrie:
          coordinates:
          - 81523.058
          - 456081.0821
          type: Point
      properties:
        geometrie:
          description: Punt of vlak waar het project is uitgevoerd.
          oneOf:
          - description: GeoJSON Point gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.2
            example:
              coordinates:
              - 1
              - 2
              type: Point
            properties:
              coordinates:
                description: |
                  De coördinaten van het punt waarbij het 1e item de
                  x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                  volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                  ```
                  RD; [92949.643, 436720.672]
                  WGS84; [4.48531, 51.915512]
                  ETRS89; [4.48531, 51.915512]
                  ```
                example:
                - 92949.643
                - 436720.672
                items:
                  type: number
                minItems: 2
                type: array
              type:
                enum:
                - Point
                type: string
            required:
            - type
            - coordinates
            title: Punt
            type: object
          - description: GeoJSON Polygon gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
            example:
              coordinates:
              - - - 92879.88
                  - 436405.07
                - - 93390.88
                  - 436893.58
                - - 92968.36
                  - 436872.3
                - - 92879.88
                  - 436405.07
              - - - 92870.88
                  - 436400.07
                - - 93390.88
                  - 436893.58
                - - 92968.36
                  - 436872.3
                - - 92870.88
                  - 436400.07
              type: Polygon
            properties:
              coordinates:
                description: De coördinaten van het polygoon volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                items:
                  items:
                    description: |
                      De coördinaten van het punt waarbij het 1e item de
                      x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                      volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                      ```
                      RD; [92949.643, 436720.672]
                      WGS84; [4.48531, 51.915512]
                      ETRS89; [4.48531, 51.915512]
                      ```
                    example:
                    - 92949.643
                    - 436720.672
                    items:
                      type: number
                    minItems: 2
                    type: array
                  minItems: 4
                  type: array
                type: array
              type:
                enum:
                - Polygon
                type: string
            required:
            - type
            - coordinates
            title: Vlak
            type: object
          - description: GeoJSON GeometryCollection gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.8
              Alleen een GeometryCollection met Polygonen wordt ondersteund.
            example:
              geometries:
              - coordinates:
                - - - 92879.88
                    - 436405.07
                  - - 93390.88
                    - 436893.58
                  - - 92968.36
                    - 436872.3
                  - - 92879.88
                    - 436405.07
                - - - 92870.88
                    - 436400.07
                  - - 93390.88
                    - 436893.58
                  - - 92968.36
                    - 436872.3
                  - - 92870.88
                    - 436400.07
                type: Polygon
              - coordinates:
                - - - 92879.88
                    - 436405.07
                  - - 93390.88
                    - 436893.58
                  - - 92968.36
                    - 436872.3
                  - - 92879.88
                    - 436405.07
                - - - 92870.88
                    - 436400.07
                  - - 93390.88
                    - 436893.58
                  - - 92968.36
                    - 436872.3
                  - - 92870.88
                    - 436400.07
                type: Polygon
              type: GeometryCollection
            properties:
              geometries:
                description: De geometries van de GeometryCollection volgens https://tools.ietf.org/html/rfc7946#section-3.1.8
                items:
                  description: GeoJSON Polygon gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                  example:
                    coordinates:
                    - - - 92879.88
                        - 436405.07
                      - - 93390.88
                        - 436893.58
                      - - 92968.36
                        - 436872.3
                      - - 92879.88
                        - 436405.07
                    - - - 92870.88
                        - 436400.07
                      - - 93390.88
                        - 436893.58
                      - - 92968.36
                        - 436872.3
                      - - 92870.88
                        - 436400.07
                    type: Polygon
                  properties:
                    coordinates:
                      description: De coördinaten van het polygoon volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                      items:
                        items:
                          description: |
                            De coördinaten van het punt waarbij het 1e item de
                            x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                            volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                            ```
                            RD; [92949.643, 436720.672]
                            WGS84; [4.48531, 51.915512]
                            ETRS89; [4.48531, 51.915512]
                            ```
                          example:
                          - 92949.643
                          - 436720.672
                          items:
                            type: number
                          minItems: 2
                          type: array
                        minItems: 4
                        type: array
                      type: array
                    type:
                      enum:
                      - Polygon
                      type: string
                  required:
                  - type
                  - coordinates
                  title: Vlak
                  type: object
                type: array
              type:
                enum:
                - GeometryCollection
                type: string
            required:
            - type
            - geometries
            title: Vlak
            type: object
      required:
      - geometrie
      type: object
    Page:
      description: Informatie voor paginering.
      properties:
        number:
          example: 0
          format: int32
          type: integer
        size:
          example: 20
          format: int32
          type: integer
        totalElements:
          example: 1
          format: int32
          type: integer
        totalPages:
          example: 1
          format: int32
          type: integer
      required:
      - number
      - size
      - totalElements
      - totalPages
      type: object
    PlichtTypeStam5And6:
      description: Het plichttype van het verzoek. Alleen maar beschikbaar vanaf STAM-versie
        '5'.
      enum:
      - Aanvraag vergunning
      - Melding
      - Informatie
      - Informatie ongewoon voorval
      - Aanvraag maatwerkvoorschrift
      - Melding gelijkwaardige maatregel
      - Aanvraag toestemming gelijkwaardige maatregel
      type: string
    Point:
      description: GeoJSON Point gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.2
      example:
        coordinates:
        - 1
        - 2
        type: Point
      properties:
        coordinates:
          description: |
            De coördinaten van het punt waarbij het 1e item de
            x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
            volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

            ```
            RD; [92949.643, 436720.672]
            WGS84; [4.48531, 51.915512]
            ETRS89; [4.48531, 51.915512]
            ```
          example:
          - 92949.643
          - 436720.672
          items:
            type: number
          minItems: 2
          type: array
        type:
          enum:
          - Point
          type: string
      required:
      - type
      - coordinates
      title: Punt
      type: object
    Polygon:
      description: GeoJSON Polygon gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
      example:
        coordinates:
        - - - 92879.88
            - 436405.07
          - - 93390.88
            - 436893.58
          - - 92968.36
            - 436872.3
          - - 92879.88
            - 436405.07
        - - - 92870.88
            - 436400.07
          - - 93390.88
            - 436893.58
          - - 92968.36
            - 436872.3
          - - 92870.88
            - 436400.07
        type: Polygon
      properties:
        coordinates:
          description: De coördinaten van het polygoon volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
          items:
            items:
              description: |
                De coördinaten van het punt waarbij het 1e item de
                x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                ```
                RD; [92949.643, 436720.672]
                WGS84; [4.48531, 51.915512]
                ETRS89; [4.48531, 51.915512]
                ```
              example:
              - 92949.643
              - 436720.672
              items:
                type: number
              minItems: 2
              type: array
            minItems: 4
            type: array
          type: array
        type:
          enum:
          - Polygon
          type: string
      required:
      - type
      - coordinates
      title: Vlak
      type: object
    Position:
      description: |
        De coördinaten van het punt waarbij het 1e item de
        x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
        volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

        ```
        RD; [92949.643, 436720.672]
        WGS84; [4.48531, 51.915512]
        ETRS89; [4.48531, 51.915512]
        ```
      example:
      - 92949.643
      - 436720.672
      items:
        type: number
      minItems: 2
      type: array
    ResultaatVerzoek:
      allOf:
      - example:
          verzoeknummer: "2017010100001"
          volgnummer: "000"
        properties:
          verzoeknummer:
            type: string
          volgnummer:
            type: string
        required:
        - verzoeknummer
        - volgnummer
        type: object
      description: |
        Resultaat van het ophalen van een verzoek. Bevat basisgegevens van een verzoek en de eventuele gekoppelde documenten.
      example:
        _embedded:
          documenten:
          - _links:
              content:
                href: https://api.dso.nl/verzoeken/2017010100001/documenten/51c4275449f3760f9cabad9e6c1478764e19be6802a900b188248b068403f912/content
              self:
                href: https://api.dso.nl/verzoeken/2017010100001/documenten/51c4275449f3760f9cabad9e6c1478764e19be6802a900b188248b068403f912
            documentId: 51c4275449f3760f9cabad9e6c1478764e19be6802a900b188248b068403f912
            metadata:
              bestandsnaam: Tekening_van_de_uitbouw.pdf
              documentOmschrijving: Overig
              formaat: application/pdf
              vertrouwelijkAanduiding: Vertrouwelijk
        _links:
          self:
            href: https://api.dso.nl/verzoeken/2017010100001
          verzoekPdf:
            href: https://api.dso.nl/verzoeken/2017010100001/samenvatting?format=pdf
          verzoekXml:
            href: https://api.dso.nl/verzoeken/2017010100001/samenvatting?format=xml
        verzoeknummer: "2017010100001"
        volgnummer: "000"
      properties:
        _embedded:
          properties:
            documenten:
              items:
                example:
                  _links:
                    content:
                      href: https://api.dso.nl/verzoeken/2017010100001/documenten/1/content
                    self:
                      href: https://api.dso.nl/verzoeken/2017010100001/documenten/1
                  documentId: 51c4275449f3760f9cabad9e6c1478764e19be6802a900b188248b068403f912
                  metadata:
                    bestandsnaam: Tekening_van_de_uitbouw.pdf
                    documentOmschrijving: Overig
                    formaat: application/pdf
                    vertrouwelijkAanduiding: Vertrouwelijk
                properties:
                  _links:
                    properties:
                      content:
                        example:
                          href: https://api.dso.nl/verzoeken/2017010100001
                        properties:
                          href:
                            type: string
                        required:
                        - href
                      self:
                        example:
                          href: https://api.dso.nl/verzoeken/2017010100001
                        properties:
                          href:
                            type: string
                        required:
                        - href
                    type: object
                  documentId:
                    maxLength: 128
                    type: string
                  id:
                    type: integer
                  metadata:
                    description: metadata
                    properties:
                      bestandsnaam:
                        type: string
                      documentOmschrijving:
                        description: aanduiding van de aard van de gevraagde bijlage
                          zoals gehanteerd door de zaakbehandelende organisatie, gebaseerd
                          op 'documenttypeGeneriek'. Bevat een lege string als de
                          documentOmschrijving niet bekend is.
                        type: string
                      formaat:
                        description: het MIME-type
                        type: string
                      vertrouwelijkAanduiding:
                        description: geeft aan of het document als vertrouwelijk moet
                          worden behandeld.
                        enum:
                        - Vertrouwelijk
                        - Niet vertrouwelijk
                        type: string
                    required:
                    - bestandsnaam
                    - vertrouwelijkAanduiding
                    - documentOmschrijving
                    - formaat
                    type: object
                required:
                - id
                - documentId
                - metadata
                type: object
              type: array
          type: object
        _links:
          properties:
            self:
              example:
                href: https://api.dso.nl/verzoeken/2017010100001
              properties:
                href:
                  type: string
              required:
              - href
            verzoekPdf:
              example:
                href: https://api.dso.nl/verzoeken/2017010100001
              properties:
                href:
                  type: string
              required:
              - href
            verzoekXml:
              example:
                href: https://api.dso.nl/verzoeken/2017010100001
              properties:
                href:
                  type: string
              required:
              - href
          type: object
      required:
      - _links
    SubActiviteit:
      properties:
        id:
          description: De 'functioneleStructuurReferentie' van de subactiviteit.
          type: string
        naam:
          description: De 'naam' van de subactiviteit.
          type: string
        urn:
          description: De 'urn' van de subactiviteit. Ook wel imow-id genoemd.
          type: string
      required:
      - id
      - urn
      - naam
      type: object
    ValidatieFout:
      allOf:
      - properties:
          instance:
            type: string
          status:
            format: int64
            type: integer
          title:
            type: string
          type:
            type: string
        required:
        - type
        - title
        - status
      example:
        instance: /verzoeken/_zoek
        invalid-params:
        - name: locatie
          reason: Locatie is een verplicht veld
          type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
        status: 400
        title: Validatie mislukt
        type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
      properties:
        invalid-params:
          items:
            properties:
              name:
                type: string
              reason:
                type: string
              type:
                type: string
            required:
            - type
            - name
            - reason
          type: array
    Verzoek:
      example:
        verzoeknummer: "2017010100001"
        volgnummer: "000"
      properties:
        verzoeknummer:
          type: string
        volgnummer:
          type: string
      required:
      - verzoeknummer
      - volgnummer
      type: object
    VerzoekTypeStam5And6:
      description: Het type van het verzoek. Op basis van de gevraagde STAM-versie
        zal de corresponderende enumeratie  worden teruggegeven.
      enum:
      - Concept
      - Definitief
      type: string
    VerzoekenZoekcriteria:
      description: |
        Zoekcriteria voor het zoeken naar ingediende verzoeken. Het VerzoekenZoekcriteria-object bevat of verzoeknummer of geometrie.
        Wanneer met het VerzoekenZoekcriteria-object wordt gezocht, retourneert de zoekopdracht de verzoeken waarvan de projectlocatie op of binnen de gegeven geometrie vallen.
      example:
        activiteit: nl.imow-mnre1034.activiteit.AanbrengenLagenMetalen
        eindDatumIngediendOp: "2021-05-20"
        geometrie:
          coordinates:
          - 81523.058
          - 456081.0821
          type: Point
        startDatumIngediendOp: "2021-01-20"
        verzoeknummer: "2019012100003"
      properties:
        activiteit:
          description: |
            Een zoekcriteriaparameter die aangeeft voor welke activiteit een verzoek is ingediend.
            Deze parameter dient gevuld te worden met de 'urn' van een activiteit. Ook wel imow-id genoemd.
          example: nl.imow-mnre1034.activiteit.AanbrengenLagenMetalen
          type: string
        eindDatumIngediendOp:
          description: |
            Een zoekcriteriaparameter die aangeeft dat verzoeken zijn ingediend tot en met deze datum.
          example: "2021-01-20"
          format: date
          type: string
        geometrie:
          description: |
            Punt of vlak waarop/waarbinnen de projectlocaties van de verzoeken moeten vallen.
            Indien deze parameter is gevuld, kan er geen verzoeknummer worden opgegeven in de zoekcriteria.
          example:
            coordinates:
            - 81523.058
            - 456081.0821
            type: Point
          oneOf:
          - description: GeoJSON Point gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.2
            example:
              coordinates:
              - 1
              - 2
              type: Point
            properties:
              coordinates:
                description: |
                  De coördinaten van het punt waarbij het 1e item de
                  x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                  volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                  ```
                  RD; [92949.643, 436720.672]
                  WGS84; [4.48531, 51.915512]
                  ETRS89; [4.48531, 51.915512]
                  ```
                example:
                - 92949.643
                - 436720.672
                items:
                  type: number
                minItems: 2
                type: array
              type:
                enum:
                - Point
                type: string
            required:
            - type
            - coordinates
            title: Punt
            type: object
          - description: GeoJSON Polygon gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
            example:
              coordinates:
              - - - 92879.88
                  - 436405.07
                - - 93390.88
                  - 436893.58
                - - 92968.36
                  - 436872.3
                - - 92879.88
                  - 436405.07
              - - - 92870.88
                  - 436400.07
                - - 93390.88
                  - 436893.58
                - - 92968.36
                  - 436872.3
                - - 92870.88
                  - 436400.07
              type: Polygon
            properties:
              coordinates:
                description: De coördinaten van het polygoon volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                items:
                  items:
                    description: |
                      De coördinaten van het punt waarbij het 1e item de
                      x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                      volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                      ```
                      RD; [92949.643, 436720.672]
                      WGS84; [4.48531, 51.915512]
                      ETRS89; [4.48531, 51.915512]
                      ```
                    example:
                    - 92949.643
                    - 436720.672
                    items:
                      type: number
                    minItems: 2
                    type: array
                  minItems: 4
                  type: array
                type: array
              type:
                enum:
                - Polygon
                type: string
            required:
            - type
            - coordinates
            title: Vlak
            type: object
          - description: GeoJSON GeometryCollection gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.8
              Alleen een GeometryCollection met Polygonen wordt ondersteund.
            example:
              geometries:
              - coordinates:
                - - - 92879.88
                    - 436405.07
                  - - 93390.88
                    - 436893.58
                  - - 92968.36
                    - 436872.3
                  - - 92879.88
                    - 436405.07
                - - - 92870.88
                    - 436400.07
                  - - 93390.88
                    - 436893.58
                  - - 92968.36
                    - 436872.3
                  - - 92870.88
                    - 436400.07
                type: Polygon
              - coordinates:
                - - - 92879.88
                    - 436405.07
                  - - 93390.88
                    - 436893.58
                  - - 92968.36
                    - 436872.3
                  - - 92879.88
                    - 436405.07
                - - - 92870.88
                    - 436400.07
                  - - 93390.88
                    - 436893.58
                  - - 92968.36
                    - 436872.3
                  - - 92870.88
                    - 436400.07
                type: Polygon
              type: GeometryCollection
            properties:
              geometries:
                description: De geometries van de GeometryCollection volgens https://tools.ietf.org/html/rfc7946#section-3.1.8
                items:
                  description: GeoJSON Polygon gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                  example:
                    coordinates:
                    - - - 92879.88
                        - 436405.07
                      - - 93390.88
                        - 436893.58
                      - - 92968.36
                        - 436872.3
                      - - 92879.88
                        - 436405.07
                    - - - 92870.88
                        - 436400.07
                      - - 93390.88
                        - 436893.58
                      - - 92968.36
                        - 436872.3
                      - - 92870.88
                        - 436400.07
                    type: Polygon
                  properties:
                    coordinates:
                      description: De coördinaten van het polygoon volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                      items:
                        items:
                          description: |
                            De coördinaten van het punt waarbij het 1e item de
                            x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                            volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                            ```
                            RD; [92949.643, 436720.672]
                            WGS84; [4.48531, 51.915512]
                            ETRS89; [4.48531, 51.915512]
                            ```
                          example:
                          - 92949.643
                          - 436720.672
                          items:
                            type: number
                          minItems: 2
                          type: array
                        minItems: 4
                        type: array
                      type: array
                    type:
                      enum:
                      - Polygon
                      type: string
                  required:
                  - type
                  - coordinates
                  title: Vlak
                  type: object
                type: array
              type:
                enum:
                - GeometryCollection
                type: string
            required:
            - type
            - geometries
            title: Vlak
            type: object
        startDatumIngediendOp:
          description: |
            Een zoekcriteriaparameter die aangeeft dat verzoeken zijn ingediend op of na deze datum.
          example: "2021-01-20"
          format: date
          type: string
        verzoeknummer:
          description: |
            Het verzoeknummer van het ingediende verzoek wat dient als basis voor het zoeken naar verzoeken.
            De projectlocatie van het verzoek word gebruikt om te zoeken naar andere verzoeken die binnen de projectlocatie vallen.
            Indien deze parameter is gevuld, kan er geen geometrie worden opgegeven in de zoekcriteria.
          example: "2019012100003"
          maxLength: 13
          type: string
      type: object
    ZoekresultaatVerzoek:
      allOf:
      - example:
          verzoeknummer: "2017010100001"
          volgnummer: "000"
        properties:
          verzoeknummer:
            type: string
          volgnummer:
            type: string
        required:
        - verzoeknummer
        - volgnummer
        type: object
      description: |
        Een verzoek item uit het zoekresultaat. Bevat basisgegevens van een verzoek.
      properties:
        activiteit:
          items:
            properties:
              id:
                description: De 'functioneleStructuurReferentie' van de activiteit.
                type: string
              naam:
                description: De 'naam' van de activiteit.
                type: string
              subactiviteit:
                description: een sub-activiteit. Gevuld indien er sprake is van een
                  sub-activiteit.
                items:
                  properties:
                    id:
                      description: De 'functioneleStructuurReferentie' van de subactiviteit.
                      type: string
                    naam:
                      description: De 'naam' van de subactiviteit.
                      type: string
                    urn:
                      description: De 'urn' van de subactiviteit. Ook wel imow-id
                        genoemd.
                      type: string
                  required:
                  - id
                  - urn
                  - naam
                  type: object
                type: array
              urn:
                description: De 'urn' van de activiteit. Ook wel imow-id genoemd.
                type: string
            required:
            - id
            - urn
            - naam
            type: object
          type: array
        behandeldienst:
          example:
            naam: Provincie Zuid-Holland
            organisatieIdentificatieNummer: "00000000000123456789"
          properties:
            naam:
              type: string
            organisatieIdentificatieNummer:
              pattern: ^\d{20}$
              type: string
          required:
          - organisatieIdentificatieNummer
          - naam
          type: object
        bevoegdGezag:
          example:
            naam: Provincie Zuid-Holland
            organisatieIdentificatieNummer: "00000000000123456789"
          properties:
            naam:
              type: string
            organisatieIdentificatieNummer:
              pattern: ^\d{20}$
              type: string
          required:
          - organisatieIdentificatieNummer
          - naam
          type: object
        datumIngediend:
          format: date-time
          type: string
        doelVerzoek:
          description: Het doel van het verzoek. Op basis van de gevraagde STAM-versie
            zal de corresponderende enumeratie worden teruggegeven.
          enum:
          - Indienen
          - Aanvullen
          - Intrekken
          type: string
        locatie:
          description: Locatie waar het project is uitgevoerd. De geometrie van de
            locatie is standaard in ETRS89.
          example:
            geometrie:
              coordinates:
              - 81523.058
              - 456081.0821
              type: Point
          properties:
            geometrie:
              description: Punt of vlak waar het project is uitgevoerd.
              oneOf:
              - description: GeoJSON Point gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.2
                example:
                  coordinates:
                  - 1
                  - 2
                  type: Point
                properties:
                  coordinates:
                    description: |
                      De coördinaten van het punt waarbij het 1e item de
                      x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                      volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                      ```
                      RD; [92949.643, 436720.672]
                      WGS84; [4.48531, 51.915512]
                      ETRS89; [4.48531, 51.915512]
                      ```
                    example:
                    - 92949.643
                    - 436720.672
                    items:
                      type: number
                    minItems: 2
                    type: array
                  type:
                    enum:
                    - Point
                    type: string
                required:
                - type
                - coordinates
                title: Punt
                type: object
              - description: GeoJSON Polygon gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                example:
                  coordinates:
                  - - - 92879.88
                      - 436405.07
                    - - 93390.88
                      - 436893.58
                    - - 92968.36
                      - 436872.3
                    - - 92879.88
                      - 436405.07
                  - - - 92870.88
                      - 436400.07
                    - - 93390.88
                      - 436893.58
                    - - 92968.36
                      - 436872.3
                    - - 92870.88
                      - 436400.07
                  type: Polygon
                properties:
                  coordinates:
                    description: De coördinaten van het polygoon volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                    items:
                      items:
                        description: |
                          De coördinaten van het punt waarbij het 1e item de
                          x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                          volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                          ```
                          RD; [92949.643, 436720.672]
                          WGS84; [4.48531, 51.915512]
                          ETRS89; [4.48531, 51.915512]
                          ```
                        example:
                        - 92949.643
                        - 436720.672
                        items:
                          type: number
                        minItems: 2
                        type: array
                      minItems: 4
                      type: array
                    type: array
                  type:
                    enum:
                    - Polygon
                    type: string
                required:
                - type
                - coordinates
                title: Vlak
                type: object
              - description: GeoJSON GeometryCollection gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.8
                  Alleen een GeometryCollection met Polygonen wordt ondersteund.
                example:
                  geometries:
                  - coordinates:
                    - - - 92879.88
                        - 436405.07
                      - - 93390.88
                        - 436893.58
                      - - 92968.36
                        - 436872.3
                      - - 92879.88
                        - 436405.07
                    - - - 92870.88
                        - 436400.07
                      - - 93390.88
                        - 436893.58
                      - - 92968.36
                        - 436872.3
                      - - 92870.88
                        - 436400.07
                    type: Polygon
                  - coordinates:
                    - - - 92879.88
                        - 436405.07
                      - - 93390.88
                        - 436893.58
                      - - 92968.36
                        - 436872.3
                      - - 92879.88
                        - 436405.07
                    - - - 92870.88
                        - 436400.07
                      - - 93390.88
                        - 436893.58
                      - - 92968.36
                        - 436872.3
                      - - 92870.88
                        - 436400.07
                    type: Polygon
                  type: GeometryCollection
                properties:
                  geometries:
                    description: De geometries van de GeometryCollection volgens https://tools.ietf.org/html/rfc7946#section-3.1.8
                    items:
                      description: GeoJSON Polygon gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                      example:
                        coordinates:
                        - - - 92879.88
                            - 436405.07
                          - - 93390.88
                            - 436893.58
                          - - 92968.36
                            - 436872.3
                          - - 92879.88
                            - 436405.07
                        - - - 92870.88
                            - 436400.07
                          - - 93390.88
                            - 436893.58
                          - - 92968.36
                            - 436872.3
                          - - 92870.88
                            - 436400.07
                        type: Polygon
                      properties:
                        coordinates:
                          description: De coördinaten van het polygoon volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                          items:
                            items:
                              description: |
                                De coördinaten van het punt waarbij het 1e item de
                                x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                                volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                                ```
                                RD; [92949.643, 436720.672]
                                WGS84; [4.48531, 51.915512]
                                ETRS89; [4.48531, 51.915512]
                                ```
                              example:
                              - 92949.643
                              - 436720.672
                              items:
                                type: number
                              minItems: 2
                              type: array
                            minItems: 4
                            type: array
                          type: array
                        type:
                          enum:
                          - Polygon
                          type: string
                      required:
                      - type
                      - coordinates
                      title: Vlak
                      type: object
                    type: array
                  type:
                    enum:
                    - GeometryCollection
                    type: string
                required:
                - type
                - geometries
                title: Vlak
                type: object
          required:
          - geometrie
          type: object
        plichtType:
          description: Het plichttype van het verzoek. Alleen maar beschikbaar vanaf
            STAM-versie '5'.
          enum:
          - Aanvraag vergunning
          - Melding
          - Informatie
          - Informatie ongewoon voorval
          - Aanvraag maatwerkvoorschrift
          - Melding gelijkwaardige maatregel
          - Aanvraag toestemming gelijkwaardige maatregel
          type: string
        verzoekType:
          description: Het type van het verzoek. Op basis van de gevraagde STAM-versie
            zal de corresponderende enumeratie  worden teruggegeven.
          enum:
          - Concept
          - Definitief
          type: string
      required:
      - verzoekType
      - doelVerzoek
      - datumIngediend
      - locatie
      - activiteit
      - bevoegdGezag
    ZoekresultaatVerzoeken:
      description: |
        Zoekresultaat van verzoeken. Bevat pagineringsinformatie en eventuele resultaten. Resultaten worden gesorteerd op verzoeknummer, nieuwste eerst.
        De geometrie van het verzoek (locatie) word teruggegeven in ETRS89 (indien anders aangegeven, middels de 'Accept-Crs' header).
      example:
        _embedded:
          verzoeken:
          - activiteit:
            - id: http://toepasbare-regels.omgevingswet.overheid.nl/werkzaamheden/id/concept/nl.imow-mnre1034.activiteit.AanbrengenLagenMetalen
              naam: Aanbrengen lagen van metalen
              urn: nl.imow-mnre1034.activiteit.AanbrengenLagenMetalen
            behandeldienst:
              naam: Behandeldienst voor Zuid-Holland
              organisatieIdentificatieNummer: "00000000000987654321"
            bevoegdGezag:
              naam: Provincie Zuid-Holland
              organisatieIdentificatieNummer: "00000000000123456789"
            datumIngediend: "2019-01-21T10:01:47.457+01:00"
            doelVerzoek: Indienen
            locatie:
              geometrie:
                coordinates:
                - 4.48549441
                - 52.07752339
                type: Point
            plichtType: Melding
            verzoekType: Definitief
            verzoeknummer: "2019012100003"
            volgnummer: "001"
        _links:
          first:
            href: https://api.dso.nl/verzoeken/_zoek?page=0
          last:
            href: https://api.dso.nl/verzoeken/_zoek?page=10
          next:
            href: https://api.dso.nl/verzoeken/_zoek?page=5
          prev:
            href: https://api.dso.nl/verzoeken/_zoek?page=3
          self:
            href: https://api.dso.nl/verzoeken/_zoek?page=4
        page:
          number: 4
          size: 20
          totalElements: 200
          totalPages: 10
      properties:
        _embedded:
          properties:
            verzoeken:
              items:
                allOf:
                - example:
                    verzoeknummer: "2017010100001"
                    volgnummer: "000"
                  properties:
                    verzoeknummer:
                      type: string
                    volgnummer:
                      type: string
                  required:
                  - verzoeknummer
                  - volgnummer
                  type: object
                description: |
                  Een verzoek item uit het zoekresultaat. Bevat basisgegevens van een verzoek.
                properties:
                  activiteit:
                    items:
                      properties:
                        id:
                          description: De 'functioneleStructuurReferentie' van de
                            activiteit.
                          type: string
                        naam:
                          description: De 'naam' van de activiteit.
                          type: string
                        subactiviteit:
                          description: een sub-activiteit. Gevuld indien er sprake
                            is van een sub-activiteit.
                          items:
                            properties:
                              id:
                                description: De 'functioneleStructuurReferentie' van
                                  de subactiviteit.
                                type: string
                              naam:
                                description: De 'naam' van de subactiviteit.
                                type: string
                              urn:
                                description: De 'urn' van de subactiviteit. Ook wel
                                  imow-id genoemd.
                                type: string
                            required:
                            - id
                            - urn
                            - naam
                            type: object
                          type: array
                        urn:
                          description: De 'urn' van de activiteit. Ook wel imow-id
                            genoemd.
                          type: string
                      required:
                      - id
                      - urn
                      - naam
                      type: object
                    type: array
                  behandeldienst:
                    example:
                      naam: Provincie Zuid-Holland
                      organisatieIdentificatieNummer: "00000000000123456789"
                    properties:
                      naam:
                        type: string
                      organisatieIdentificatieNummer:
                        pattern: ^\d{20}$
                        type: string
                    required:
                    - organisatieIdentificatieNummer
                    - naam
                    type: object
                  bevoegdGezag:
                    example:
                      naam: Provincie Zuid-Holland
                      organisatieIdentificatieNummer: "00000000000123456789"
                    properties:
                      naam:
                        type: string
                      organisatieIdentificatieNummer:
                        pattern: ^\d{20}$
                        type: string
                    required:
                    - organisatieIdentificatieNummer
                    - naam
                    type: object
                  datumIngediend:
                    format: date-time
                    type: string
                  doelVerzoek:
                    description: Het doel van het verzoek. Op basis van de gevraagde
                      STAM-versie zal de corresponderende enumeratie worden teruggegeven.
                    enum:
                    - Indienen
                    - Aanvullen
                    - Intrekken
                    type: string
                  locatie:
                    description: Locatie waar het project is uitgevoerd. De geometrie
                      van de locatie is standaard in ETRS89.
                    example:
                      geometrie:
                        coordinates:
                        - 81523.058
                        - 456081.0821
                        type: Point
                    properties:
                      geometrie:
                        description: Punt of vlak waar het project is uitgevoerd.
                        oneOf:
                        - description: GeoJSON Point gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.2
                          example:
                            coordinates:
                            - 1
                            - 2
                            type: Point
                          properties:
                            coordinates:
                              description: |
                                De coördinaten van het punt waarbij het 1e item de
                                x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                                volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                                ```
                                RD; [92949.643, 436720.672]
                                WGS84; [4.48531, 51.915512]
                                ETRS89; [4.48531, 51.915512]
                                ```
                              example:
                              - 92949.643
                              - 436720.672
                              items:
                                type: number
                              minItems: 2
                              type: array
                            type:
                              enum:
                              - Point
                              type: string
                          required:
                          - type
                          - coordinates
                          title: Punt
                          type: object
                        - description: GeoJSON Polygon gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                          example:
                            coordinates:
                            - - - 92879.88
                                - 436405.07
                              - - 93390.88
                                - 436893.58
                              - - 92968.36
                                - 436872.3
                              - - 92879.88
                                - 436405.07
                            - - - 92870.88
                                - 436400.07
                              - - 93390.88
                                - 436893.58
                              - - 92968.36
                                - 436872.3
                              - - 92870.88
                                - 436400.07
                            type: Polygon
                          properties:
                            coordinates:
                              description: De coördinaten van het polygoon volgens
                                https://tools.ietf.org/html/rfc7946#section-3.1.6
                              items:
                                items:
                                  description: |
                                    De coördinaten van het punt waarbij het 1e item de
                                    x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                                    volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                                    ```
                                    RD; [92949.643, 436720.672]
                                    WGS84; [4.48531, 51.915512]
                                    ETRS89; [4.48531, 51.915512]
                                    ```
                                  example:
                                  - 92949.643
                                  - 436720.672
                                  items:
                                    type: number
                                  minItems: 2
                                  type: array
                                minItems: 4
                                type: array
                              type: array
                            type:
                              enum:
                              - Polygon
                              type: string
                          required:
                          - type
                          - coordinates
                          title: Vlak
                          type: object
                        - description: GeoJSON GeometryCollection gespecificeerd volgens
                            https://tools.ietf.org/html/rfc7946#section-3.1.8 Alleen
                            een GeometryCollection met Polygonen wordt ondersteund.
                          example:
                            geometries:
                            - coordinates:
                              - - - 92879.88
                                  - 436405.07
                                - - 93390.88
                                  - 436893.58
                                - - 92968.36
                                  - 436872.3
                                - - 92879.88
                                  - 436405.07
                              - - - 92870.88
                                  - 436400.07
                                - - 93390.88
                                  - 436893.58
                                - - 92968.36
                                  - 436872.3
                                - - 92870.88
                                  - 436400.07
                              type: Polygon
                            - coordinates:
                              - - - 92879.88
                                  - 436405.07
                                - - 93390.88
                                  - 436893.58
                                - - 92968.36
                                  - 436872.3
                                - - 92879.88
                                  - 436405.07
                              - - - 92870.88
                                  - 436400.07
                                - - 93390.88
                                  - 436893.58
                                - - 92968.36
                                  - 436872.3
                                - - 92870.88
                                  - 436400.07
                              type: Polygon
                            type: GeometryCollection
                          properties:
                            geometries:
                              description: De geometries van de GeometryCollection
                                volgens https://tools.ietf.org/html/rfc7946#section-3.1.8
                              items:
                                description: GeoJSON Polygon gespecificeerd volgens
                                  https://tools.ietf.org/html/rfc7946#section-3.1.6
                                example:
                                  coordinates:
                                  - - - 92879.88
                                      - 436405.07
                                    - - 93390.88
                                      - 436893.58
                                    - - 92968.36
                                      - 436872.3
                                    - - 92879.88
                                      - 436405.07
                                  - - - 92870.88
                                      - 436400.07
                                    - - 93390.88
                                      - 436893.58
                                    - - 92968.36
                                      - 436872.3
                                    - - 92870.88
                                      - 436400.07
                                  type: Polygon
                                properties:
                                  coordinates:
                                    description: De coördinaten van het polygoon volgens
                                      https://tools.ietf.org/html/rfc7946#section-3.1.6
                                    items:
                                      items:
                                        description: |
                                          De coördinaten van het punt waarbij het 1e item de
                                          x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                                          volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                                          ```
                                          RD; [92949.643, 436720.672]
                                          WGS84; [4.48531, 51.915512]
                                          ETRS89; [4.48531, 51.915512]
                                          ```
                                        example:
                                        - 92949.643
                                        - 436720.672
                                        items:
                                          type: number
                                        minItems: 2
                                        type: array
                                      minItems: 4
                                      type: array
                                    type: array
                                  type:
                                    enum:
                                    - Polygon
                                    type: string
                                required:
                                - type
                                - coordinates
                                title: Vlak
                                type: object
                              type: array
                            type:
                              enum:
                              - GeometryCollection
                              type: string
                          required:
                          - type
                          - geometries
                          title: Vlak
                          type: object
                    required:
                    - geometrie
                    type: object
                  plichtType:
                    description: Het plichttype van het verzoek. Alleen maar beschikbaar
                      vanaf STAM-versie '5'.
                    enum:
                    - Aanvraag vergunning
                    - Melding
                    - Informatie
                    - Informatie ongewoon voorval
                    - Aanvraag maatwerkvoorschrift
                    - Melding gelijkwaardige maatregel
                    - Aanvraag toestemming gelijkwaardige maatregel
                    type: string
                  verzoekType:
                    description: Het type van het verzoek. Op basis van de gevraagde
                      STAM-versie zal de corresponderende enumeratie  worden teruggegeven.
                    enum:
                    - Concept
                    - Definitief
                    type: string
                required:
                - verzoekType
                - doelVerzoek
                - datumIngediend
                - locatie
                - activiteit
                - bevoegdGezag
              type: array
          required:
          - verzoeken
          type: object
        _links:
          allOf:
          - description: uri's voor het gebruik van paginering
            properties:
              first:
                allOf:
                - example:
                    href: https://api.dso.nl/verzoeken/2017010100001
                  properties:
                    href:
                      type: string
                  required:
                  - href
                description: uri voor het opvragen van de eerste pagina van deze collectie
                properties:
                  title:
                    example: Eerste pagina
                    type: string
              last:
                allOf:
                - example:
                    href: https://api.dso.nl/verzoeken/2017010100001
                  properties:
                    href:
                      type: string
                  required:
                  - href
                description: uri voor het opvragen van de laatste pagina van deze
                  collectie
                properties:
                  title:
                    example: Laatste pagina
                    type: string
              next:
                allOf:
                - example:
                    href: https://api.dso.nl/verzoeken/2017010100001
                  properties:
                    href:
                      type: string
                  required:
                  - href
                description: uri voor het opvragen van de volgende pagina van deze
                  collectie
                properties:
                  title:
                    example: Volgende pagina
                    type: string
              prev:
                allOf:
                - example:
                    href: https://api.dso.nl/verzoeken/2017010100001
                  properties:
                    href:
                      type: string
                  required:
                  - href
                description: uri voor het opvragen van de vorige pagina van deze collectie
                properties:
                  title:
                    example: Vorige pagina
                    type: string
            type: object
          properties:
            self:
              example:
                href: https://api.dso.nl/verzoeken/2017010100001
              properties:
                href:
                  type: string
              required:
              - href
        page:
          description: Informatie voor paginering.
          properties:
            number:
              example: 0
              format: int32
              type: integer
            size:
              example: 20
              format: int32
              type: integer
            totalElements:
              example: 1
              format: int32
              type: integer
            totalPages:
              example: 1
              format: int32
              type: integer
          required:
          - number
          - size
          - totalElements
          - totalPages
          type: object
      required:
      - _links
      - page
      type: object
info:
  contact:
    name: DSO Ontwikkelaarsportaal
    url: https://developer.omgevingswet.overheid.nl/services/contact/
  description: |-
    Tbv ophalen verzoek, zoeken naar verzoeken en wijzigen van het bevoegd gezag.
    Het ophalen van een ingediend verzoek (aanvraag/melding). Een verzoek kan worden opgehaald door het opgeven van het verzoeknummer. Het opgehaalde verzoek bevat referenties naar documenten (formulieren en bijlagen).
    Het zoeken naar ingediende verzoeken op basis van verschillende criteria.
    Het wijzigen van het bevoegd gezag (en eventueel behandeldienst) voor een ingediend verzoek (aanvraag/melding).
    Een verzoek kan worden verwijderd door het bevoegd gezag (of eventueel behandeldienst). Een overheidsinstantie die geïnformeerd moet worden en het verzoek ook kan ophalen, kan het verzoek markeren als gelezen (afmelden).
  title: Verzoeken-Afhandelen
  version: 3.1.2
openapi: 3.1.0
paths:
  /:
    get:
      operationId: specification
      responses:
        "200":
          content:
            application/json:
              schema:
                example: '{"openapi": "3.0.3", ... }'
          description: OpenApi Specification Json
      summary: OpenApi Specification
      tags:
      - Meta
      x-auth-type: None
  /app-health:
    get:
      operationId: app-health
      responses:
        "200":
          content:
            application/json:
              schema:
                description: Health
                example:
                  groups:
                  - downstreamServices
                  - self
                  status: UP
                properties:
                  groups:
                    items:
                      type: string
                    type: array
                  status:
                    enum:
                    - UP
                    - DOWN
                    - OUT_OF_SERVICE
                    type: string
          description: Health
        "400":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  instance: /verzoeken/_zoek
                  invalid-params:
                  - name: locatie
                    reason: Locatie is een verplicht veld
                    type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                  status: 400
                  title: Validatie mislukt
                  type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
                properties:
                  invalid-params:
                    items:
                      properties:
                        name:
                          type: string
                        reason:
                          type: string
                        type:
                          type: string
                      required:
                      - type
                      - name
                      - reason
                    type: array
          description: |-
            Validatiefout. Mogelijk foutsituaties:
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Swagger
                - De vraag voldoet niet aan de swagger specificatie.
        "401":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: U bent niet geautoriseerd voor dit verzoek.
                  instance: 539f14d69f2fba81
                  status: 401
                  title: Authenticatiegegevens ontbreken of zijn onjuist.
                  type: https://content.omgevingswet.overheid.nl/id/concept/Ongeautoriseerd
                properties:
                  detail:
                    type: string
          description: Gebruiker heeft geen toestemming om deze actie uit te voeren
        "503":
          content:
            application/json:
              schema:
                description: Health
                example:
                  groups:
                  - downstreamServices
                  - self
                  status: UP
                properties:
                  groups:
                    items:
                      type: string
                    type: array
                  status:
                    enum:
                    - UP
                    - DOWN
                    - OUT_OF_SERVICE
                    type: string
          description: Health
      summary: health info endpoint heeft een voorkeur boven de /health endpoint.
      tags:
      - Meta
  /app-info:
    get:
      operationId: app-info
      responses:
        "200":
          content:
            application/json:
              schema:
                description: Info
                example:
                  name: Verzoek afhandelen
                  stamVersion:
                  - "5"
                  - "6"
                  version: 3.1.0
                properties:
                  name:
                    type: string
                  stamVersion:
                    items:
                      type: string
                    type: array
                  version:
                    type: string
                required:
                - name
                - version
                - stamVersion
          description: Info
        "400":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  instance: /verzoeken/_zoek
                  invalid-params:
                  - name: locatie
                    reason: Locatie is een verplicht veld
                    type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                  status: 400
                  title: Validatie mislukt
                  type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
                properties:
                  invalid-params:
                    items:
                      properties:
                        name:
                          type: string
                        reason:
                          type: string
                        type:
                          type: string
                      required:
                      - type
                      - name
                      - reason
                    type: array
          description: |-
            Validatiefout. Mogelijk foutsituaties:
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Swagger
                - De vraag voldoet niet aan de swagger specificatie.
        "401":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: U bent niet geautoriseerd voor dit verzoek.
                  instance: 539f14d69f2fba81
                  status: 401
                  title: Authenticatiegegevens ontbreken of zijn onjuist.
                  type: https://content.omgevingswet.overheid.nl/id/concept/Ongeautoriseerd
                properties:
                  detail:
                    type: string
          description: Gebruiker heeft geen toestemming om deze actie uit te voeren
      summary: applicatie info endpoint heeft een voorkeur boven de /info endpoint.
      tags:
      - Meta
  /health:
    get:
      operationId: health
      responses:
        "200":
          content:
            application/json:
              schema:
                description: Health
                example:
                  groups:
                  - downstreamServices
                  - self
                  status: UP
                properties:
                  groups:
                    items:
                      type: string
                    type: array
                  status:
                    enum:
                    - UP
                    - DOWN
                    - OUT_OF_SERVICE
                    type: string
          description: Health
        "400":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  instance: /verzoeken/_zoek
                  invalid-params:
                  - name: locatie
                    reason: Locatie is een verplicht veld
                    type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                  status: 400
                  title: Validatie mislukt
                  type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
                properties:
                  invalid-params:
                    items:
                      properties:
                        name:
                          type: string
                        reason:
                          type: string
                        type:
                          type: string
                      required:
                      - type
                      - name
                      - reason
                    type: array
          description: |-
            Validatiefout. Mogelijk foutsituaties:
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Swagger
                - De vraag voldoet niet aan de swagger specificatie.
        "401":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: U bent niet geautoriseerd voor dit verzoek.
                  instance: 539f14d69f2fba81
                  status: 401
                  title: Authenticatiegegevens ontbreken of zijn onjuist.
                  type: https://content.omgevingswet.overheid.nl/id/concept/Ongeautoriseerd
                properties:
                  detail:
                    type: string
          description: Gebruiker heeft geen toestemming om deze actie uit te voeren
        "503":
          content:
            application/json:
              schema:
                description: Health
                example:
                  groups:
                  - downstreamServices
                  - self
                  status: UP
                properties:
                  groups:
                    items:
                      type: string
                    type: array
                  status:
                    enum:
                    - UP
                    - DOWN
                    - OUT_OF_SERVICE
                    type: string
          description: Health
      summary: Deprecated health info, gebruik /app-health.
      tags:
      - Meta
  /info:
    get:
      operationId: info
      responses:
        "200":
          content:
            application/json:
              schema:
                description: Info
                example:
                  name: Verzoek afhandelen
                  stamVersion:
                  - "5"
                  - "6"
                  version: 3.1.0
                properties:
                  name:
                    type: string
                  stamVersion:
                    items:
                      type: string
                    type: array
                  version:
                    type: string
                required:
                - name
                - version
                - stamVersion
          description: Info
        "400":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  instance: /verzoeken/_zoek
                  invalid-params:
                  - name: locatie
                    reason: Locatie is een verplicht veld
                    type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                  status: 400
                  title: Validatie mislukt
                  type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
                properties:
                  invalid-params:
                    items:
                      properties:
                        name:
                          type: string
                        reason:
                          type: string
                        type:
                          type: string
                      required:
                      - type
                      - name
                      - reason
                    type: array
          description: |-
            Validatiefout. Mogelijk foutsituaties:
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Swagger
                - De vraag voldoet niet aan de swagger specificatie.
        "401":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: U bent niet geautoriseerd voor dit verzoek.
                  instance: 539f14d69f2fba81
                  status: 401
                  title: Authenticatiegegevens ontbreken of zijn onjuist.
                  type: https://content.omgevingswet.overheid.nl/id/concept/Ongeautoriseerd
                properties:
                  detail:
                    type: string
          description: Gebruiker heeft geen toestemming om deze actie uit te voeren
      summary: Deprecated applicatie info, gebruik /app-info.
      tags:
      - Meta
  /verzoeken/_zoek:
    post:
      deprecated: true
      description: |-
        Het zoeken naar ingediende verzoeken op basis van de meegestuurde zoekcriteria.
        Voor de zoekresultaten kan de STAM-versie worden opgegeven door de Accept header te vullen met `application/hal+json;stam=$STAM_VERSIE$`. Indien de versie wordt ondersteund, worden de zoekresultaten opgemaakt in de gevraagde STAM-versie. Wordt er geen Accept header met een STAM-versie meegegeven, dan worden de zoekresultaten opgemaakt met veldnamen en waarden conform STAM-versie 5.
        Het zoekresultaat bevat geen informatie over verzoeken van het type 'Idee' of 'SDGverzoek', omdat deze informatie mogelijk gevoelig is, en bovendien niet van invloed zijn op de behandeling van eerder ingediende verzoeken op de betreffende locatie.
        N.B. Deze service word in een volgende versie van de API verwijderd. Gebruik hiervoor de nieuwe API 'Verzoekenoverzicht-Raadplegen'.
      operationId: zoekenVerzoeken
      parameters:
      - description: De pagina van het zoekresultaat die moet worden teruggeven.
        in: query
        name: page
        schema:
          default: 0
          example: 0
          format: int32
          type: integer
      - description: Het aantal resultaten dat per pagina moet worden teruggegeven.
        in: query
        name: size
        schema:
          default: 20
          example: 20
          format: int32
          maximum: 200
          minimum: 1
          type: integer
      - description: De EPSG code van het coordinaatstelsel van de meegegeven geometrie.
          RD of ETRS89.
        in: header
        name: Content-Crs
        schema:
          enum:
          - EPSG:28992
          - EPSG:4258
          example: EPSG:28992
          type: string
      - description: |
          De EPSG code van het coordinaatstelsel van de geometrie van het verzoek welke dient te worden teruggegeven. RD of ETRS89.
          Indien deze niet word gevuld zal ETRS89 worden gebruikt.
        in: header
        name: Accept-Crs
        schema:
          default: EPSG:4258
          enum:
          - EPSG:28992
          - EPSG:4258
          example: EPSG:28992
          type: string
      - description: Via de accept header kan de STAM-versie worden aangegeven middels
          een extra argument van het media type, bijvoorbeeld `application/xml;stam=5`
          of `application/hal+json;stam=6`. Ondersteunende STAM versies zijn 5 en
          6.
        in: header
        name: Accept
        required: false
        schema:
          example: application/xml;stam=6
          type: string
      requestBody:
        content:
          application/json:
            schema:
              description: |
                Zoekcriteria voor het zoeken naar ingediende verzoeken. Het VerzoekenZoekcriteria-object bevat of verzoeknummer of geometrie.
                Wanneer met het VerzoekenZoekcriteria-object wordt gezocht, retourneert de zoekopdracht de verzoeken waarvan de projectlocatie op of binnen de gegeven geometrie vallen.
              example:
                activiteit: nl.imow-mnre1034.activiteit.AanbrengenLagenMetalen
                eindDatumIngediendOp: "2021-05-20"
                geometrie:
                  coordinates:
                  - 81523.058
                  - 456081.0821
                  type: Point
                startDatumIngediendOp: "2021-01-20"
                verzoeknummer: "2019012100003"
              properties:
                activiteit:
                  description: |
                    Een zoekcriteriaparameter die aangeeft voor welke activiteit een verzoek is ingediend.
                    Deze parameter dient gevuld te worden met de 'urn' van een activiteit. Ook wel imow-id genoemd.
                  example: nl.imow-mnre1034.activiteit.AanbrengenLagenMetalen
                  type: string
                eindDatumIngediendOp:
                  description: |
                    Een zoekcriteriaparameter die aangeeft dat verzoeken zijn ingediend tot en met deze datum.
                  example: "2021-01-20"
                  format: date
                  type: string
                geometrie:
                  description: |
                    Punt of vlak waarop/waarbinnen de projectlocaties van de verzoeken moeten vallen.
                    Indien deze parameter is gevuld, kan er geen verzoeknummer worden opgegeven in de zoekcriteria.
                  example:
                    coordinates:
                    - 81523.058
                    - 456081.0821
                    type: Point
                  oneOf:
                  - description: GeoJSON Point gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.2
                    example:
                      coordinates:
                      - 1
                      - 2
                      type: Point
                    properties:
                      coordinates:
                        description: |
                          De coördinaten van het punt waarbij het 1e item de
                          x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                          volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                          ```
                          RD; [92949.643, 436720.672]
                          WGS84; [4.48531, 51.915512]
                          ETRS89; [4.48531, 51.915512]
                          ```
                        example:
                        - 92949.643
                        - 436720.672
                        items:
                          type: number
                        minItems: 2
                        type: array
                      type:
                        enum:
                        - Point
                        type: string
                    required:
                    - type
                    - coordinates
                    title: Punt
                    type: object
                  - description: GeoJSON Polygon gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                    example:
                      coordinates:
                      - - - 92879.88
                          - 436405.07
                        - - 93390.88
                          - 436893.58
                        - - 92968.36
                          - 436872.3
                        - - 92879.88
                          - 436405.07
                      - - - 92870.88
                          - 436400.07
                        - - 93390.88
                          - 436893.58
                        - - 92968.36
                          - 436872.3
                        - - 92870.88
                          - 436400.07
                      type: Polygon
                    properties:
                      coordinates:
                        description: De coördinaten van het polygoon volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                        items:
                          items:
                            description: |
                              De coördinaten van het punt waarbij het 1e item de
                              x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                              volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                              ```
                              RD; [92949.643, 436720.672]
                              WGS84; [4.48531, 51.915512]
                              ETRS89; [4.48531, 51.915512]
                              ```
                            example:
                            - 92949.643
                            - 436720.672
                            items:
                              type: number
                            minItems: 2
                            type: array
                          minItems: 4
                          type: array
                        type: array
                      type:
                        enum:
                        - Polygon
                        type: string
                    required:
                    - type
                    - coordinates
                    title: Vlak
                    type: object
                  - description: GeoJSON GeometryCollection gespecificeerd volgens
                      https://tools.ietf.org/html/rfc7946#section-3.1.8 Alleen een
                      GeometryCollection met Polygonen wordt ondersteund.
                    example:
                      geometries:
                      - coordinates:
                        - - - 92879.88
                            - 436405.07
                          - - 93390.88
                            - 436893.58
                          - - 92968.36
                            - 436872.3
                          - - 92879.88
                            - 436405.07
                        - - - 92870.88
                            - 436400.07
                          - - 93390.88
                            - 436893.58
                          - - 92968.36
                            - 436872.3
                          - - 92870.88
                            - 436400.07
                        type: Polygon
                      - coordinates:
                        - - - 92879.88
                            - 436405.07
                          - - 93390.88
                            - 436893.58
                          - - 92968.36
                            - 436872.3
                          - - 92879.88
                            - 436405.07
                        - - - 92870.88
                            - 436400.07
                          - - 93390.88
                            - 436893.58
                          - - 92968.36
                            - 436872.3
                          - - 92870.88
                            - 436400.07
                        type: Polygon
                      type: GeometryCollection
                    properties:
                      geometries:
                        description: De geometries van de GeometryCollection volgens
                          https://tools.ietf.org/html/rfc7946#section-3.1.8
                        items:
                          description: GeoJSON Polygon gespecificeerd volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                          example:
                            coordinates:
                            - - - 92879.88
                                - 436405.07
                              - - 93390.88
                                - 436893.58
                              - - 92968.36
                                - 436872.3
                              - - 92879.88
                                - 436405.07
                            - - - 92870.88
                                - 436400.07
                              - - 93390.88
                                - 436893.58
                              - - 92968.36
                                - 436872.3
                              - - 92870.88
                                - 436400.07
                            type: Polygon
                          properties:
                            coordinates:
                              description: De coördinaten van het polygoon volgens
                                https://tools.ietf.org/html/rfc7946#section-3.1.6
                              items:
                                items:
                                  description: |
                                    De coördinaten van het punt waarbij het 1e item de
                                    x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                                    volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                                    ```
                                    RD; [92949.643, 436720.672]
                                    WGS84; [4.48531, 51.915512]
                                    ETRS89; [4.48531, 51.915512]
                                    ```
                                  example:
                                  - 92949.643
                                  - 436720.672
                                  items:
                                    type: number
                                  minItems: 2
                                  type: array
                                minItems: 4
                                type: array
                              type: array
                            type:
                              enum:
                              - Polygon
                              type: string
                          required:
                          - type
                          - coordinates
                          title: Vlak
                          type: object
                        type: array
                      type:
                        enum:
                        - GeometryCollection
                        type: string
                    required:
                    - type
                    - geometries
                    title: Vlak
                    type: object
                startDatumIngediendOp:
                  description: |
                    Een zoekcriteriaparameter die aangeeft dat verzoeken zijn ingediend op of na deze datum.
                  example: "2021-01-20"
                  format: date
                  type: string
                verzoeknummer:
                  description: |
                    Het verzoeknummer van het ingediende verzoek wat dient als basis voor het zoeken naar verzoeken.
                    De projectlocatie van het verzoek word gebruikt om te zoeken naar andere verzoeken die binnen de projectlocatie vallen.
                    Indien deze parameter is gevuld, kan er geen geometrie worden opgegeven in de zoekcriteria.
                  example: "2019012100003"
                  maxLength: 13
                  type: string
              type: object
        description: Zoekcriteria verzoeken
        required: true
      responses:
        "200":
          content:
            application/hal+json:
              schema:
                description: |
                  Zoekresultaat van verzoeken. Bevat pagineringsinformatie en eventuele resultaten. Resultaten worden gesorteerd op verzoeknummer, nieuwste eerst.
                  De geometrie van het verzoek (locatie) word teruggegeven in ETRS89 (indien anders aangegeven, middels de 'Accept-Crs' header).
                example:
                  _embedded:
                    verzoeken:
                    - activiteit:
                      - id: http://toepasbare-regels.omgevingswet.overheid.nl/werkzaamheden/id/concept/nl.imow-mnre1034.activiteit.AanbrengenLagenMetalen
                        naam: Aanbrengen lagen van metalen
                        urn: nl.imow-mnre1034.activiteit.AanbrengenLagenMetalen
                      behandeldienst:
                        naam: Behandeldienst voor Zuid-Holland
                        organisatieIdentificatieNummer: "00000000000987654321"
                      bevoegdGezag:
                        naam: Provincie Zuid-Holland
                        organisatieIdentificatieNummer: "00000000000123456789"
                      datumIngediend: "2019-01-21T10:01:47.457+01:00"
                      doelVerzoek: Indienen
                      locatie:
                        geometrie:
                          coordinates:
                          - 4.48549441
                          - 52.07752339
                          type: Point
                      plichtType: Melding
                      verzoekType: Definitief
                      verzoeknummer: "2019012100003"
                      volgnummer: "001"
                  _links:
                    first:
                      href: https://api.dso.nl/verzoeken/_zoek?page=0
                    last:
                      href: https://api.dso.nl/verzoeken/_zoek?page=10
                    next:
                      href: https://api.dso.nl/verzoeken/_zoek?page=5
                    prev:
                      href: https://api.dso.nl/verzoeken/_zoek?page=3
                    self:
                      href: https://api.dso.nl/verzoeken/_zoek?page=4
                  page:
                    number: 4
                    size: 20
                    totalElements: 200
                    totalPages: 10
                properties:
                  _embedded:
                    properties:
                      verzoeken:
                        items:
                          allOf:
                          - example:
                              verzoeknummer: "2017010100001"
                              volgnummer: "000"
                            properties:
                              verzoeknummer:
                                type: string
                              volgnummer:
                                type: string
                            required:
                            - verzoeknummer
                            - volgnummer
                            type: object
                          description: |
                            Een verzoek item uit het zoekresultaat. Bevat basisgegevens van een verzoek.
                          properties:
                            activiteit:
                              items:
                                properties:
                                  id:
                                    description: De 'functioneleStructuurReferentie'
                                      van de activiteit.
                                    type: string
                                  naam:
                                    description: De 'naam' van de activiteit.
                                    type: string
                                  subactiviteit:
                                    description: een sub-activiteit. Gevuld indien
                                      er sprake is van een sub-activiteit.
                                    items:
                                      properties:
                                        id:
                                          description: De 'functioneleStructuurReferentie'
                                            van de subactiviteit.
                                          type: string
                                        naam:
                                          description: De 'naam' van de subactiviteit.
                                          type: string
                                        urn:
                                          description: De 'urn' van de subactiviteit.
                                            Ook wel imow-id genoemd.
                                          type: string
                                      required:
                                      - id
                                      - urn
                                      - naam
                                      type: object
                                    type: array
                                  urn:
                                    description: De 'urn' van de activiteit. Ook wel
                                      imow-id genoemd.
                                    type: string
                                required:
                                - id
                                - urn
                                - naam
                                type: object
                              type: array
                            behandeldienst:
                              example:
                                naam: Provincie Zuid-Holland
                                organisatieIdentificatieNummer: "00000000000123456789"
                              properties:
                                naam:
                                  type: string
                                organisatieIdentificatieNummer:
                                  pattern: ^\d{20}$
                                  type: string
                              required:
                              - organisatieIdentificatieNummer
                              - naam
                              type: object
                            bevoegdGezag:
                              example:
                                naam: Provincie Zuid-Holland
                                organisatieIdentificatieNummer: "00000000000123456789"
                              properties:
                                naam:
                                  type: string
                                organisatieIdentificatieNummer:
                                  pattern: ^\d{20}$
                                  type: string
                              required:
                              - organisatieIdentificatieNummer
                              - naam
                              type: object
                            datumIngediend:
                              format: date-time
                              type: string
                            doelVerzoek:
                              description: Het doel van het verzoek. Op basis van
                                de gevraagde STAM-versie zal de corresponderende enumeratie
                                worden teruggegeven.
                              enum:
                              - Indienen
                              - Aanvullen
                              - Intrekken
                              type: string
                            locatie:
                              description: Locatie waar het project is uitgevoerd.
                                De geometrie van de locatie is standaard in ETRS89.
                              example:
                                geometrie:
                                  coordinates:
                                  - 81523.058
                                  - 456081.0821
                                  type: Point
                              properties:
                                geometrie:
                                  description: Punt of vlak waar het project is uitgevoerd.
                                  oneOf:
                                  - description: GeoJSON Point gespecificeerd volgens
                                      https://tools.ietf.org/html/rfc7946#section-3.1.2
                                    example:
                                      coordinates:
                                      - 1
                                      - 2
                                      type: Point
                                    properties:
                                      coordinates:
                                        description: |
                                          De coördinaten van het punt waarbij het 1e item de
                                          x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                                          volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                                          ```
                                          RD; [92949.643, 436720.672]
                                          WGS84; [4.48531, 51.915512]
                                          ETRS89; [4.48531, 51.915512]
                                          ```
                                        example:
                                        - 92949.643
                                        - 436720.672
                                        items:
                                          type: number
                                        minItems: 2
                                        type: array
                                      type:
                                        enum:
                                        - Point
                                        type: string
                                    required:
                                    - type
                                    - coordinates
                                    title: Punt
                                    type: object
                                  - description: GeoJSON Polygon gespecificeerd volgens
                                      https://tools.ietf.org/html/rfc7946#section-3.1.6
                                    example:
                                      coordinates:
                                      - - - 92879.88
                                          - 436405.07
                                        - - 93390.88
                                          - 436893.58
                                        - - 92968.36
                                          - 436872.3
                                        - - 92879.88
                                          - 436405.07
                                      - - - 92870.88
                                          - 436400.07
                                        - - 93390.88
                                          - 436893.58
                                        - - 92968.36
                                          - 436872.3
                                        - - 92870.88
                                          - 436400.07
                                      type: Polygon
                                    properties:
                                      coordinates:
                                        description: De coördinaten van het polygoon
                                          volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                                        items:
                                          items:
                                            description: |
                                              De coördinaten van het punt waarbij het 1e item de
                                              x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                                              volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                                              ```
                                              RD; [92949.643, 436720.672]
                                              WGS84; [4.48531, 51.915512]
                                              ETRS89; [4.48531, 51.915512]
                                              ```
                                            example:
                                            - 92949.643
                                            - 436720.672
                                            items:
                                              type: number
                                            minItems: 2
                                            type: array
                                          minItems: 4
                                          type: array
                                        type: array
                                      type:
                                        enum:
                                        - Polygon
                                        type: string
                                    required:
                                    - type
                                    - coordinates
                                    title: Vlak
                                    type: object
                                  - description: GeoJSON GeometryCollection gespecificeerd
                                      volgens https://tools.ietf.org/html/rfc7946#section-3.1.8
                                      Alleen een GeometryCollection met Polygonen
                                      wordt ondersteund.
                                    example:
                                      geometries:
                                      - coordinates:
                                        - - - 92879.88
                                            - 436405.07
                                          - - 93390.88
                                            - 436893.58
                                          - - 92968.36
                                            - 436872.3
                                          - - 92879.88
                                            - 436405.07
                                        - - - 92870.88
                                            - 436400.07
                                          - - 93390.88
                                            - 436893.58
                                          - - 92968.36
                                            - 436872.3
                                          - - 92870.88
                                            - 436400.07
                                        type: Polygon
                                      - coordinates:
                                        - - - 92879.88
                                            - 436405.07
                                          - - 93390.88
                                            - 436893.58
                                          - - 92968.36
                                            - 436872.3
                                          - - 92879.88
                                            - 436405.07
                                        - - - 92870.88
                                            - 436400.07
                                          - - 93390.88
                                            - 436893.58
                                          - - 92968.36
                                            - 436872.3
                                          - - 92870.88
                                            - 436400.07
                                        type: Polygon
                                      type: GeometryCollection
                                    properties:
                                      geometries:
                                        description: De geometries van de GeometryCollection
                                          volgens https://tools.ietf.org/html/rfc7946#section-3.1.8
                                        items:
                                          description: GeoJSON Polygon gespecificeerd
                                            volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                                          example:
                                            coordinates:
                                            - - - 92879.88
                                                - 436405.07
                                              - - 93390.88
                                                - 436893.58
                                              - - 92968.36
                                                - 436872.3
                                              - - 92879.88
                                                - 436405.07
                                            - - - 92870.88
                                                - 436400.07
                                              - - 93390.88
                                                - 436893.58
                                              - - 92968.36
                                                - 436872.3
                                              - - 92870.88
                                                - 436400.07
                                            type: Polygon
                                          properties:
                                            coordinates:
                                              description: De coördinaten van het
                                                polygoon volgens https://tools.ietf.org/html/rfc7946#section-3.1.6
                                              items:
                                                items:
                                                  description: |
                                                    De coördinaten van het punt waarbij het 1e item de
                                                    x-coördinaat (longitude) is en het 2e item de y-coördinaat (latitude), gespecificeerd
                                                    volgens https://tools.ietf.org/html/rfc7946#section-3.1.1

                                                    ```
                                                    RD; [92949.643, 436720.672]
                                                    WGS84; [4.48531, 51.915512]
                                                    ETRS89; [4.48531, 51.915512]
                                                    ```
                                                  example:
                                                  - 92949.643
                                                  - 436720.672
                                                  items:
                                                    type: number
                                                  minItems: 2
                                                  type: array
                                                minItems: 4
                                                type: array
                                              type: array
                                            type:
                                              enum:
                                              - Polygon
                                              type: string
                                          required:
                                          - type
                                          - coordinates
                                          title: Vlak
                                          type: object
                                        type: array
                                      type:
                                        enum:
                                        - GeometryCollection
                                        type: string
                                    required:
                                    - type
                                    - geometries
                                    title: Vlak
                                    type: object
                              required:
                              - geometrie
                              type: object
                            plichtType:
                              description: Het plichttype van het verzoek. Alleen
                                maar beschikbaar vanaf STAM-versie '5'.
                              enum:
                              - Aanvraag vergunning
                              - Melding
                              - Informatie
                              - Informatie ongewoon voorval
                              - Aanvraag maatwerkvoorschrift
                              - Melding gelijkwaardige maatregel
                              - Aanvraag toestemming gelijkwaardige maatregel
                              type: string
                            verzoekType:
                              description: Het type van het verzoek. Op basis van
                                de gevraagde STAM-versie zal de corresponderende enumeratie  worden
                                teruggegeven.
                              enum:
                              - Concept
                              - Definitief
                              type: string
                          required:
                          - verzoekType
                          - doelVerzoek
                          - datumIngediend
                          - locatie
                          - activiteit
                          - bevoegdGezag
                        type: array
                    required:
                    - verzoeken
                    type: object
                  _links:
                    allOf:
                    - description: uri's voor het gebruik van paginering
                      properties:
                        first:
                          allOf:
                          - example:
                              href: https://api.dso.nl/verzoeken/2017010100001
                            properties:
                              href:
                                type: string
                            required:
                            - href
                          description: uri voor het opvragen van de eerste pagina
                            van deze collectie
                          properties:
                            title:
                              example: Eerste pagina
                              type: string
                        last:
                          allOf:
                          - example:
                              href: https://api.dso.nl/verzoeken/2017010100001
                            properties:
                              href:
                                type: string
                            required:
                            - href
                          description: uri voor het opvragen van de laatste pagina
                            van deze collectie
                          properties:
                            title:
                              example: Laatste pagina
                              type: string
                        next:
                          allOf:
                          - example:
                              href: https://api.dso.nl/verzoeken/2017010100001
                            properties:
                              href:
                                type: string
                            required:
                            - href
                          description: uri voor het opvragen van de volgende pagina
                            van deze collectie
                          properties:
                            title:
                              example: Volgende pagina
                              type: string
                        prev:
                          allOf:
                          - example:
                              href: https://api.dso.nl/verzoeken/2017010100001
                            properties:
                              href:
                                type: string
                            required:
                            - href
                          description: uri voor het opvragen van de vorige pagina
                            van deze collectie
                          properties:
                            title:
                              example: Vorige pagina
                              type: string
                      type: object
                    properties:
                      self:
                        example:
                          href: https://api.dso.nl/verzoeken/2017010100001
                        properties:
                          href:
                            type: string
                        required:
                        - href
                  page:
                    description: Informatie voor paginering.
                    properties:
                      number:
                        example: 0
                        format: int32
                        type: integer
                      size:
                        example: 20
                        format: int32
                        type: integer
                      totalElements:
                        example: 1
                        format: int32
                        type: integer
                      totalPages:
                        example: 1
                        format: int32
                        type: integer
                    required:
                    - number
                    - size
                    - totalElements
                    - totalPages
                    type: object
                required:
                - _links
                - page
                type: object
          description: Zoekresultaat verzoeken
        "400":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  instance: /verzoeken/_zoek
                  invalid-params:
                  - name: locatie
                    reason: Locatie is een verplicht veld
                    type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                  status: 400
                  title: Validatie mislukt
                  type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
                properties:
                  invalid-params:
                    items:
                      properties:
                        name:
                          type: string
                        reason:
                          type: string
                        type:
                          type: string
                      required:
                      - type
                      - name
                      - reason
                    type: array
          description: |-
            Validatiefout. Mogelijk foutsituaties:
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Verplicht
                - Locatie is niet gevuld. Of een locatie (zoekcriteria) of een verzoeknummer. Geen gevuld of beide gevuld is niet toegestaan.
                - Verzoeknummer is niet gevuld. Initiatiefnemer is gevuld, maar er is geen verzoeknummer gevuld.
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                - De opgegeven geometrie (locatie) valt niet binnen Nederland.
              - Het opgegeven verzoeknummer is niet correct of bestaat niet.
              - De opgegeven activiteit is niet correct of bestaat niet.
              - De opgegeven periode (startdatum en einddatum) is niet correct.
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Swagger
                - De zoekvraag voldoet niet aan de swagger specificatie.
        "500":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Er is iets mis gegaan.
                  instance: 539f14d69f2fba81
                  status: 500
                  title: Interne serverfout
                  type: https://content.omgevingswet.overheid.nl/id/concept/ServerFout
                properties:
                  detail:
                    type: string
          description: Interne serverfout
      summary: Zoeken naar ingediende verzoeken.
      tags:
      - Verzoeken
  /verzoeken/{verzoeknummer}:
    delete:
      description: Verwijdert het verzoek met opgegeven 'verzoeknummer' inclusief
        alle bijbehorende documenten. Nadat het verzoek is verwijderd kan het verzoek
        niet meer worden opgehaald.
      operationId: verwijderVerzoek
      parameters:
      - description: nummer van het verzoek
        in: path
        name: verzoeknummer
        required: true
        schema:
          example: "2019090600002"
          maxLength: 13
          type: string
      responses:
        "204":
          description: Verzoek verwijderd
        "400":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  instance: /verzoeken/_zoek
                  invalid-params:
                  - name: locatie
                    reason: Locatie is een verplicht veld
                    type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                  status: 400
                  title: Validatie mislukt
                  type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
                properties:
                  invalid-params:
                    items:
                      properties:
                        name:
                          type: string
                        reason:
                          type: string
                        type:
                          type: string
                      required:
                      - type
                      - name
                      - reason
                    type: array
          description: |-
            Validatiefout. Mogelijk foutsituaties:
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Swagger
                - De vraag voldoet niet aan de swagger specificatie.
        "401":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: U bent niet geautoriseerd voor dit verzoek.
                  instance: 539f14d69f2fba81
                  status: 401
                  title: Authenticatiegegevens ontbreken of zijn onjuist.
                  type: https://content.omgevingswet.overheid.nl/id/concept/Ongeautoriseerd
                properties:
                  detail:
                    type: string
          description: Gebruiker heeft geen toestemming om deze actie uit te voeren
        "404":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Verzoek niet gevonden.
                  instance: 539f14d69f2fba81
                  status: 404
                  title: Niet gevonden.
                  type: https://content.omgevingswet.overheid.nl/id/concept/BestaatNiet
                properties:
                  detail:
                    type: string
          description: Verzoek niet gevonden
        "500":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Er is iets mis gegaan.
                  instance: 539f14d69f2fba81
                  status: 500
                  title: Interne serverfout
                  type: https://content.omgevingswet.overheid.nl/id/concept/ServerFout
                properties:
                  detail:
                    type: string
          description: Interne serverfout
      summary: Verwijdert het verzoek.
      tags:
      - Verzoeken
    get:
      description: Haalt een ingediend verzoek op met opgegeven 'verzoeknummer'.
      operationId: haalVerzoekOp
      parameters:
      - description: nummer van het verzoek
        in: path
        name: verzoeknummer
        required: true
        schema:
          example: "2019090600002"
          maxLength: 13
          type: string
      responses:
        "200":
          content:
            application/hal+json:
              schema:
                allOf:
                - example:
                    verzoeknummer: "2017010100001"
                    volgnummer: "000"
                  properties:
                    verzoeknummer:
                      type: string
                    volgnummer:
                      type: string
                  required:
                  - verzoeknummer
                  - volgnummer
                  type: object
                description: |
                  Resultaat van het ophalen van een verzoek. Bevat basisgegevens van een verzoek en de eventuele gekoppelde documenten.
                example:
                  _embedded:
                    documenten:
                    - _links:
                        content:
                          href: https://api.dso.nl/verzoeken/2017010100001/documenten/51c4275449f3760f9cabad9e6c1478764e19be6802a900b188248b068403f912/content
                        self:
                          href: https://api.dso.nl/verzoeken/2017010100001/documenten/51c4275449f3760f9cabad9e6c1478764e19be6802a900b188248b068403f912
                      documentId: 51c4275449f3760f9cabad9e6c1478764e19be6802a900b188248b068403f912
                      metadata:
                        bestandsnaam: Tekening_van_de_uitbouw.pdf
                        documentOmschrijving: Overig
                        formaat: application/pdf
                        vertrouwelijkAanduiding: Vertrouwelijk
                  _links:
                    self:
                      href: https://api.dso.nl/verzoeken/2017010100001
                    verzoekPdf:
                      href: https://api.dso.nl/verzoeken/2017010100001/samenvatting?format=pdf
                    verzoekXml:
                      href: https://api.dso.nl/verzoeken/2017010100001/samenvatting?format=xml
                  verzoeknummer: "2017010100001"
                  volgnummer: "000"
                properties:
                  _embedded:
                    properties:
                      documenten:
                        items:
                          example:
                            _links:
                              content:
                                href: https://api.dso.nl/verzoeken/2017010100001/documenten/1/content
                              self:
                                href: https://api.dso.nl/verzoeken/2017010100001/documenten/1
                            documentId: 51c4275449f3760f9cabad9e6c1478764e19be6802a900b188248b068403f912
                            metadata:
                              bestandsnaam: Tekening_van_de_uitbouw.pdf
                              documentOmschrijving: Overig
                              formaat: application/pdf
                              vertrouwelijkAanduiding: Vertrouwelijk
                          properties:
                            _links:
                              properties:
                                content:
                                  example:
                                    href: https://api.dso.nl/verzoeken/2017010100001
                                  properties:
                                    href:
                                      type: string
                                  required:
                                  - href
                                self:
                                  example:
                                    href: https://api.dso.nl/verzoeken/2017010100001
                                  properties:
                                    href:
                                      type: string
                                  required:
                                  - href
                              type: object
                            documentId:
                              maxLength: 128
                              type: string
                            id:
                              type: integer
                            metadata:
                              description: metadata
                              properties:
                                bestandsnaam:
                                  type: string
                                documentOmschrijving:
                                  description: aanduiding van de aard van de gevraagde
                                    bijlage zoals gehanteerd door de zaakbehandelende
                                    organisatie, gebaseerd op 'documenttypeGeneriek'.
                                    Bevat een lege string als de documentOmschrijving
                                    niet bekend is.
                                  type: string
                                formaat:
                                  description: het MIME-type
                                  type: string
                                vertrouwelijkAanduiding:
                                  description: geeft aan of het document als vertrouwelijk
                                    moet worden behandeld.
                                  enum:
                                  - Vertrouwelijk
                                  - Niet vertrouwelijk
                                  type: string
                              required:
                              - bestandsnaam
                              - vertrouwelijkAanduiding
                              - documentOmschrijving
                              - formaat
                              type: object
                          required:
                          - id
                          - documentId
                          - metadata
                          type: object
                        type: array
                    type: object
                  _links:
                    properties:
                      self:
                        example:
                          href: https://api.dso.nl/verzoeken/2017010100001
                        properties:
                          href:
                            type: string
                        required:
                        - href
                      verzoekPdf:
                        example:
                          href: https://api.dso.nl/verzoeken/2017010100001
                        properties:
                          href:
                            type: string
                        required:
                        - href
                      verzoekXml:
                        example:
                          href: https://api.dso.nl/verzoeken/2017010100001
                        properties:
                          href:
                            type: string
                        required:
                        - href
                    type: object
                required:
                - _links
          description: Het verzoek
        "400":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  instance: /verzoeken/_zoek
                  invalid-params:
                  - name: locatie
                    reason: Locatie is een verplicht veld
                    type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                  status: 400
                  title: Validatie mislukt
                  type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
                properties:
                  invalid-params:
                    items:
                      properties:
                        name:
                          type: string
                        reason:
                          type: string
                        type:
                          type: string
                      required:
                      - type
                      - name
                      - reason
                    type: array
          description: |-
            Validatiefout. Mogelijk foutsituaties:
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Swagger
                - De vraag voldoet niet aan de swagger specificatie.
        "401":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: U bent niet geautoriseerd voor dit verzoek.
                  instance: 539f14d69f2fba81
                  status: 401
                  title: Authenticatiegegevens ontbreken of zijn onjuist.
                  type: https://content.omgevingswet.overheid.nl/id/concept/Ongeautoriseerd
                properties:
                  detail:
                    type: string
          description: Gebruiker heeft geen toestemming om deze actie uit te voeren
        "404":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Verzoek niet gevonden.
                  instance: 539f14d69f2fba81
                  status: 404
                  title: Niet gevonden.
                  type: https://content.omgevingswet.overheid.nl/id/concept/BestaatNiet
                properties:
                  detail:
                    type: string
          description: Verzoek niet gevonden
        "500":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Er is iets mis gegaan.
                  instance: 539f14d69f2fba81
                  status: 500
                  title: Interne serverfout
                  type: https://content.omgevingswet.overheid.nl/id/concept/ServerFout
                properties:
                  detail:
                    type: string
          description: Interne serverfout
      summary: Haalt een verzoek op.
      tags:
      - Verzoeken
  /verzoeken/{verzoeknummer}/afmelden:
    patch:
      description: Markeert het verzoek als gelezen/opgehaald door een geïnformeerde
        instantie. Hiermee geeft de geïnformeerde instantie aan dat het verzoek verwijderd
        kan worden. Hierna kan het verzoek niet meer worden opgehaald door de geïnformeerde
        instantie. Welke instantie geïnformeerd moet worden over welk verzoek is bepaald
        door specifieke  DSO configuratie, die is gebaseerd op wetgeving.
      operationId: afmeldenVerzoek
      parameters:
      - description: nummer van het verzoek
        in: path
        name: verzoeknummer
        required: true
        schema:
          example: "2019090600002"
          maxLength: 13
          type: string
      responses:
        "204":
          description: Verzoek afgemeld
        "400":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  instance: /verzoeken/_zoek
                  invalid-params:
                  - name: locatie
                    reason: Locatie is een verplicht veld
                    type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                  status: 400
                  title: Validatie mislukt
                  type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
                properties:
                  invalid-params:
                    items:
                      properties:
                        name:
                          type: string
                        reason:
                          type: string
                        type:
                          type: string
                      required:
                      - type
                      - name
                      - reason
                    type: array
          description: |-
            Validatiefout. Mogelijk foutsituaties:
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Swagger
                - De vraag voldoet niet aan de swagger specificatie.
        "401":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: U bent niet geautoriseerd voor dit verzoek.
                  instance: 539f14d69f2fba81
                  status: 401
                  title: Authenticatiegegevens ontbreken of zijn onjuist.
                  type: https://content.omgevingswet.overheid.nl/id/concept/Ongeautoriseerd
                properties:
                  detail:
                    type: string
          description: Gebruiker heeft geen toestemming om deze actie uit te voeren
        "404":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Verzoek niet gevonden.
                  instance: 539f14d69f2fba81
                  status: 404
                  title: Niet gevonden.
                  type: https://content.omgevingswet.overheid.nl/id/concept/BestaatNiet
                properties:
                  detail:
                    type: string
          description: Verzoek niet gevonden
        "500":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Er is iets mis gegaan.
                  instance: 539f14d69f2fba81
                  status: 500
                  title: Interne serverfout
                  type: https://content.omgevingswet.overheid.nl/id/concept/ServerFout
                properties:
                  detail:
                    type: string
          description: Interne serverfout
      summary: Afmelden van een verzoek.
      tags:
      - Verzoeken
  /verzoeken/{verzoeknummer}/bevoegdgezagen:
    patch:
      description: Het wijzigen van een bevoegd gezag voor een verzoek op basis van
        de meegestuurde gegevens.
      operationId: wijzigenBevoegdGezag
      parameters:
      - description: nummer van het verzoek
        in: path
        name: verzoeknummer
        required: true
        schema:
          example: "2019090600002"
          maxLength: 13
          type: string
      requestBody:
        content:
          application/json:
            schema:
              example:
                organisatieIdentificatieNummer: "00000000000123456789"
              properties:
                organisatieIdentificatieNummer:
                  pattern: ^\d{20}$
                  type: string
              required:
              - organisatieIdentificatieNummer
              type: object
        description: Nieuwe OIN van het BevoegdGezag.
        required: true
      responses:
        "204":
          description: Wijzigen geslaagd
        "400":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  instance: /verzoeken/_zoek
                  invalid-params:
                  - name: locatie
                    reason: Locatie is een verplicht veld
                    type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                  status: 400
                  title: Validatie mislukt
                  type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
                properties:
                  invalid-params:
                    items:
                      properties:
                        name:
                          type: string
                        reason:
                          type: string
                        type:
                          type: string
                      required:
                      - type
                      - name
                      - reason
                    type: array
          description: |-
            Validatiefout. Mogelijk foutsituaties:
              - Het OIN van het nieuwe bevoegd gezag is niet correct
              - Het OIN is niet van een bevoegd gezag. Geef een geldig OIN van een bevoegd gezag op.
              - Het nieuwe bevoegd gezag accepteert geen Conceptverzoek
              - Het verzoek is ingetrokken
              - Het verzoek is van het type 'Idee' en het opgegeven bevoegd gezag staat geen 'Idee' toe.
              - Het verzoek is van het type 'SDGverzoek' en het opgegeven bevoegd gezag ondersteunt 'SDGverzoek' niet.
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Swagger
                - De wijziging voldoet niet aan de swagger specificatie.
        "401":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: U bent niet geautoriseerd voor dit verzoek.
                  instance: 539f14d69f2fba81
                  status: 401
                  title: Authenticatiegegevens ontbreken of zijn onjuist.
                  type: https://content.omgevingswet.overheid.nl/id/concept/Ongeautoriseerd
                properties:
                  detail:
                    type: string
          description: Gebruiker heeft geen toestemming om deze actie uit te voeren
        "404":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Verzoek niet gevonden.
                  instance: 539f14d69f2fba81
                  status: 404
                  title: Niet gevonden.
                  type: https://content.omgevingswet.overheid.nl/id/concept/BestaatNiet
                properties:
                  detail:
                    type: string
          description: Het verzoek bestaat niet
        "409":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Probeer het later nog eens, nadat de aanvulling is verwerkt.
                  instance: 539f14d69f2fba81
                  status: 409
                  title: Conflict
                  type: https://content.omgevingswet.overheid.nl/id/concept/Conflict
                properties:
                  detail:
                    type: string
          description: Probeer het later nog eens, nadat de aanvulling is verwerkt.
        "500":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Er is iets mis gegaan.
                  instance: 539f14d69f2fba81
                  status: 500
                  title: Interne serverfout
                  type: https://content.omgevingswet.overheid.nl/id/concept/ServerFout
                properties:
                  detail:
                    type: string
          description: Interne serverfout
      summary: Wijzigen van het bevoegd gezag bij een verzoek.
      tags:
      - Verzoeken
    put:
      description: Het wijzigen of verwijderen van de behandeldienst en eventueel
        wijzigen van het bevoegd gezag voor een verzoek op basis van de meegestuurde
        gegevens.
      operationId: wijzigenBehandeldienst
      parameters:
      - description: nummer van het verzoek
        in: path
        name: verzoeknummer
        required: true
        schema:
          example: "2019090600002"
          maxLength: 13
          type: string
      requestBody:
        content:
          application/json:
            schema:
              example:
                oinBehandeldienst: "00000000000987654321"
                oinBevoegdGezag: "00000000000123456789"
              properties:
                oinBehandeldienst:
                  description: Organisatie identificatie nummer van behandeldienst.
                    Indien geen OIN wordt opgegeven of null dan wordt deze verwijderd.
                  nullable: true
                  pattern: ^\d{20}$
                  type: string
                oinBevoegdGezag:
                  description: Organisatie identificatie nummer van bevoegd gezag.
                    Indien deze niet hetzelfde is als het huidige bevoegd gezag dan
                    wordt deze gewijzigd.
                  pattern: ^\d{20}$
                  type: string
              required:
              - oinBevoegdGezag
              type: object
        description: Nieuwe of huidige OIN van het bevoegdgezag en OIN van behandeldienst
          of geen OIN van behandeldienst om deze te verwijderen.
        required: true
      responses:
        "204":
          description: Wijzigen geslaagd
        "400":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  instance: /verzoeken/_zoek
                  invalid-params:
                  - name: locatie
                    reason: Locatie is een verplicht veld
                    type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                  status: 400
                  title: Validatie mislukt
                  type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
                properties:
                  invalid-params:
                    items:
                      properties:
                        name:
                          type: string
                        reason:
                          type: string
                        type:
                          type: string
                      required:
                      - type
                      - name
                      - reason
                    type: array
          description: |-
            Validatiefout. Mogelijk foutsituaties:
              - Het OIN van de nieuwe behandeldienst is niet correct
              - Het OIN van het nieuwe bevoegd gezag is niet correct
              - Het OIN is niet van een bevoegd gezag. Geef een geldig OIN van een bevoegd gezag op.
              - Het nieuwe bevoegd gezag accepteert geen Conceptverzoek
              - Het verzoek is ingetrokken
              - Het OIN van de behandeldienst is niet aangesloten op het Digitaal Stelsel Omgevingswet - Landelijke Voorziening.
              - Het verzoek is van het type 'Idee' en het opgegeven bevoegd gezag staat geen 'Idee' toe.
              - Het verzoek is van het type 'Idee' en de opgegeven behandeldienst accepteert nog niet de juiste STAM versie (versie 5).
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Swagger
                - De wijziging voldoet niet aan de swagger specificatie.
        "401":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: U bent niet geautoriseerd voor dit verzoek.
                  instance: 539f14d69f2fba81
                  status: 401
                  title: Authenticatiegegevens ontbreken of zijn onjuist.
                  type: https://content.omgevingswet.overheid.nl/id/concept/Ongeautoriseerd
                properties:
                  detail:
                    type: string
          description: Gebruiker heeft geen toestemming om deze actie uit te voeren
        "404":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Verzoek niet gevonden.
                  instance: 539f14d69f2fba81
                  status: 404
                  title: Niet gevonden.
                  type: https://content.omgevingswet.overheid.nl/id/concept/BestaatNiet
                properties:
                  detail:
                    type: string
          description: Het verzoek bestaat niet
        "409":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Probeer het later nog eens, nadat de aanvulling is verwerkt.
                  instance: 539f14d69f2fba81
                  status: 409
                  title: Conflict
                  type: https://content.omgevingswet.overheid.nl/id/concept/Conflict
                properties:
                  detail:
                    type: string
          description: Probeer het later nog eens, nadat de aanvulling is verwerkt.
        "500":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Er is iets mis gegaan.
                  instance: 539f14d69f2fba81
                  status: 500
                  title: Interne serverfout
                  type: https://content.omgevingswet.overheid.nl/id/concept/ServerFout
                properties:
                  detail:
                    type: string
          description: Interne serverfout
      summary: Wijzigen of verwijderen van de behandeldienst en eventueel wijzigen
        van het bevoegd gezag bij een verzoek.
      tags:
      - Verzoeken
  /verzoeken/{verzoeknummer}/documenten/{documentId}:
    get:
      description: Haalt de metagegevens van een document op behorende bij het verzoek.
      operationId: haalMetadataVanDocumentOp
      parameters:
      - description: nummer van het verzoek
        in: path
        name: verzoeknummer
        required: true
        schema:
          example: "2019090600002"
          maxLength: 13
          type: string
      - description: id van het document
        in: path
        name: documentId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/hal+json:
              schema:
                example:
                  _links:
                    content:
                      href: https://api.dso.nl/verzoeken/2017010100001/documenten/1/content
                    self:
                      href: https://api.dso.nl/verzoeken/2017010100001/documenten/1
                  documentId: 51c4275449f3760f9cabad9e6c1478764e19be6802a900b188248b068403f912
                  metadata:
                    bestandsnaam: Tekening_van_de_uitbouw.pdf
                    documentOmschrijving: Overig
                    formaat: application/pdf
                    vertrouwelijkAanduiding: Vertrouwelijk
                properties:
                  _links:
                    properties:
                      content:
                        example:
                          href: https://api.dso.nl/verzoeken/2017010100001
                        properties:
                          href:
                            type: string
                        required:
                        - href
                      self:
                        example:
                          href: https://api.dso.nl/verzoeken/2017010100001
                        properties:
                          href:
                            type: string
                        required:
                        - href
                    type: object
                  documentId:
                    maxLength: 128
                    type: string
                  id:
                    type: integer
                  metadata:
                    description: metadata
                    properties:
                      bestandsnaam:
                        type: string
                      documentOmschrijving:
                        description: aanduiding van de aard van de gevraagde bijlage
                          zoals gehanteerd door de zaakbehandelende organisatie, gebaseerd
                          op 'documenttypeGeneriek'. Bevat een lege string als de
                          documentOmschrijving niet bekend is.
                        type: string
                      formaat:
                        description: het MIME-type
                        type: string
                      vertrouwelijkAanduiding:
                        description: geeft aan of het document als vertrouwelijk moet
                          worden behandeld.
                        enum:
                        - Vertrouwelijk
                        - Niet vertrouwelijk
                        type: string
                    required:
                    - bestandsnaam
                    - vertrouwelijkAanduiding
                    - documentOmschrijving
                    - formaat
                    type: object
                required:
                - id
                - documentId
                - metadata
                type: object
          description: De documentgegevens
        "400":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  instance: /verzoeken/_zoek
                  invalid-params:
                  - name: locatie
                    reason: Locatie is een verplicht veld
                    type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                  status: 400
                  title: Validatie mislukt
                  type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
                properties:
                  invalid-params:
                    items:
                      properties:
                        name:
                          type: string
                        reason:
                          type: string
                        type:
                          type: string
                      required:
                      - type
                      - name
                      - reason
                    type: array
          description: |-
            Validatiefout. Mogelijk foutsituaties:
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Swagger
                - De vraag voldoet niet aan de swagger specificatie.
        "401":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: U bent niet geautoriseerd voor dit verzoek.
                  instance: 539f14d69f2fba81
                  status: 401
                  title: Authenticatiegegevens ontbreken of zijn onjuist.
                  type: https://content.omgevingswet.overheid.nl/id/concept/Ongeautoriseerd
                properties:
                  detail:
                    type: string
          description: Gebruiker heeft geen toestemming om deze actie uit te voeren
        "404":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Verzoek niet gevonden.
                  instance: 539f14d69f2fba81
                  status: 404
                  title: Niet gevonden.
                  type: https://content.omgevingswet.overheid.nl/id/concept/BestaatNiet
                properties:
                  detail:
                    type: string
          description: Document niet gevonden
        "500":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Er is iets mis gegaan.
                  instance: 539f14d69f2fba81
                  status: 500
                  title: Interne serverfout
                  type: https://content.omgevingswet.overheid.nl/id/concept/ServerFout
                properties:
                  detail:
                    type: string
          description: Interne serverfout
      summary: Haalt de metadata van een document bij een verzoek op.
      tags:
      - Documenten
  /verzoeken/{verzoeknummer}/documenten/{documentId}/content:
    get:
      description: Geeft het daadwerkelijke bestand (content) terug van het opgegeven
        document. Dit kan een door de aanvrager toegevoegd document zijn of een formulier.
      operationId: haalInhoudVanDocumentOp
      parameters:
      - description: nummer van het verzoek
        in: path
        name: verzoeknummer
        required: true
        schema:
          example: "2019090600002"
          maxLength: 13
          type: string
      - description: id van het document
        in: path
        name: documentId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/octet-stream:
              schema:
                format: binary
                type: string
          description: Content van het document
          headers:
            Content-Length-File:
              schema:
                description: De bestandsgrootte in bytes
                type: number
        "400":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  instance: /verzoeken/_zoek
                  invalid-params:
                  - name: locatie
                    reason: Locatie is een verplicht veld
                    type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                  status: 400
                  title: Validatie mislukt
                  type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
                properties:
                  invalid-params:
                    items:
                      properties:
                        name:
                          type: string
                        reason:
                          type: string
                        type:
                          type: string
                      required:
                      - type
                      - name
                      - reason
                    type: array
          description: |-
            Validatiefout. Mogelijk foutsituaties:
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Swagger
                - De vraag voldoet niet aan de swagger specificatie.
        "401":
          content:
            application/octet-stream:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: U bent niet geautoriseerd voor dit verzoek.
                  instance: 539f14d69f2fba81
                  status: 401
                  title: Authenticatiegegevens ontbreken of zijn onjuist.
                  type: https://content.omgevingswet.overheid.nl/id/concept/Ongeautoriseerd
                properties:
                  detail:
                    type: string
          description: Gebruiker heeft geen toestemming om deze actie uit te voeren
        "404":
          content:
            application/octet-stream:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Verzoek niet gevonden.
                  instance: 539f14d69f2fba81
                  status: 404
                  title: Niet gevonden.
                  type: https://content.omgevingswet.overheid.nl/id/concept/BestaatNiet
                properties:
                  detail:
                    type: string
          description: Document niet gevonden
        "500":
          content:
            application/octet-stream:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Er is iets mis gegaan.
                  instance: 539f14d69f2fba81
                  status: 500
                  title: Interne serverfout
                  type: https://content.omgevingswet.overheid.nl/id/concept/ServerFout
                properties:
                  detail:
                    type: string
          description: Interne serverfout
      summary: Haalt de content van het document op.
      tags:
      - Documenten
  /verzoeken/{verzoeknummer}/samenvatting:
    get:
      description: |-
        Haalt de samenvatting van een ingediend verzoek op met opgegeven 'verzoeknummer'.
        Voor de verzoek-xml kan de STAM-versie worden opgegeven door de Accept header te vullen met `application/xml;stam=$STAM_VERSIE$`. Indien de versie wordt ondersteund, wordt de verzoek-xml opgemaakt in de gevraagde STAM-versie. Wordt er geen Accept header met een STAM-versie meegegeven, dan wordt de verzoek-xml opgemaakt met veldnamen en waarden conform de oudste STAM-versie die de server op het moment van de aanvraag ondersteunt.
        Het is mogelijk om meerdere STAM-versies op te geven, indien de client dit ondersteunt. In dat geval zal de server de meest recente versie selecteren. Vul daarvoor de Accept header met bijvoorbeeld, `application/xml;stam=5, application/xml;stam=6`. Let op: in een volgende versie van deze service komt de mogelijk om meerdere STAM-versies tegelijk op te vragen te vervallen.
      operationId: haalVerzoeksamenvattingOp
      parameters:
      - description: nummer van het verzoek
        in: path
        name: verzoeknummer
        required: true
        schema:
          example: "2019090600002"
          maxLength: 13
          type: string
      - description: formaat van de samenvatting
        in: query
        name: format
        required: true
        schema:
          enum:
          - xml
          - pdf
          type: string
      - description: |
          De EPSG code van het coordinaatstelsel van de geometrie van het verzoek welke dient te worden teruggegeven. RD of ETRS89.
          Indien deze niet word gevuld zal ETRS89 worden gebruikt.
        in: header
        name: Accept-Crs
        schema:
          default: EPSG:4258
          enum:
          - EPSG:28992
          - EPSG:4258
          example: EPSG:28992
          type: string
      - description: Via de accept header kan de STAM-versie worden aangegeven middels
          een extra argument van het media type, bijvoorbeeld `application/xml;stam=5`
          of `application/hal+json;stam=6`. Ondersteunende STAM versies zijn 5 en
          6.
        in: header
        name: Accept
        required: false
        schema:
          example: application/xml;stam=6
          type: string
      responses:
        "200":
          content:
            application/pdf:
              schema:
                format: binary
                type: string
            application/xml:
              schema:
                format: binary
                type: string
          description: De verzoek samenvatting
          headers:
            Content-Length-File:
              schema:
                description: De bestandsgrootte in bytes
                type: number
        "400":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  instance: /verzoeken/_zoek
                  invalid-params:
                  - name: locatie
                    reason: Locatie is een verplicht veld
                    type: https://content.omgevingswet.overheid.nl/id/concept/validatie/LocatieOnjuist
                  status: 400
                  title: Validatie mislukt
                  type: https://content.omgevingswet.overheid.nl/id/concept/ValidatieMislukt
                properties:
                  invalid-params:
                    items:
                      properties:
                        name:
                          type: string
                        reason:
                          type: string
                        type:
                          type: string
                      required:
                      - type
                      - name
                      - reason
                    type: array
          description: |-
            Validatiefout. Mogelijk foutsituaties:
              - https://content.omgevingswet.overheid.nl/id/concept/validatie/Swagger
                - De vraag voldoet niet aan de swagger specificatie.
                - Accept-Crs header met EPSG:28992 is niet toegestaan voor STAM-versie lager dan V6.
        "404":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Verzoek niet gevonden.
                  instance: 539f14d69f2fba81
                  status: 404
                  title: Niet gevonden.
                  type: https://content.omgevingswet.overheid.nl/id/concept/BestaatNiet
                properties:
                  detail:
                    type: string
          description: Verzoek niet gevonden
        "406":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: 'Beschikbare stam versies: 5, 6'
                  instance: 539f14d69f2fba81
                  status: 406
                  title: De gevraagde STAM versie is niet beschikbaar.
                  type: https://content.omgevingswet.overheid.nl/id/concept/StamVersieNietAcceptabel
                properties:
                  detail:
                    type: string
          description: STAM versie niet ondersteund
        "500":
          content:
            application/hal+json:
              schema:
                allOf:
                - properties:
                    instance:
                      type: string
                    status:
                      format: int64
                      type: integer
                    title:
                      type: string
                    type:
                      type: string
                  required:
                  - type
                  - title
                  - status
                example:
                  detail: Er is iets mis gegaan.
                  instance: 539f14d69f2fba81
                  status: 500
                  title: Interne serverfout
                  type: https://content.omgevingswet.overheid.nl/id/concept/ServerFout
                properties:
                  detail:
                    type: string
          description: Interne serverfout
      summary: Haalt de samenvatting van een verzoek op.
      tags:
      - Verzoeken
servers:
- url: /api/afhandelen/v3
tags:
- description: Documentgerelateerde acties
  name: Documenten
- description: Verzoekgerelateerde acties
  name: Verzoeken
