Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleKlik hier om de inhoud te bekijken
Swagger open api macro
displayOperationIdfalse
methodsnone,get,put,post,delete,options,head,patch,trace
validator
defaultModelsExpandDepth1
url
token
defaultModelRenderingexample
filter
password
expandlist
showCommonExtensionsfalse
filename
operations
maxDisplayedTags
attachfalse
showExtensionsfalse
displayRequestDurationfalse
username
order
openapi: "3.0.2"
info:
  title: "Asbestattesten"
  description: "Deze dienst maakt het mogelijk om asbestattesten op te vragen uit het asbestinventatris bij OVAM"
  contact:
    name: "Magda helpdesk"
    url: "https://overheid.vlaanderen.be/magda"
  license:
    name: "Asbestinventaris"
    url: "https://overheid.vlaanderen.be/magda"
  version: "1.0.0"
servers:
  - url: "api/v1/milieu"
paths:
  /attesten/asbestattesten/gebouweenheden/{gebouweenheidId}:
    get:
      tags:
        - "asbestattesten"
      summary: "Het asbestId opbragen op basis van de gebouweenheidsId"
      parameters:
        - name: gebouweenheidId
          in: path
          required: true
          description: "Id van de gebouweenheid waarvoor gegevens opgevraagd worden"
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: "Response met inhoud"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GebouwEenheidSummary"
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  /attesten/asbestattesten/{asbestinventarisId}:
    get:
      tags:
        - "asbestattesten"
      summary: "details van een attest opvragen in JSON formaat"
      parameters:
        - name: asbestinventarisId
          in: path
          required: true
          description: "Id van de asbestinventaris waarvoor gegevens opgevraagd worden"
          schema:
            type: string
            format: uuid
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: "Response met inhoud in JSON formaat van een asbestattest"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Asbestinventaris"
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  /attesten/asbestattesten/{asbestinventarisId}/attest:
    get:
      tags:
        - "asbestattesten"
      summary: "het attest opvragen in PDF formaat"
      parameters:
        - name: asbestinventarisId
          in: path
          required: true
          description: "Id van de asbestinventaris waarvoor het attest opgevraagd wordt"
          schema:
            type: string
            format: uuid
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: "Het pdf attest horende bij de asbestinventaris"
          content:
            application/pdf:
              schema:
                type: string
                format: binary
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'
  
  /attesten/asbestattesten:
    get:
      tags:
        - "asbestattesten"
      summary: "Zoek inventarissen"
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
        - name: geowkt
          in: query
          description: "Geometrie waarbinnen asbestinventarissen worden gezocht. Geeft alle resultaten die voor meer dan 5% binnen de geometrie liggen. Coördinatensysteem (`crs`) is verplicht."
          schema:
            type: string
          example: POLYGON((154986.030215235 190913.00871922178,154987.5279744013 190914.9131133676,154989.21246565756 190913.72696459584,154987.87177998378 190911.86510712252,154986.030215235 190913.00871922178))
        - name: crs
          in: query
          description: "Coördinatensysteem van `geowkt` waarbinnen asbestinventarissen worden gezocht"
          schema:
            type: string
          example: "EPSG:31370"
        - name: gemeentecode
          in: query
          description: "Gemeentecode van het perceel van de asbestinventaris. `afdelingscode`, `sectiecode`, `perceelnummer` zijn ook vereist."
          schema:
            type: string
          example: "44040"
        - name: afdelingcode
          in: query
          description: "Afdelingscode van het perceel van de asbestinventaris. `gemeentecode`, `sectiecode`, `perceelnummer` zijn ook vereist."
          schema:
            type: string
          example: "44040"
        - name: sectiecode
          in: query
          description: "Sectiecode van het perceel van de asbestinventaris. `gemeentecode`, `afdelingscode`, `perceelnummer` zijn ook vereist."
          schema:
            type: string
          example: "A"
        - name: perceelnummer
          in: query
          description: "Perceelnummer van het perceel van de asbestinventaris.`gemeentecode`, `afdelingscode`, `sectiecode` zijn ook vereist."
          schema:
            type: string
          example: "0297/00K000"
        - name: gemeentenaam
          in: query
          description: "Gemeentenaam van het adres van de asbestinventaris. `postcode`, `straatnaam`, `huisnummer` zijn ook vereist."
          schema:
            type: string
        - name: postcode
          in: query
          description: "Postcode van het adres van de asbestinventaris. `gemeentenaam`, `straatnaam`, `huisnummer` zijn ook vereist."
          schema:
            type: string
        - name: straatnaam
          in: query
          description: "Straatnaam van het adres van de asbestinventaris. `gemeentenaam`, `postcode`, `huisnummer` zijn ook vereist."
          schema:
            type: string
        - name: huisnummer
          in: query
          description: "Huisnummer van het adres van de asbestinventaris. `gemeentenaam`, `postcode`, `straatnaam` zijn ook vereist."
          schema:
            type: string
        - name: busnummer
          in: query
          description: "Busnummers van het adres van de asbestinventaris. Optionele parameter. Als het ingevuld is, zijn `gemeentenaam`,`postcode`, `straatnaam`, `huisnummer` ook vereist."
          schema:
            type: array
            items:
              type: string
            example:
              - "001"
              - "002"
              - "003"
        - name: vbradresid
          in: query
          description: "VBR adres ID van de asbestinventaris"
          schema:
            type: string
          example: "https://data.vlaanderen.be/id/adres/16256079"
      responses:
        200:
          description: "Alle overeenkomstige inventarissen."
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Asbestinventarissen"
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  /attesten/asbestattesten/analyserapport/{analyseRapportId}:
    get:
      tags:
        - "asbestattesten"
      summary: "Download een analyserapport"
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
        - name: analyseRapportId
          in: path
          required: true
          description: "Id van het analyserapport"
          schema:
            type: string
            format: uuid
      responses:
        200:
          description: "Een analyserapport in pdf dat geüpload werd door de deskundige"
          content:
            application/pdf:
              schema:
                type: string
                format: binary
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

components:
  parameters:
    CorrelationId:
      name: x-correlation-id
      in: header
      required: true
      schema:
        $ref: '#/components/schemas/Correlation-Id'
  responses:
    #HTTP Status 400
    BadRequest:
      description: "Invalid data supplied"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 401
    InvalidAuthorization:
      description: "Invalid authorization"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 403
    Forbidden:
      description: "Authentication failed"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 404
    NotFound:
      description: "Resource not found"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 412
    PreConditionFailed:
      description: Precondition Failed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 500
    UnexpectedServerError:
      description: "Unexpected Server Error"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 502
    BadGateway:
      description: "Bad Gateway"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 503
    ServiceUnavailable:
      description: "Service unavailable"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 504
    GatewayTimeout:
      description: "Gateway Timeout"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
  schemas:
    Correlation-Id:
      description: "ID of the transaction. Use this ID for log tracing and incident handling"
      type: string
      minLength: 10
      maxLength: 36

    GebouwEenheidSummary:
      description: "Beschrijving van de gebouweenheid zoals gekend binnen de asbestinventaris applicatie"
      properties:
        inventarissen:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                format: uuid

    Asbestinventarissen:
      description: "Overzicht van de overeenkomstige asbestinventarissen zoals gekend binnen de asbestinventaris applicatie"
      properties:
        inventarissen:
          $ref: '#/components/schemas/Inventarissen'

    Inventarissen:
      type: array
      items:
        type: object
        properties:
          id:
            type: string
            format: uuid

    Asbestinventaris:
      description: "Details van een inventaris"
      type: object
      properties:
        id:
          type: string
          format: uuid
        attestNummer:
          type: string
        locatieBeschrijving:
          type: string
          description: "Betreft slechts een indicatie van de locatie. Het bevat niet de officiële locatiegegevens van de overheid"
        resultaat:
          type: string
        aanleiding:
          type: string
        gemeenschappelijkDeel:
          type: boolean
        gemeenschappelijkeDelen:
          type: array
          items:
            $ref: '#/components/schemas/GemeenschappelijkDeel'
        analyseRapporten:
          type: array
          items:
            $ref: '#/components/schemas/AnalyseRapport'
        uitgegevenOp:
          type: string
          format: date
        geldigTot:
          type: string
          format: date
        attest:
          type: object
          properties:
            id:
              type: string
              format: uuid
        aantalAsbestmaterialen:
          type: integer
        aantalBeperkingen:
          type: integer
        aantalUitsluitingen:
          type: integer
        asbestmaterialen:
          type: array
          items:
            $ref: '#/components/schemas/Asbestmateriaal'

    GemeenschappelijkDeel:
      description: 'Identificator naar het gemeenschappelijk deel'
      type: object
      properties:
        type:
          type: string
        id:
          type: string
          format: uuid

    AnalyseRapport:
      description: 'Identificator naar het analyse rapport'
      type: object
      properties:
        type:
          type: string
        id:
          type: string
          format: uuid

    Asbestmateriaal:
      description: 'Identificator naar het asbestmateriaal'
      type: object
      properties:
        type:
          type: string
        id:
          type: string
          format: uuid

    ErrorMessage:
      required:
        - detail
        - title
      type: object
      properties:
        type:
          type: string
          description: "A URI reference that identifies the problem type. This specification encourages that, when de-referenced, it provide human-readable documentation for the problem type. When this member is not present, its value is assumed to be about:blank."
        title:
          type: string
          description: "A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization (e.g., using proactive content negotiation."
        status:
          type: string
          description: "The HTTP status code generated by the origin server for this occurrence of the problem."
        detail:
          type: string
          description: "A human-readable explanation specific to this occurrence of the problem."
        instance:
          type: string
          description: "A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if de-referenced."
      description: "A representation of a generic error message."

...

Expand
titleKlik hier om de inhoud te bekijken
Swagger open api macro
displayOperationIdfalse
methodsnone,get,put,post,delete,options,head,patch,trace
validator
defaultModelsExpandDepth1
url
token
defaultModelRenderingexample
filter
password
expandlist
showCommonExtensionsfalse
filename
operations
maxDisplayedTags
attachfalse
showExtensionsdisplayRequestDurationfalse
displayRequestDurationshowExtensionsfalse
username
order
openapi: "3.0.2"
info:
  title: "Verenigingen"
  description: "Een api voor het beheer van een (feitelijke) verenigingen voor verenigingsregister"
  contact:
    name: "Magda helpdesk"
    url: "https://overheid.vlaanderen.be/magda"
  license:
    name: "Verenigingen"
    url: "https://overheid.vlaanderen.be/magda"
  version: "1.0.0"
servers:
  - url: "api/v1/organisaties"

paths:
  /verenigingen/verenigingen/{vCode}:
    get:
      tags:
        - Opvragen van verenigingen
      summary: Vraag het detail van een vereniging op.
      parameters:
        - name: vCode
          in: path
          description: De vCode van de vereniging
          required: true
          schema:
            type: string
        - name: expectedSequence
          in: query
          description: Sequentiewaarde verkregen bij creatie of aanpassing vereniging.
          schema:
            type: integer
            format: int64
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        200:
          description: Het detail van een vereniging
          headers:
            ETag:
              description: De versie van de aangepaste vereniging.
              schema:
                type: string
                description: De versie van de aangepaste vereniging.
                format: ''
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.DetailVerenigingResponse
        400:
          $ref: "#/components/responses/BadRequest"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"

    patch:
      tags:
        - Decentraal beheer van verenigingen
      summary: Wijzig de basisgegevens van een vereniging.
      description: "Enkel velden die worden doorgestuurd in de request worden verwerkt. Null waarden worden niet verwerkt.\r\nWanneer er wijzigingen veroorzaakt zijn door de request, bevat de response een sequence header.\r\n            \r\nNa het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De vCode van de vereniging
          required: true
          schema:
            type: string
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.WijzigBasisgegevens.FeitelijkeVereniging.RequestModels.WijzigBasisgegevensRequest
      responses:
        200:
          description: Er waren geen wijzigingen
        202:
          description: De basisgegevens van de vereniging werden gewijzigd
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de aangepaste vereniging.
              schema:
                type: string
                description: De versie van de aangepaste vereniging.
                format: ''
            Location:
              description: De locatie van de aangepaste vereniging.
              schema:
                type: string
                description: De locatie van de aangepaste vereniging.
                format: ''
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"

  /verenigingen/verenigingen/{vCode}/contactgegevens:
    post:
      tags:
        - Decentraal beheer van verenigingen
      summary: Voeg een contactgegeven toe.
      description: "Na het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De VCode van de vereniging
          required: true
          schema:
            type: string
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: Het toe te voegen contactgegeven
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Contactgegevens.FeitelijkeVereniging.VoegContactGegevenToe.RequestsModels.VoegContactgegevenToeRequest
      responses:
        202:
          description: Het contactgegeven werd goedgekeurd.
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
 description: Het contactgegeven werd goedgekeurd.           headersformat: ''
            VR-SequenceETag:
              description: HetDe sequenceversie nummervan vande dezegeregistreerde requestvereniging.
              schema:
                type: string
                description: HetDe sequenceversie nummervan vande dezegeregistreerde requestvereniging.
                format: ''
            ETagLocation:
              description: De versielocatie van de geregistreerdetoegevoegde verenigingcontactgegeven.
              schema:
                type: string
                description: De versielocatie van de geregistreerdetoegevoegde verenigingcontactgegeven.
                format: ''
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"

  /verenigingen/verenigingen/{vCode}/contactgegevens/{contactgegevenId}:
    delete:
      tags:
        - Decentraal beheer van verenigingen
      summary: Verwijder een contactgegeven.
      description: "Na het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De unieke identificatie code van deze vereniging
          required: true
          schema:
            type: string
        - name: contactgegevenId
          in: path
          description: >-
            De unieke identificatie code van dit contactgegeven binnen de
            vereniging
          required: true
          schema:
            type: integer
            format: int32
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '202':
          description: Het contactgegeven werd verwijderd.
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de geregistreerde vereniging.
              schema:
                type: string
                description: De versie van de geregistreerde vereniging.
                format: ''
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"

    patch:
      tags:
        - Decentraal beheer van verenigingen
      summary: Wijzig een contactgegeven.
      description: "Na het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De unieke identificatie code van deze vereniging
          required: true
          schema:
            type: string
        - name: contactgegevenId
          in: path
          description: >-
            De unieke identificatie code van dit contactgegeven binnen de
            vereniging
          required: true
          schema:
            type: integer
            format: int32
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: Het te wijzigen contactgegeven
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Contactgegevens.FeitelijkeVereniging.WijzigContactgegeven.RequestModels.WijzigContactgegevenRequest
      responses:
        '200':
          description: Er waren geen wijzigingen.
        '202':
          description: De wijziging werd aanvaard.
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de geregistreerde vereniging.
              schema:
                type: string
                description: De versie van de geregistreerde vereniging.
                format: ''
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"

  /verenigingen/verenigingen/{vCode}/historiek:
    get:
      tags:
        - Opvragen van verenigingen
      summary: Vraag de historiek van een vereniging op.
      description: "De historiek van een vereniging geeft zicht op de wijzigingen op de verenigingsdata zoals terug te vinden in het register.\r\n            \r\nDe gebeurtenissen met naam “WerdGewijzigd” betekenen voor de basisgegevens het volgende:\r\n- data werd toegevoegd (een waarde werd toegevoegd na registratie van de vereniging)\r\n- data werd gewijzigd (de bestaande waarde werd gewijzigd)\r\n- data werd verwijderd (de waarde werd verwijderd)\r\n            \r\nContactgegevens, locaties en vertegenwoordigers maken geen onderdeel uit van de basisgegevens.\r\nWijzigingen op deze data genereren gebeurtenissen met de namen “WerdToegevoegd”, “WerdGewijzigd” en “WerdVerwijderd”."
      parameters:
        - name: vCode
          in: path
          description: De vCode van de vereniging
          required: true
          schema:
            type: string
        - name: expectedSequence
          in: query
          description: Sequentiewaarde verkregen bij creatie of aanpassing vereniging.
          schema:
            type: integer
            format: int64
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: De historiek van een vereniging
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Historiek.ResponseModels.HistoriekResponse
        400:
          $ref: "#/components/responses/BadRequest"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"
  /verenigingen/verenigingen/{vCode}/kbo:
    patch:
      tags:
        - Wijzigen van gegevens uit KBO
      summary: Wijzig de basisgegevens.
      description: "Enkel velden die worden doorgestuurd in de request worden verwerkt. Null waarden worden niet verwerkt.\r\nWanneer er wijzigingen veroorzaakt zijn door de request, bevat de response een sequence header.\r\n            \r\nNa het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De vCode van de vereniging
          required: true
          schema:
            type: string
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.WijzigBasisgegevens.MetRechtspersoonlijkheid.RequestModels.WijzigBasisgegevensRequest
      responses:
        '200':
          description: Er waren geen wijzigingen
        '202':
          description: De basisgegevens van de vereniging werden gewijzigd
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de aangepaste vereniging.
              schema:
                type: string
                description: De versie van de aangepaste vereniging.
                format: ''
            Location:
              description: De locatie van de aangepaste vereniging.
              schema:
                type: string
                description: De locatie van de aangepaste vereniging.
                format: ''
        400:
          $ref: "#/components/responses/BadRequest"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"
  /verenigingen/verenigingen/{vCode}/kbo/contactgegevens/{contactgegevenId}:
    patch:
      tags:
        - Wijzigen van gegevens uit KBO
      summary: Wijzig een contactgegeven uit KBO.
      description: "Na het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De unieke identificatie code van deze vereniging
          required: true
          schema:
            type: string
        - name: contactgegevenId
          in: path
          description: >-
            De unieke identificatie code van dit contactgegeven binnen de
            vereniging
          required: true
          schema:
            type: integer
            format: int32
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: Het te wijzigen contactgegeven
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Contactgegevens.VerenigingMetRechtspersoonlijkheid.WijzigContactgegeven.RequestModels.WijzigContactgegevenRequest
      responses:
        '200':
          description: Er waren geen wijzigingen.
        '202':
          description: De wijziging werd aanvaard.
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de geregistreerde vereniging.
              schema:
                type: string
                description: De versie van de geregistreerde vereniging.
                format: ''
        400:
          $ref: "#/components/responses/BadRequest"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"
  /verenigingen/verenigingen/{vCode}/kbo/locaties/{locatieId}:
    patch:
      tags:
        - Wijzigen van gegevens uit KBO
      summary: Wijzig de maatschappelijke zetel volgens KBO.
      description: "Na het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De VCode van de vereniging
          required: true
          schema:
            type: string
        - name: locatieId
          in: path
          description: >-
            De unieke identificatie code van de maatschappelijke zetel volgens
            KBO binnen de vereniging.
          required: true
          schema:
            type: integer
            format: int32
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: De te wijzigen gegevens
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Locaties.VerenigingMetRechtspersoonlijkheid.WijzigMaatschappelijkeZetel.RequestModels.WijzigMaatschappelijkeZetelRequest
            example:
              locatie:
                isPrimair: true
                naam: Naam locatie
      responses:
        '200':
          description: Er waren geen wijzigingen.
        '202':
          description: De locatie werd gewijzigd.
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de geregistreerde vereniging.
              schema:
                type: string
                description: De versie van de geregistreerde vereniging.
                format: ''
        400:
          $ref: "#/components/responses/BadRequest"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"

  /verenigingen/verenigingen/{vCode}/locaties:
    post:
      tags:
        - Decentraal beheer van verenigingen
      summary: Voeg een locatie toe.
      description: "Na het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De VCode van de vereniging
          required: true
          schema:
            type: string
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: De toe te voegen locatie
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Locaties.FeitelijkeVereniging.VoegLocatieToe.RequestModels.VoegLocatieToeRequest
      responses:
        '202':
          description: De locatie werd goedgekeurd.
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de geregistreerde vereniging.
              schema:
                type: string
                description: De versie van de geregistreerde vereniging.
                format: ''
            Location:
              description: De locatie van de toegevoegde locatie.
              schema:
                type: string
                description: De locatie van de toegevoegde locatie.
                format: ''
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"

  /verenigingen/verenigingen/{vCode}/locaties/{locatieId}:
    delete:
      tags:
        - Decentraal beheer van verenigingen
      summary: Verwijder een locatie.
      description: "Na het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De unieke identificatie code van deze vereniging
          required: true
          schema:
            type: string
        - name: locatieId
          in: path
          description: >-
            De unieke identificatie code van deze locatie die verwijderd moet
            worden
          required: true
          schema:
            type: integer
            format: int32
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '202':
          description: De vertegenwoordiger werd verwijderd van deze vereniging.
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de geregistreerde vereniging.
              schema:
                type: string
                description: De versie van de geregistreerde vereniging.
                format: ''
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"

    patch:
      tags:
        - Decentraal beheer van verenigingen
      summary: Wijzig een locatie.
      description: "Na het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De VCode van de vereniging
          required: true
          schema:
            type: string
        - name: locatieId
          in: path
          description: De unieke identificatie code van deze locatie binnen de vereniging.
          required: true
          schema:
            type: integer
            format: int32
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: De te wijzigen locatie
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Locaties.FeitelijkeVereniging.WijzigLocatie.RequestModels.WijzigLocatieRequest
      responses:
        '200':
          description: Er waren geen wijzigingen.
        '202':
          description: De locatie werd goedgekeurd.
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de geregistreerde vereniging.
              schema:
                type: string
                description: De versie van de geregistreerde vereniging.
                format: ''
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"
  /verenigingen/verenigingen/{vCode}/stop:
    post:
      tags:
        - Decentraal beheer van verenigingen
      summary: Stoppen van een vereniging.
      description: "Wanneer er wijzigingen veroorzaakt zijn door de request, bevat de response een sequence header.\r\n            \r\nNa het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De vCode van de vereniging
          required: true
          schema:
            type: string
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Stop.RequestModels.StopVerenigingRequest
      responses:
        '200':
          description: Er waren geen wijzigingen
        '202':
          description: De vereniging werd gestopt
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de aangepaste vereniging.
              schema:
                type: string
                description: De versie van de aangepaste vereniging.
                format: ''
            Location:
              description: De locatie van de aangepaste vereniging.
              schema:
                type: string
                description: De locatie van de aangepaste vereniging.
                format: ''
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"

  /verenigingen/verenigingen/{vCode}/vertegenwoordigers:
    post:
      tags:
        - Decentraal beheer van verenigingen
      summary: Voeg een vertegenwoordiger toe.
      description: "Na het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De vCode van de vereniging
          required: true
          schema:
            type: string
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: De gegevens van de toe te voegen vertegenwoordiger
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Vertegenwoordigers.FeitelijkeVereniging.VoegVertegenwoordigerToe.RequestModels.VoegVertegenwoordigerToeRequest
      responses:
        '202':
          description: De vertegenwoordiger werd toegevoegd.
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de geregistreerde vereniging.
              schema:
                type: string
                description: De versie van de geregistreerde vereniging.
                format: ''
            Location:
              description: De locatie van de toegevoegde vertegenwoordiger.
              schema:
                type: string
                description: De locatie van de toegevoegde vertegenwoordiger.
                format: ''
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"

  /verenigingen/verenigingen/{vCode}/vertegenwoordigers/{vertegenwoordigerId}:
    delete:
      tags:
        - Decentraal beheer van verenigingen
      summary: Verwijder een vertegenwoordiger.
      description: "Na het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De unieke identificatie code van deze vereniging
          required: true
          schema:
            type: string
        - name: vertegenwoordigerId
          in: path
          description: >-
            De unieke identificatie code van deze vertegenwoordiger die
            verwijderd moet worden
          required: true
          schema:
            type: integer
            format: int32
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '202':
          description: De vertegenwoordiger werd verwijderd van deze vereniging.
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de geregistreerde vereniging.
              schema:
                type: string
                description: De versie van de geregistreerde vereniging.
                format: ''
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"

    patch:
      tags:
        - Decentraal beheer van verenigingen
      summary: Wijzig een vertegenwoordiger.
      description: "Na het uitvoeren van deze actie wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de aanpassing\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: vCode
          in: path
          description: De unieke identificatie code van deze vereniging
          required: true
          schema:
            type: string
        - name: vertegenwoordigerId
          in: path
          description: >-
            De unieke identificatie code van deze vertegenwoordiger binnen de
            vereniging
          required: true
          schema:
            type: integer
            format: int32
        - name: If-Match
          in: header
          description: >-
            If-Match header met ETag van de laatst gekende versie van de
            vereniging.
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: De gegevens van de vertegenwoordiger die gewijzigd moeten worden
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Vertegenwoordigers.FeitelijkeVereniging.WijzigVertegenwoordiger.RequestModels.WijzigVertegenwoordigerRequest
      responses:
        '200':
          description: Er waren geen wijzigingen.
        '202':
          description: De vertegenwoordiger werd gewijzigd.
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de geregistreerde vereniging.
              schema:
                type: string
                description: De versie van de geregistreerde vereniging.
                format: ''
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"

  /verenigingen/verenigingen/feitelijkeverenigingen:
    post:
      tags:
        - Registratie
      summary: Registreer een feitelijke vereniging.
      description: "Bij het registreren van de vereniging wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de zonet geregistreerde vereniging\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: VR-BevestigingsToken
          in: header
          description: "Dit token wordt gebruikt als bevestiging dat de vereniging uniek is,\r\n            ondanks de voorgestelde duplicaten."
          schema:
            type: string
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: De gegevens van de te registreren vereniging
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Registreer.FeitelijkeVereniging.RequetsModels.RegistreerFeitelijkeVerenigingRequest
      responses:
        '202':
          description: De feitelijke vereniging werd geregistreerd.
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de geregistreerde vereniging.
              schema:
                type: string
                description: De versie van de geregistreerde vereniging.
                format: ''
            Location:
              description: De locatie van de geregistreerde vereniging.
              schema:
                type: string
                description: De locatie van de geregistreerde vereniging.
                format: ''
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        409:
          description: >-
            Er zijn één of meerdere mogelijke duplicaten van deze vereniging
            gevonden.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Registreer.PotentialDuplicatesResponse
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"
  /verenigingen/verenigingen/kbo:
    post:
      tags:
        - Registratie
      summary: Registreer een vereniging met rechtspersoonlijkheid vanuit de KBO.
      description: "Bij het registreren van de vereniging wordt een sequentie teruggegeven via de `VR-Sequence` header.\r\nDeze waarde kan gebruikt worden in andere endpoints om op te volgen of de zonet geregistreerde vereniging\r\nal is doorgestroomd naar deze endpoints."
      parameters:
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: De gegevens van de te registreren vereniging
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Registreer.MetRechtspersoonlijkheid.RequestModels.RegistreerVerenigingUitKboRequest
      responses:
        '200':
          description: De vereniging was reeds geregistreerd in het register.
          headers:
            Location:
              description: De locatie van de geregistreerde vereniging.
              schema:
                type: string
                description: De locatie van de geregistreerde vereniging.
                format: ''
        '202':
          description: De vereniging met rechtspersoonlijkheid werd geregistreerd.
          headers:
            VR-Sequence:
              description: Het sequence nummer van deze request.
              schema:
                type: string
                description: Het sequence nummer van deze request.
                format: ''
            ETag:
              description: De versie van de geregistreerde vereniging.
              schema:
                type: string
                description: De versie van de geregistreerde vereniging.
                format: ''
            Location:
              description: De locatie van de geregistreerde vereniging.
              schema:
                type: string
                description: De locatie van de geregistreerde vereniging.
                format: ''
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"

  /verenigingen/verenigingen/zoeken:
    get:
      tags:
        - Opvragen van verenigingen
      summary: Zoek verenigingen op.
      description: "Dit endpoint laat toe verenigingen op te zoeken.\r\nVoor de zoekterm `q` kan je gebruik maken van volledige termen, of gebruik maken van wildcards.\r\n- `q=Liedekerke` zoekt in alle velden naar de volledige term,\r\n- `q=Liedeke*` zoekt in alle velden naar een term die begint met 'Liedeke',\r\n- `q=*kerke` zoekt in alle velden naar een term die eindigt op 'kerke',\r\n- `q=*kerke*` zoekt in alle velden naar een term die 'kerke' bevat.\r\nOm te zoeken binnen een bepaald veld, gebruik je de naam van het veld.\r\n- `q=gemeente:Liedekerke`\r\n- `q=korteNaam:DV*`\r\nOm te zoeken op een genest veld, beschrijf je het pad naar het veld.\r\n- `q=locaties.postcode:1000`\r\nStandaard gebruiken we een paginatie limiet van 50 verenigingen.\r\nOm een andere limiet te gebruiken, geef je de parameter `limit` mee.\r\nDe maximum limiet die kan gebruikt worden is 1000.\r\n- `q=...&limit=100`\r\nOm de volgende pagina's op te vragen, geef je de parameter `offset` mee.\r\n- `q=...&offset=50`\r\n- `q=...&offset=30&limit=30`\r\nEr kan enkel gepagineerd worden binnen de eerste 1000 resultaten.\r\nDit betekent dat de som van limit en offset nooit meer kan bedragen dan 1000."
      parameters:
        - name: q
          in: query
          description: De querystring
          schema:
            type: string
        - name: sort
          in: query
          description: De velden om op te sorteren
          schema:
            type: string
        - name: offset
          in: query
          description: Het aantal items dat overgeslagen zal worden
          schema:
            type: integer
            format: int32
        - name: limit
          in: query
          description: Het aantal items dat (maximaal) zal worden opgehaald
          schema:
            type: integer
            format: int32
        - name: X-Correlation-Id
          in: header
          description: Deze id identificeert de request.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Indien de zoekopdracht succesvol was.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.SearchVerenigingenResponse
        400:
          $ref: "#/components/responses/BadRequestValidation"
        401:
          $ref: "#/components/responses/InvalidAuthorization"
        403:
          $ref: "#/components/responses/Forbidden"
        404:
          $ref: "#/components/responses/NotFound"
        412:
          $ref: "#/components/responses/PreConditionFailed"
        500:
          $ref: "#/components/responses/UnexpectedServerError"
        502:
          $ref: "#/components/responses/BadGateway"
        503:
          $ref: "#/components/responses/ServiceUnavailable"
        504:
          $ref: "#/components/responses/GatewayTimeout"
components:
  responses:
    #HTTP Status 400
    BadRequest:
      description: "Invalid data supplied"
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Be.Vlaanderen.Basisregisters.BasicApiProblem.ProblemDetails

    BadRequestValidation:
      description: "Invalid data supplied"
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Be.Vlaanderen.Basisregisters.BasicApiProblem.ValidationProblemDetails
    #HTTP Status 401
    InvalidAuthorization:
      description: "Invalid authorization"
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Be.Vlaanderen.Basisregisters.BasicApiProblem.ProblemDetails
    #HTTP Status 403
    Forbidden:
      description: "Authentication failed"
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Be.Vlaanderen.Basisregisters.BasicApiProblem.ProblemDetails
    #HTTP Status 404
    NotFound:
      description: "Resource not found"
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Be.Vlaanderen.Basisregisters.BasicApiProblem.ProblemDetails
    #HTTP Status 412
    PreConditionFailed:
      description: "Precondition Failed"
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Be.Vlaanderen.Basisregisters.BasicApiProblem.ProblemDetails
    #HTTP Status 500
    UnexpectedServerError:
      description: "Unexpected Server Error"
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Be.Vlaanderen.Basisregisters.BasicApiProblem.ProblemDetails
    #HTTP Status 502
    BadGateway:
      description: "Bad Gateway"
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Be.Vlaanderen.Basisregisters.BasicApiProblem.ProblemDetails
    #HTTP Status 503
    ServiceUnavailable:
      description: "Service unavailable"
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Be.Vlaanderen.Basisregisters.BasicApiProblem.ProblemDetails
    #HTTP Status 504
    GatewayTimeout:
      description: "Gateway Timeout"
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Be.Vlaanderen.Basisregisters.BasicApiProblem.ProblemDetails
  schemas:
    AssociationRegistry.Admin.Api.Verenigingen.Common.Adres:
      type: object
      properties:
        straatnaam:
          type: string
          description: De straat van het adres
        huisnummer:
          type: string
          description: Het huisnummer van het adres
        busnummer:
          type: string
          description: Het busnummer van het adres
        postcode:
          type: string
          description: De postcode van het adres
        gemeente:
          type: string
          description: De gemeente van het adres
        land:
          type: string
          description: Het land van het adres
      additionalProperties: false
      description: Een adres van een locatie
    AssociationRegistry.Admin.Api.Verenigingen.Common.AdresId:
      type: object
      properties:
        broncode:
          type: string
          description: De code van de bron van het adres
        bronwaarde:
          type: string
          description: De unieke identificator volgens de bron
      additionalProperties: false
      description: De unieke identificator van het adres in een andere bron
    AssociationRegistry.Admin.Api.Verenigingen.Common.DoelgroepRequest:
      type: object
      properties:
        minimumleeftijd:
          maximum: 150
          minimum: 0
          type: integer
          description: De minimum leeftijd voor de doelgroep
          format: int32
          default: 0
        maximumleeftijd:
          maximum: 150
          minimum: 0
          type: integer
          description: De maximum leeftijd voor de doelgroep
          format: int32
          default: 150
      additionalProperties: false
      description: >-
        De doelgroep waar de activiteiten van deze vereniging zich op
        concentreert
    AssociationRegistry.Admin.Api.Verenigingen.Common.ToeTeVoegenContactgegeven:
      type: object
      properties:
        contactgegeventype:
          type: string
          description: "Het type contactgegeven\r\n\r\nMogelijke waarden:\r\n- E-mail\r\n- SocialMedia\r\n- Telefoon\r\n- Website"
          example: E-mail
        waarde:
          type: string
          description: De waarde van het contactgegeven
        beschrijving:
          maxLength: 128
          type: string
          description: >-
            Vrij veld die het het contactgegeven beschrijft (bijv: algemeen,
            administratie, ...)
        isPrimair:
          type: boolean
          description: Duidt het contactgegeven aan als primair contactgegeven
      additionalProperties: false
      description: Het toe te voegen contactgegeven
    AssociationRegistry.Admin.Api.Verenigingen.Common.ToeTeVoegenLocatie:
      type: object
      properties:
        locatietype:
          type: string
          description: "Het soort locatie dat beschreven wordt<br /><br />\r\nMogelijke waarden:<br />\r\n- Activiteiten<br />\r\n- Correspondentie - Slechtséén maal mogelijk<br />"
        isPrimair:
          type: boolean
          description: Duidt aan dat dit de primaire locatie is
        naam:
          maxLength: 128
          type: string
          description: Een beschrijvende naam voor de locatie
        adresId:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Common.AdresId
          description: De unieke identificator van het adres in een andere bron
        adres:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Common.Adres
          description: Het adres van de locatie
      additionalProperties: false
      description: Een locatie van een vereniging
    AssociationRegistry.Admin.Api.Verenigingen.Common.ToeTeVoegenVertegenwoordiger:
      type: object
      properties:
        insz:
          type: string
          description: >-
            Dit is de unieke identificatie van een vertegenwoordiger, dit kan
            een rijksregisternummer of bisnummer zijn
        voornaam:
          type: string
          description: De voornaam van de vertegenwoordiger
        achternaam:
          type: string
          description: De achternaam van de vertegenwoordiger
        rol:
          type: string
          description: Dit is de rol van de vertegenwoordiger binnen de vereniging
        roepnaam:
          type: string
          description: Dit is de roepnaam van de vertegenwoordiger
        isPrimair:
          type: boolean
          description: >-
            Dit duidt aan dat dit de unieke primaire contactpersoon is voor alle
            communicatie met overheidsinstanties
        e-mail:
          type: string
          description: Het e-mailadres van de vertegenwoordiger
        telefoon:
          type: string
          description: Het telefoonnummer van de vertegenwoordiger
        mobiel:
          type: string
          description: Het mobiel nummer van de vertegenwoordiger
        socialMedia:
          type: string
          description: Het socialmedia account van de vertegenwoordiger
      additionalProperties: false
      description: Een vertegenwoordiger van een vereniging
    AssociationRegistry.Admin.Api.Verenigingen.Contactgegevens.FeitelijkeVereniging.VoegContactGegevenToe.RequestsModels.VoegContactgegevenToeRequest:
      type: object
      properties:
        contactgegeven:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Common.ToeTeVoegenContactgegeven
          description: Het toe te voegen contactgegeven
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Contactgegevens.FeitelijkeVereniging.WijzigContactgegeven.RequestModels.TeWijzigenContactgegeven:
      type: object
      properties:
        waarde:
          type: string
          description: De waarde van het contactgegeven
        beschrijving:
          maxLength: 128
          type: string
          description: >-
            Vrij veld die het het contactgegeven beschrijft (bijv: algemeen,
            administratie, ...)
        isPrimair:
          type: boolean
          description: Duidt het contactgegeven aan als primair contactgegeven
      additionalProperties: false
      description: Het te wijzigen contactgegeven
    AssociationRegistry.Admin.Api.Verenigingen.Contactgegevens.FeitelijkeVereniging.WijzigContactgegeven.RequestModels.WijzigContactgegevenRequest:
      type: object
      properties:
        contactgegeven:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Contactgegevens.FeitelijkeVereniging.WijzigContactgegeven.RequestModels.TeWijzigenContactgegeven
          description: Het te wijzigen contactgegeven
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Contactgegevens.VerenigingMetRechtspersoonlijkheid.WijzigContactgegeven.RequestModels.TeWijzigenContactgegeven:
      type: object
      properties:
        beschrijving:
          maxLength: 128
          type: string
          description: >-
            Vrij veld die het het contactgegeven beschrijft (bijv: algemeen,
            administratie, ...)
        isPrimair:
          type: boolean
          description: Duidt het contactgegeven aan als primair contactgegeven
      additionalProperties: false
      description: Het te wijzigen contactgegeven
    AssociationRegistry.Admin.Api.Verenigingen.Contactgegevens.VerenigingMetRechtspersoonlijkheid.WijzigContactgegeven.RequestModels.WijzigContactgegevenRequest:
      type: object
      properties:
        contactgegeven:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Contactgegevens.VerenigingMetRechtspersoonlijkheid.WijzigContactgegeven.RequestModels.TeWijzigenContactgegeven
          description: Het te wijzigen contactgegeven
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Adres:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        straatnaam:
          type: string
          description: De straat van de locatie
        huisnummer:
          type: string
          description: Het huisnummer van de locatie
        busnummer:
          type: string
          description: Het busnummer van de locatie
        postcode:
          type: string
          description: De postcode van de locatie
        gemeente:
          type: string
          description: De gemeente van de locatie
        land:
          type: string
          description: Het land van de locatie
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.AdresId:
      type: object
      properties:
        broncode:
          type: string
          description: De identificator voor dit adres bij de Adresbron
        bronwaarde:
          type: string
          description: De bron waar het AdresId naar verwijst
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.AdresVerwijzing:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Contactgegeven:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        contactgegevenId:
          type: integer
          description: >-
            De unieke identificatie code van dit contactgegeven binnen de
            vereniging
          format: int32
        contactgegeventype:
          type: string
          description: Het type contactgegeven
        waarde:
          type: string
          description: De waarde van het contactgegeven
        beschrijving:
          maxLength: 128
          type: string
          description: >-
            Vrij veld die het het contactgegeven beschrijft (bijv: algemeen,
            administratie, ...)
        isPrimair:
          type: boolean
          description: Duidt het contactgegeven aan als primair contactgegeven
        bron:
          type: string
          description: "De bron die dit contactgegeven beheert\r\n           <br />\r\n               Mogelijke waarden:<br />\r\n               - Initiator<br />\r\n               - KBO"
      additionalProperties: false
      description: Een contactgegeven van een vereniging
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.DetailVerenigingResponse:
      type: object
      properties:
        '@context':
          type: string
          description: De JSON-LD open data context
        vereniging:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.VerenigingDetail
        metadata:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Metadata
          description: >-
            De metadata van de vereniging, deze bevat bv de datum van laatste
            aanpassing
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.DoelgroepResponse:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        minimumleeftijd:
          type: integer
          description: De minimum leeftijd voor de doelgroep
          format: int32
        maximumleeftijd:
          type: integer
          description: De maximum leeftijd voor de doelgroep
          format: int32
      additionalProperties: false
      description: >-
        De doelgroep waar de activiteiten van deze vereniging zich op
        concentreert
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.GerelateerdeVereniging:
      type: object
      properties:
        kboNummer:
          type: string
          description: Het KBO nummer van de gerelateerde vereniging
        vCode:
          type: string
          description: >-
            De unieke identificator van de gerelateerde vereniging in het
            verenigingsregister
        naam:
          type: string
          description: De naam van de gerelateerde vereniging
        detail:
          type: string
          description: De link naar het beheer detail van de gerelateerde vereniging
        magdaDetail:
          type: string
          description: Magda naar het beheer detail van de gerelateerde vereniging
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.GestructureerdeIdentificator:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        nummer:
          type: string
          description: De externe identificator van de vereniging in de bron
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.HoofdactiviteitVerenigingsloket:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        code:
          type: string
          description: De code van de hoofdactivititeit
        naam:
          type: string
          description: De beschrijving van de hoofdactivititeit
      additionalProperties: false
      description: De hoofdactivititeit van een vereniging volgens het verenigingsloket
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Locatie:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        locatieId:
          type: integer
          description: De unieke identificatie code van deze locatie binnen de vereniging
          format: int32
        locatietype:
          type: string
          description: "Het soort locatie dat beschreven wordt<br /><br />\r\nMogelijke waarden:<br />\r\n- Activiteiten<br />\r\n- Correspondentie - Slechts één maal mogelijk<br />\r\n- Maatschappelijke zetel volgens KBO - Enkel mogelijk voor verenigingen met rechtspersoonlijkheid<br />"
        isPrimair:
          type: boolean
          description: Duidt aan dat dit de primaire locatie is
        naam:
          type: string
          description: Een beschrijvende naam voor de locatie
        adres:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Adres
          description: De adrescomponenten van de locatie
        adresvoorstelling:
          type: string
          description: Een standaard geformatteerde weergave van het adres van de locatie
        adresId:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.AdresId
          description: De identifier van het adres op een externe bron
        verwijstNaar:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.AdresVerwijzing
          description: De verwijzing naar een adres in het adresregister
        bron:
          type: string
          description: "De bron die deze locatie beheert.\r\n            <br />\r\n                Mogelijke waarden:<br />\r\n                - Initiator<br />\r\n                - KBO"
      additionalProperties: false
      description: Een locatie van een vereniging
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Metadata:
      type: object
      properties:
        datumLaatsteAanpassing:
          type: string
          description: >-
            De datum waarop de laatste aanpassing uitgevoerd is op de gegevens
            van de vereniging
      additionalProperties: false
      description: >-
        De metadata van de vereniging, deze bevat bv de datum van laatste
        aanpassing
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Relatie:
      type: object
      properties:
        relatietype:
          type: string
          description: Het type relatie
        andereVereniging:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.GerelateerdeVereniging
          description: de gerelateerde vereniging
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Sleutel:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        bron:
          type: string
          description: De bron van de sleutel
        waarde:
          type: string
          description: De externe identificator van de vereniging in de bron
        codeerSysteem:
          type: string
          description: het codeersysteem van de sleutel
        gestructureerdeIdentificator:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.GestructureerdeIdentificator
          description: De gestructureerde identificator
      additionalProperties: false
      description: >-
        Een uniek identificerende sleutel van deze vereniging in een externe
        bron
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.VerenigingDetail:
      type: object
      properties:
        '@type':
          type: string
          description: Het json-ld type
        vCode:
          type: string
          description: De unieke identificatie code van deze vereniging
        corresponderendeVCodes:
          type: array
          items:
            type: string
        verenigingstype:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.VerenigingsType
          description: Het type van deze vereniging
        naam:
          type: string
          description: Naam van de vereniging
        roepnaam:
          type: string
          description: >-
            Roepnaam van de vereniging. Dit veld is enkel aanwezig bij
            verenigingen met rechtspersoonlijkheid
          default: null
        korteNaam:
          type: string
          description: Korte naam van de vereniging
        korteBeschrijving:
          type: string
          description: Korte beschrijving van de vereniging
        startdatum:
          type: string
          description: Datum waarop de vereniging gestart is
        einddatum:
          type: string
          description: Datum waarop de vereniging gestopt is
        doelgroep:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.DoelgroepResponse
          description: >-
            De doelgroep waar de activiteiten van deze vereniging zich op
            concentreert
        status:
          type: string
          description: "Status van de vereniging<br /><br />\r\n                Mogelijke waarden:<br />\r\n                - Actief<br />\r\n                - Gestopt<br />"
        isUitgeschrevenUitPubliekeDatastroom:
          type: boolean
          description: Is deze vereniging uitgeschreven uit de publieke datastroom
        hoofdactiviteitenVerenigingsloket:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.HoofdactiviteitVerenigingsloket
          description: >-
            De hoofdactivititeiten van deze vereniging volgens het
            verenigingsloket
        contactgegevens:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Contactgegeven
          description: De contactgegevens van deze vereniging
        locaties:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Locatie
          description: Alle locaties waar deze vereniging actief is
        vertegenwoordigers:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Vertegenwoordiger
          description: Alle vertegenwoordigers van deze vereniging
        sleutels:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Sleutel
          description: De sleutels van deze vereniging
        relaties:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Relatie
          description: De relaties van deze vereniging
        bron:
          type: string
          description: "De bron die deze vereniging beheert.\r\n                 <br />\r\n                Mogelijke waarden:<br />\r\n                - Initiator<br />\r\n                - KBO"
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.VerenigingsType:
      type: object
      properties:
        code:
          type: string
          description: De code van het type vereniging
        naam:
          type: string
          description: De beschrijving van het type vereniging
      additionalProperties: false
      description: Het type van een vereniging
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.Vertegenwoordiger:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        vertegenwoordigerId:
          type: integer
          description: >-
            De unieke identificatie code van deze vertegenwoordiger binnen de
            vereniging
          format: int32
        insz:
          type: string
          description: Het insz van deze vertegenwoordiger
        voornaam:
          type: string
          description: >-
            Dit is de voornaam van de vertegenwoordiger volgens het
            rijksregister
        achternaam:
          type: string
          description: >-
            Dit is de achternaam van de vertegenwoordiger volgens het
            rijksregister
        roepnaam:
          type: string
          description: Dit is de roepnaam van de vertegenwoordiger
        rol:
          type: string
          description: Dit is de rol van de vertegenwoordiger binnen de vereniging
        isPrimair:
          type: boolean
          description: >-
            Dit duidt aan dat dit de unieke primaire contactpersoon is voor alle
            communicatie met overheidsinstanties
        e-mail:
          type: string
          description: Het e-mailadres van de vertegenwoordiger
        telefoon:
          type: string
          description: Het telefoonnummer van de vertegenwoordiger
        mobiel:
          type: string
          description: Het mobiel nummer van de vertegenwoordiger
        socialMedia:
          type: string
          description: Het socialmedia account van de vertegenwoordiger
        vertegenwoordigerContactgegevens:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.VertegenwoordigerContactgegevens
          description: de contactgegevens van de vertegenwoordiger
        bron:
          type: string
          description: "De bron die deze vertegenwoordiger beheert.\r\n           <br />\r\n               Mogelijke waarden:<br />\r\n               - Initiator<br />\r\n               - KBO"
      additionalProperties: false
      description: Een vertegenwoordiger van een vereniging
    AssociationRegistry.Admin.Api.Verenigingen.Detail.ResponseModels.VertegenwoordigerContactgegevens:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        isPrimair:
          type: boolean
          description: >-
            Dit duidt aan dat dit de unieke primaire contactpersoon is voor alle
            communicatie met overheidsinstanties
        e-mail:
          type: string
          description: Het e-mailadres van de vertegenwoordiger
        telefoon:
          type: string
          description: Het telefoonnummer van de vertegenwoordiger
        mobiel:
          type: string
          description: Het mobiel nummer van de vertegenwoordiger
        socialMedia:
          type: string
          description: Het socialmedia account van de vertegenwoordiger
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Historiek.ResponseModels.HistoriekGebeurtenisResponse:
      type: object
      properties:
        beschrijving:
          type: string
          description: De beschrijving van de gebeurtenis
        gebeurtenis:
          type: string
          description: Het type van de gebeurtenis
        data:
          description: De relevante data die hoort bij de gebeurtenis
        initiator:
          type: string
          description: Instantie die de vereniging heeft geregistreerd of gewijzigd
        tijdstip:
          type: string
          description: Het tijdstip waarop de gebeurtenis plaatsvond
      additionalProperties: false
      description: Een gebeurtenis van een vereniging
    AssociationRegistry.Admin.Api.Verenigingen.Historiek.ResponseModels.HistoriekResponse:
      type: object
      properties:
        '@context':
          type: string
          description: De JSON-LD open data context
        vCode:
          type: string
          description: De unieke identificatie code van deze vereniging
        gebeurtenissen:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Historiek.ResponseModels.HistoriekGebeurtenisResponse
          description: Alle gebeurtenissen van deze vereniging
      additionalProperties: false
      description: Alle gebeurtenissen van deze vereniging
    AssociationRegistry.Admin.Api.Verenigingen.Locaties.FeitelijkeVereniging.VoegLocatieToe.RequestModels.VoegLocatieToeRequest:
      type: object
      properties:
        locatie:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Common.ToeTeVoegenLocatie
          description: Een locatie van een vereniging
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Locaties.FeitelijkeVereniging.WijzigLocatie.RequestModels.TeWijzigenLocatie:
      type: object
      properties:
        locatietype:
          type: string
          description: "Het soort locatie dat beschreven wordt<br /><br />\r\nMogelijke waarden:<br />\r\n- Activiteiten<br />\r\n- Correspondentie - Slechts één maal mogelijk<br />"
        isPrimair:
          type: boolean
          description: Duidt aan dat dit de primaire locatie is
        naam:
          maxLength: 128
          type: string
          description: Een beschrijvende naam voor de locatie
        adresId:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Common.AdresId
          description: De unieke identificator van het adres in een andere bron
        adres:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Common.Adres
          description: Het adres van de locatie
      additionalProperties: false
      description: Een locatie van een vereniging
    AssociationRegistry.Admin.Api.Verenigingen.Locaties.FeitelijkeVereniging.WijzigLocatie.RequestModels.WijzigLocatieRequest:
      type: object
      properties:
        locatie:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Locaties.FeitelijkeVereniging.WijzigLocatie.RequestModels.TeWijzigenLocatie
          description: Een locatie van een vereniging
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Locaties.VerenigingMetRechtspersoonlijkheid.WijzigMaatschappelijkeZetel.RequestModels.TeWijzigenMaatschappelijkeZetel:
      type: object
      properties:
        isPrimair:
          type: boolean
          description: Duidt aan dat dit de primaire locatie is
        naam:
          maxLength: 128
          type: string
          description: Een beschrijvende naam voor de locatie
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Locaties.VerenigingMetRechtspersoonlijkheid.WijzigMaatschappelijkeZetel.RequestModels.WijzigMaatschappelijkeZetelRequest:
      type: object
      properties:
        locatie:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Locaties.VerenigingMetRechtspersoonlijkheid.WijzigMaatschappelijkeZetel.RequestModels.TeWijzigenMaatschappelijkeZetel
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Registreer.DuplicaatVerenigingContract:
      type: object
      properties:
        vCode:
          type: string
          description: De unieke identificatie code van deze vereniging
        naam:
          type: string
          description: Naam van de vereniging
        korteNaam:
          type: string
          description: Korte naam van de vereniging
        verenigingstype:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Registreer.VerenigingsType
          description: Type van de vereniging
        hoofdactiviteitenVerenigingsloket:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Registreer.HoofdactiviteitVerenigingsloket
          description: >-
            De hoofdactivititeiten van deze vereniging volgens het
            verenigingsloket
        locaties:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Registreer.Locatie
          description: Alle locaties waar deze vereniging actief is
        links:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Registreer.VerenigingLinks
          description: Weblinks i.v.m. deze vereniging
      additionalProperties: false
      description: Een mogelijke duplicaat van de te registreren vereniging
    AssociationRegistry.Admin.Api.Verenigingen.Registreer.FeitelijkeVereniging.RequetsModels.RegistreerFeitelijkeVerenigingRequest:
      required:
        - naam
      type: object
      properties:
        naam:
          type: string
          description: Naam van de vereniging
        korteNaam:
          type: string
          description: Korte naam van de vereniging
        korteBeschrijving:
          type: string
          description: Korte beschrijving van de vereniging
        startdatum:
          type: string
          description: >-
            Datum waarop de vereniging gestart is. Deze datum mag niet later
            zijn dan vandaag
          format: date
        doelgroep:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Common.DoelgroepRequest
          description: >-
            De doelgroep waar de activiteiten van deze vereniging zich op
            concentreert
        isUitgeschrevenUitPubliekeDatastroom:
          type: boolean
          description: Is deze vereniging uitgeschreven uit de publieke datastroom
        contactgegevens:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Common.ToeTeVoegenContactgegeven
          description: De contactgegevens van deze vereniging
        locaties:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Common.ToeTeVoegenLocatie
          description: Alle locaties waar deze vereniging actief is
        vertegenwoordigers:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Common.ToeTeVoegenVertegenwoordiger
          description: De vertegenwoordigers van deze vereniging
        hoofdactiviteitenVerenigingsloket:
          type: array
          items:
            type: string
          description: De codes van de hoofdactivititeiten volgens het verenigingsloket
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Registreer.HoofdactiviteitVerenigingsloket:
      type: object
      properties:
        code:
          type: string
          description: De code van de hoofdactivititeit
        naam:
          type: string
          description: De beschrijving van de hoofdactivititeit
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Registreer.Locatie:
      type: object
      properties:
        locatietype:
          type: string
          description: Het soort locatie dat beschreven wordt
        isPrimair:
          type: boolean
          description: Duidt aan dat dit de primaire locatie is
        adresvoorstelling:
          type: string
          description: Het samengestelde adres van de locatie
        naam:
          type: string
          description: Een beschrijvende naam voor de locatie
        postcode:
          type: string
          description: Het busnummer van de locatie
        gemeente:
          type: string
          description: De gemeente van de locatie
      additionalProperties: false
      description: Een locatie van een vereniging
    AssociationRegistry.Admin.Api.Verenigingen.Registreer.MetRechtspersoonlijkheid.RequestModels.RegistreerVerenigingUitKboRequest:
      required:
        - kboNummer
      type: object
      properties:
        kboNummer:
          type: string
          description: Kbo nummer van de vereniging
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Registreer.PotentialDuplicatesResponse:
      type: object
      properties:
        bevestigingsToken:
          type: string
          description: "Dit token wordt gebruikt als bevestiging dat de vereniging uniek is en geregistreerd mag worden,\r\n            ondanks de voorgestelde duplicaten."
          readOnly: true
        mogelijkeDuplicateVerenigingen:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Registreer.DuplicaatVerenigingContract
          description: "Een lijst van verenigingen die mogelijks een duplicaat zijn\r\n            van de vereniging uit de registreer aanvraag"
          readOnly: true
        instance:
          type: string
          description: URI naar de specifieke instantie van dit probleem.
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Registreer.VerenigingLinks:
      type: object
      properties:
        detail:
          type: string
          description: De link naar het beheer detail van de vereniging
          format: uri
        magdaDetail:
          type: string
          description: Magda link naar het beheer detail van de vereniging
          format: uri
      additionalProperties: false
      description: Weblinks i.v.m. deze vereniging
    AssociationRegistry.Admin.Api.Verenigingen.Registreer.VerenigingsType:
      type: object
      properties:
        code:
          type: string
          description: De code van het type van deze vereniging
        naam:
          type: string
          description: De beschrijving van het type van deze vereniging
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.DoelgroepResponse:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        minimumleeftijd:
          type: integer
          description: De minimum leeftijd voor de doelgroep
          format: int32
        maximumleeftijd:
          type: integer
          description: De maximum leeftijd voor de doelgroep
          format: int32
      additionalProperties: false
      description: >-
        De doelgroep waar de activiteiten van deze vereniging zich op
        concentreert
    AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.GestructureerdeIdentificator:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        nummer:
          type: string
          description: De externe identificator van de vereniging in de bron
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.HoofdactiviteitVerenigingsloket:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        code:
          type: string
          description: De verkorte code van de hoofdactiviteit
        naam:
          type: string
          description: De volledige beschrijving van de hoofdactiviteit
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.Locatie:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        locatietype:
          type: string
          description: "Het soort locatie dat beschreven wordt<br /><br />\r\nMogelijke waarden:<br />\r\n- Activiteiten<br />\r\n- Correspondentie - Slechts één maal mogelijk<br />\r\n- Maatschappelijke zetel volgens KBO - Enkel mogelijk voor verenigingen met rechtspersoonlijkheid<br />"
        isPrimair:
          type: boolean
          description: Is dit de primaire locatie van deze vereniging
        adresvoorstelling:
          type: string
          description: De volledige adresvoorstelling van de locatie
        naam:
          type: string
          description: De naam van de locatie
        postcode:
          type: string
          description: De postcode van de locatie
        gemeente:
          type: string
          description: De gemeente waarin de locatie ligt
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.Metadata:
      type: object
      properties:
        pagination:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.Pagination
          description: De paginatie metaData
      additionalProperties: false
      description: >-
        In deze metadata plaatsen we alle relevante metadata voor de
        zoekopdracht, de paginering informatie
    AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.Pagination:
      type: object
      properties:
        totalCount:
          type: integer
          description: Het totaal aantal verenigingen dat voldoet aan de zoekcriteria
          format: int64
        offset:
          type: integer
          description: Het aantal overgeslagen resultaten
          format: int32
        limit:
          type: integer
          description: Het maximum aantal teruggegeven resultaten
          format: int32
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.SearchVerenigingenResponse:
      type: object
      properties:
        '@context':
          type: string
          description: De JSON-LD open data context
        verenigingen:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.Vereniging
          description: >-
            Dit is de lijst van verenigingen die het resultaat van de
            zoekopdracht zijn
        metadata:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.Metadata
          description: >-
            In deze metadata plaatsen we alle relevante metadata voor de
            zoekopdracht, de paginering informatie
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.Sleutel:
      type: object
      properties:
        '@id':
          type: string
          description: De json-ld id
        '@type':
          type: string
          description: Het json-ld type
        bron:
          type: string
          description: De bron van de sleutel
        waarde:
          type: string
          description: De externe identificator van de vereniging in de bron
        codeerSysteem:
          type: string
          description: het codeersysteem van de sleutel
        gestructureerdeIdentificator:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.GestructureerdeIdentificator
          description: De gestructureerde identificator
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.Vereniging:
      type: object
      properties:
        '@type':
          type: string
          description: Het json-ld type
        vCode:
          type: string
          description: De vCode van de vereniging
        corresponderendeVCodes:
          type: array
          items:
            type: string
          description: De vCodes van de corresponderende verenigingen
        verenigingstype:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.VerenigingsType
          description: Het type van de vereniging
        naam:
          type: string
          description: De naam van de vereniging
        roepnaam:
          type: string
          description: >-
            Roepnaam van de vereniging. Dit veld is enkel aanwezig bij
            verenigingen met rechtspersoonlijkheid
          default: null
        korteNaam:
          type: string
          description: De korte naam van de vereniging
        status:
          type: string
          description: "Status van de vereniging<br /><br />\r\n                Mogelijke waarden:<br />\r\n                - Actief<br />\r\n                - Gestopt<br />"
        startdatum:
          type: string
          description: Datum waarop de vereniging gestart is
        einddatum:
          type: string
          description: Datum waarop de vereniging gestopt is        
        doelgroep:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.DoelgroepResponse
          description: >-
            De doelgroep waar de activiteiten van deze vereniging zich op
            concentreert
        hoofdactiviteitenVerenigingsloket:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.HoofdactiviteitVerenigingsloket
          description: De lijst van hoofdactiviteiten erkend door het vereningingsloket
        locaties:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.Locatie
          description: De locaties waar de vereniging actief is
        sleutels:
          type: array
          items:
            $ref: >-
              #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.Sleutel
          description: De sleutels van deze vereniging
        links:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.VerenigingLinks
          description: Weblinks i.v.m. deze vereniging
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.VerenigingLinks:
      type: object
      properties:
        detail:
          type: string
          description: De link naar het beheer detail van de vereniging
          format: uri
        magdaDetail:
          type: string
          description: Magda link naar het beheer detail van de vereniging
          format: uri
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Search.ResponseModels.VerenigingsType:
      type: object
      properties:
        code:
          type: string
          description: De code van het type vereniging
        naam:
          type: string
          description: De beschrijving van het type vereniging
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Stop.RequestModels.StopVerenigingRequest:
      required:
        - einddatum
      type: object
      properties:
        einddatum:
          type: string
          description: De datum waarop de vereniging gestopt werd.
          format: date
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Vertegenwoordigers.FeitelijkeVereniging.VoegVertegenwoordigerToe.RequestModels.VoegVertegenwoordigerToeRequest:
      type: object
      properties:
        vertegenwoordiger:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Common.ToeTeVoegenVertegenwoordiger
          description: De toe te voegen vertegenwoordiger
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.Vertegenwoordigers.FeitelijkeVereniging.WijzigVertegenwoordiger.RequestModels.TeWijzigenVertegenwoordiger:
      type: object
      properties:
        rol:
          type: string
          description: Dit is de rol van de vertegenwoordiger binnen de vereniging
        roepnaam:
          type: string
          description: Dit is de roepnaam van de vertegenwoordiger
        isPrimair:
          type: boolean
          description: >-
            Dit duidt aan dat dit de unieke primaire contactpersoon is voor alle
            communicatie met overheidsinstanties
        e-mail:
          type: string
          description: Het e-mailadres van de vertegenwoordiger
        telefoon:
          type: string
          description: Het telefoonnummer van de vertegenwoordiger
        mobiel:
          type: string
          description: Het mobiel nummer van de vertegenwoordiger
        socialMedia:
          type: string
          description: Het socialmedia account van de vertegenwoordiger
      additionalProperties: false
      description: De te wijzigen vertegenwoordiger
    AssociationRegistry.Admin.Api.Verenigingen.Vertegenwoordigers.FeitelijkeVereniging.WijzigVertegenwoordiger.RequestModels.WijzigVertegenwoordigerRequest:
      type: object
      properties:
        vertegenwoordiger:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Vertegenwoordigers.FeitelijkeVereniging.WijzigVertegenwoordiger.RequestModels.TeWijzigenVertegenwoordiger
          description: De te wijzigen vertegenwoordiger
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.WijzigBasisgegevens.FeitelijkeVereniging.RequestModels.WijzigBasisgegevensRequest:
      type: object
      properties:
        naam:
          type: string
          description: Nieuwe naam van de vereniging
        korteNaam:
          type: string
          description: Nieuwe korte naam van de vereniging
        korteBeschrijving:
          type: string
          description: Nieuwe korte beschrijving van de vereniging
        startdatum:
          type: string
          description: >-
            Nieuwe startdatum (yyyy-MM-dd) van de vereniging. Deze datum mag
            niet later zijn dan vandaag
        doelgroep:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Common.DoelgroepRequest
          description: >-
            De doelgroep waar de activiteiten van deze vereniging zich op
            concentreert
        hoofdactiviteitenVerenigingsloket:
          type: array
          items:
            type: string
          description: >-
            De codes van de nieuwe hoofdactiviteiten volgens het
            verenigingsloket
        isUitgeschrevenUitPubliekeDatastroom:
          type: boolean
          description: >-
            Is deze vereniging uitgeschreven uit de publiek datastroom, dit kan
            enkel gewijzigd worden voor een feitelijke vereniging
      additionalProperties: false
    AssociationRegistry.Admin.Api.Verenigingen.WijzigBasisgegevens.MetRechtspersoonlijkheid.RequestModels.WijzigBasisgegevensRequest:
      type: object
      properties:
        korteBeschrijving:
          type: string
          description: Nieuwe korte beschrijving van de vereniging
        doelgroep:
          allOf:
            - $ref: >-
                #/components/schemas/AssociationRegistry.Admin.Api.Verenigingen.Common.DoelgroepRequest
          description: >-
            De doelgroep waar de activiteiten van deze vereniging zich op
            concentreert
        hoofdactiviteitenVerenigingsloket:
          type: array
          items:
            type: string
          description: >-
            De codes van de nieuwe hoofdactiviteiten volgens het
            verenigingsloket
        roepnaam:
          type: string
          description: De nieuwe roepnaam van de vereniging
      additionalProperties: false
    Be.Vlaanderen.Basisregisters.BasicApiProblem.ProblemDetails:
      type: object
      properties:
        type:
          type: string
          description: URI referentie die het probleem type bepaalt.
        title:
          type: string
          description: Korte omschrijving van het probleem.
        detail:
          type: string
          description: Specifieke details voor dit probleem.
        status:
          type: integer
          description: HTTP status code komende van de server voor dit probleem.
          format: int32
        instance:
          type: string
          description: URI naar de specifieke instantie van dit probleem.
      additionalProperties: false
    Be.Vlaanderen.Basisregisters.BasicApiProblem.ValidationError:
      type: object
      properties:
        code:
          type: string
        reason:
          type: string
      additionalProperties: false
    Be.Vlaanderen.Basisregisters.BasicApiProblem.ValidationProblemDetails:
      type: object
      properties:
        validationErrors:
          type: object
          additionalProperties:
            type: array
            items:
              $ref: >-
                #/components/schemas/Be.Vlaanderen.Basisregisters.BasicApiProblem.ValidationError
          description: Validatie fouten.
        type:
          type: string
          description: URI referentie die het probleem type bepaalt.
        title:
          type: string
          description: Korte omschrijving van het probleem.
        detail:
          type: string
          description: Specifieke details voor dit probleem.
        status:
          type: integer
          description: HTTP status code komende van de server voor dit probleem.
          format: int32
        instance:
          type: string
          description: URI naar de specifieke instantie van dit probleem.
      additionalProperties: false

...

Expand
titleKlik hier om de inhoud te bekijken
Swagger open api macro
displayOperationIdfalse
methodsnone,get,put,post,delete,options,head,patch,trace
validator
defaultModelsExpandDepth1
url
token
defaultModelRenderingexample
filter
password
expandlist
showCommonExtensionsfalse
filename
operations
maxDisplayedTags
attachfalse
showExtensionsfalse
displayRequestDurationfalse
username
order
openapi: 3.0.3
info:
  title: VMSW Woningen
  description: 'This RESTful API is designed to query current data registered at VMSW. Release date October, 2023.'
  contact:
    name: "Magda helpdesk"
    email: helpdesk.magda@vlaanderen.be
  license:
    name: socialeHuisvestingAPI
    url: 'https://overheid.vlaanderen.be/magda'
  version: '0.4'
servers:
  - url: /api/v1/socZek
paths:
  '/socialeHuisvesting/dossiers/zoeken':
    post:
      tags:
        - CIR - Dossiers
      operationId: CIRApi_dossiersZoeken
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        description: Dossier zoek criteria
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DossierDienstZoekCriteria'
            example: {"dossierType":null,"dossierStatus":"REG","dossierNummer":null,"postCode":"3500","aanvragerRijksregisternummer":"65052643390","creatieDatumVanaf":"2023-07-31T00:00:00+00:00","creatieDatumTot":null,"updateDatumVanaf":null,"updateDatumTot":null,"ontvangstDatumVanaf":null,"ontvangstDatumTot":null,"nietGesynchroniseerd":null,"partijCode":null}

      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DossierDienstZoekResultaten'
        204:
          description: No Content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DossierDienstZoekResultaten'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/dossiers/dossier/{dossierNummer}':
    get:
      tags:
        - CIR - Dossiers
      operationId: CIRApi_dossier
      parameters:
        - name: dossierNummer
          in: path
          description: Nummer van het gevraagde dossier
          required: true
          schema:
            type: string
            nullable: true
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DossierDienstDossier'
        204:
          description: No Content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DossierDienstDossier'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'
    put:
      tags:
        - CIR - Dossiers
      operationId: CIRApi_dossierUpdate
      parameters:
        - name: dossierNummer
          in: path
          description: Nummer van het gevraagde dossier
          required: true
          schema:
            type: string
            nullable: true
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        description: bijgerkte dossier informatie
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DossierDienstDossierWijziging'
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: integer
                format: int64
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/dossiers/dossierMetBijlages/{dossierNummer}':
    get:
      tags:
        - CIR - Dossiers
      operationId: CIRApi_dossierMetBijlagen
      summary: Geeft de detail informatie van een welbepaald dossier terug, inclusief de inhoud van de bijlages
      description: "Het CIR centraliseert alle dossiers\r\n<br />Deze methode maakt het mogelijk om alle informatie over een bepaalhet dossier op te halen"
      parameters:
        - name: dossierNummer
          in: path
          description: Nummer van het gevraagde dossier
          required: true
          schema:
            type: string
            nullable: true
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DossierDienstDossier'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/dossiers/bevestigDossierVerwerking':
    post:
      tags:
        - CIR - Dossiers
      operationId: CIRApi_BevestigDossierVerwerking
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        description: Dossier bevestiging
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DossierDienstDossierVersieBevestiging'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: boolean
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/dossiers/wijzigDossierRangschikkingen':
    post:
      tags:
        - CIR - Dossiers
      operationId: CIRApi_WijzigDossierRangschikkingen
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        description: Dossier Ranglijsten
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DossierDienstDossierRanglijstWijzigingen'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: integer
                format: int64
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/dossiers/zwarteLijstMeldingen':
    post:
      tags:
        - CIR - Dossiers
      operationId: CIRApi_ZwartelijstMeldingen
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        description: Zwarte Lijst Melding
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ZwarteLijstMeldingen'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: boolean
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/dossiers/bijlage':
    post:
      tags:
        - CIR - Dossiers
      operationId: CIRApi_bijlage
      summary: >-
        Haalt een specifiek bestand op van een dossier aan de hand van het dossiernummer en bijlage identificatie.
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DossierDienstBijlageCriteria'
      responses:
        200:
          description: Success
          content:
            application/octet-stream:
              schema:
                type: string
                format: binary
                nullable: true
        204:  
          description: No Content
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/dossiers/partijInformatieWijzigingen':
    post:
      tags:
        - CIR - Dossiers
      operationId: CIRApi_PartijInformatieWijziging
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        description: Partij Informatie
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartijInformatieWijzigingen'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: boolean
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/dossiers/zwarteLijstMeldingVoor':
    post:
      tags:
        - CIR - Dossiers
      operationId: CIRApi_zwarteLijstMelding
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetZwarteLijstMeldingVerzoek'
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetZwarteLijstMelding'
        204:
          description: No Content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetZwarteLijstMelding'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/dossiers/verwerkDossierActie':
    post:
      tags:
        - CIR - Dossiers
      operationId: CIRApi_VerwerkDossier
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        description: Zwarte Lijst Melding
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DossierDienstDossierActie'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: boolean
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/gemeentes':
    get:
      tags:
        - CIR - Gemeentes
      operationId: CIRApi_Gemeentes
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GemeenteDienstZoekResultaats'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/gemeentes/wijkenVoorGemeente/{gemeenteNisCode}':
    get:
      tags:
        - CIR - Gemeentes
      operationId: CIRApi_Wijken
      parameters:
        - name: gemeenteNisCode
          in: path
          description: Stad of gemeente code (NIS)
          required: true
          schema:
            type: string
            nullable: true
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GemeenteDienstWijken'
        204:
          description: No Content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GemeenteDienstWijken'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'
    put:
      tags:
        - CIR - Gemeentes
      operationId: CIRApi_GemeenteBijwerken
      parameters:
        - name: gemeenteNisCode
          in: path
          description: NIS Code van de hoofdgemeente
          required: true
          schema:
            type: string
            nullable: true
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        description: Zwarte Lijst Melding
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GemeenteDienstWijken'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: boolean
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/woningen/{vmswWoningId}':
    get:
      tags:
        - CWR-Woningen
      description: Woninggegevens ophalen op basis van het VmswWoningId
      operationId: GET_Woning
      parameters:
        - name: vmswWoningId
          in: path
          required: true
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WoningV2Response'
        400:
          description: Validatiefouten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsValidationErrorExtension'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'
    patch:
      tags:
        - CWR-Woningen
      description: Gegevens van een bestaande woning wijzigen.
      operationId: PATCH_WoningDetailsWijzigen
      parameters:
        - name: vmswWoningId
          in: path
          required: true
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/V2WoningWijzigen'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WoningV2Response'
        400:
          description: Validatiefouten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsValidationErrorExtension'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/woningen':
    get:
      tags:
        - CWR-Woningen
      description: Bestaande woning zoeken.
      operationId: GET_Woningen
      parameters:
        - name: woonmaatschappijWoningId
          in: query
          schema:
            type: string
        - name: woonmaatschappijWoningCode
          in: query
          schema:
            type: string
        - name: gebouweenheidId
          in: query
          schema:
            type: string
        - name: straatnaam
          in: query
          schema:
            type: string
        - name: huisnummer
          in: query
          schema:
            type: string
        - name: busnummer
          in: query
          schema:
            type: string
        - name: postcode
          in: query
          schema:
            type: string
        - name: gemeenteNISCode
          in: query
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WoningV2Response'
        400:
          description: Validatiefouten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsValidationErrorExtension'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'
    post:
      tags:
        - CWR-Woningen
      description: Woning aanmaken bij VMSW.
      operationId: POST_Woning
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/V2WoningToevoegen'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WoningV2Response'
        400:
          description: Validatiefouten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsValidationErrorExtension'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/woningen/{vmswWoningId}/woningkenmerkscores':
    get:
      tags:
        - CWR-Woningkenmerken
      description: Woningkenmerkscores ophalen voor een woning op basis van het VmswWoningId.
      operationId: GET_Woningkenmerkscores
      parameters:
        - name: vmswWoningId
          in: path
          required: true
          schema:
            type: string
        - name: woningKenmerkCategorie
          in: query
          schema:
            $ref: '#/components/schemas/WoningKenmerkCategorie'
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WoningKenmerkScoresResponse'
        400:
          description: Validatiefouten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsValidationErrorExtension'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'
    patch:
      tags:
        - CWR-Woningkenmerken
      description: WoningkenmerkScores updaten voor kenmerken van een specifiek woning.
      operationId: PATCH_Woningkenmerkscores
      parameters:
        - name: vmswWoningId
          in: path
          required: true
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WoningKenmerkScoreWijzigen'
      responses:
        200:
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WoningKenmerkScoresResponse'
        400:
          description: Validatiefouten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsValidationErrorExtension'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'


  '/socialeHuisvesting/woningbezettingen':
    post:
      tags:
        - CWR-Woningen
      summary: Nieuwe bezetting
      operationId: nieuwe-woningbezetting
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/WoningBezetting'
      responses:
        201:
          $ref: '#/components/responses/Response'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/woningbezettingen/{woning-bezetting-id}':
    patch:
      summary: Update bezetting
      tags:
        - CWR-Woningen
      operationId: update-woning-bezetting
      parameters:
        - name: woning-bezetting-id
          in: path
          required: true
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WoningBezetting'
      responses:
        200:
          description: OK
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'
    delete:
      summary: Verwijder bezetting
      description: 'Woonmaatschappij verwijdert informatie over bestaande bezetting in CWR, bijvoorbeeld indien iets foutief doorgestuurd werd'
      operationId: delete-woning-bezetting
      tags:
        - CWR-Woningen
      parameters:
        - name: woning-bezetting-id
          in: path
          required: true
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        204:
          description: No Content
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'
    get:
      operationId: get-woning-bezetting
      parameters:
        - name: woning-bezetting-id
          in: path
          required: true
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      tags:
        - CWR-Woningen
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/notificaties/{registerId}/messages/head':
    post:
      tags:
        - Notificaties
      summary: Lees en vergrendel bericht
      description: >-
        Het bericht dat gelezen wordt, wordt gelocked en moet nadien opnieuw
        worden vrijgegeven via een PUT call.
      operationId: POST_Messages
      parameters:
        - name: registerId
          in: path
          required: true
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        201:
          description: Message successfully retrieved and locked.
          headers:
            Content-Type:
              required: true
              schema:
                type: string
                description: Media-type of the resource
                default: application/atom+xml;type=entry;charset=utf-8
            BrokerProperties:
              description: >-
                JSON-encoded representation for the unit of communication
                between Service Bus clients. More info on:
                https://learn.microsoft.com/en-us/rest/api/servicebus/message-headers-and-properties
              required: true
              schema:
                type: object
              example:
                CorrelationId: 44d276e3-81a6-410c-a1ba-06573f254851
                LockToken: 73f378c2-2c64-403b-91df-a711cc56cbb0
                MessageId: random string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsynchroonBerichtResponse'
        204:
          description: No messages available within the specified timeout period.
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'
    delete:
      tags:
        - Notificaties
      summary: Lees en verwijder bericht
      operationId: LeesEnVerwijderBericht
      parameters:
        - name: registerId
          in: path
          required: true
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: OK
          headers:
            Content-Type:
              required: true
              schema:
                type: string
                description: Media-type of the resource
                default: application/atom+xml;type=entry;charset=utf-8
            BrokerProperties:
              description: >-
                JSON-encoded representation for the unit of communication
                between Service Bus clients. More info on:
                https://learn.microsoft.com/en-us/rest/api/servicebus/message-headers-and-properties
              required: true
              schema:
                type: object
              example:
                CorrelationId: 44d276e3-81a6-410c-a1ba-06573f254851
                LockToken: 73f378c2-2c64-403b-91df-a711cc56cbb0
                MessageId: random string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsynchroonBerichtResponse'
        204:
          description: No messages available within the specified timeout period.
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'
  '/socialeHuisvesting/notificaties/{registerId}/messages/{messageId}/{lockToken}':
    put:
      tags:
        - Notificaties
      summary: Ontgrendel bericht
      operationId: PUT_UnlockBericht
      parameters:
        - name: registerId
          in: path
          required: true
          schema:
            type: string
        - name: messageId
          in: path
          description: ''
          required: true
          schema:
            type: string
        - name: lockToken
          in: path
          description: ''
          required: true
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: Message successfully unlocked.
          headers:
            Content-Type:
              required: true
              schema:
                type: string
                description: Media-type of the resource
                default: application/atom+xml;type=entry;charset=utf-8
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'
    delete:
      tags:
        - Notificaties
      summary: Verwijder bericht
      operationId: DELETE_Bericht
      parameters:
        - name: registerId
          in: path
          required: true
          schema:
            type: string
        - name: messageId
          in: path
          description: ''
          required: true
          schema:
            type: string
        - name: lockToken
          in: path
          description: ''
          required: true
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: Message successfully deleted.
          headers:
            Content-Type:
              required: true
              schema:
                type: string
                description: Media-type of the resource
                default: application/atom+xml;type=entry;charset=utf-8
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/woningen/{vmswWoningId}/markthuurwaarden':
    get:
      tags:
        - CWR-Markthuurwaarden
      description: Markthuurwaarden ophalen voor een woning op basis van het VmswWoningId.
      operationId: GET_GeefMarkthuurwaarde
      parameters:
        - name: vmswWoningId
          in: path
          required: true
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarkthuurwaardeResponse'
        400:
          description: Validatiefouten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsValidationErrorExtension'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'
  '/socialeHuisvesting/woningen/markthuurwaarden/simulatie':
    post:
      tags:
        - CWR-Markthuurwaarden
      description: Markthuurwaarden berekenen op basis van opgegeven (tijdelijke) woningkenmerkscores. Deze scores worden NIET opgeslagen.
      operationId: POST_SimuleerMarkthuurwaarde
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WoningKenmerkScoreLijst'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarkthuurwaardeSimulatieResponse'
        204:
          description: No messages available within the specified timeout period.
        400:
          description: Validatiefouten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsValidationErrorExtension'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/woningen/{vmswWoningId}/conditiescore':
    get:
      tags:
        - CWR-Conditiescore
      description: Conditiescore ophalen voor een woning op basis van het VmswWoningId.
      operationId: GET_GeefConditiescore
      parameters:
        - name: vmswWoningId
          in: path
          required: true
          schema:
            type: string
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConditiescoreResponse'
        400:
          description: Validatiefouten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsValidationErrorExtension'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/woningen/conditiescore/simulatie':
    post:
      tags:
        - CWR-Conditiescore
      description: Conditiescore berekenen op basis van opgegeven (tijdelijke) woningkenmerkscores. Deze scores worden NIET opgeslagen.
      operationId: POST_SimuleerConditiescore
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WoningKenmerkScoreLijst'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConditiescoreSimulatieResponse'
        204:
          description: No messages available within the specified timeout period.
        400:
          description: Validatiefouten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsValidationErrorExtension'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'

  '/socialeHuisvesting/woningen/{vmswWoningId}/energiecorrectie':
    get:
      tags:
        - CWR-Energiecorrectie
      description: Energiecorrectie data ophalen voor een woning op basis van het VmswWoningId.
      operationId: GET_GeefEnergiecorrectie
      parameters:
        - name: vmswWoningId
          in: path
          required: true
          schema:
            type: string
        - name: epcVersie
          in: query
          required: true
          schema:
            $ref: '#/components/schemas/EpcVersie'
            default: Huidig
        - name: datumVanaf
          in: query
          required: true
          schema:
            type: string
            format: date
        - name: datumTot
          in: query
          required: true
          schema:
            type: string
            format: date
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WoningEnergiecorrectieResponse'
        400:
          description: Validatiefouten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsValidationErrorExtension'
        401:
          $ref: '#/components/responses/InvalidAuthorization'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/UnexpectedServerError'
        502:
          $ref: '#/components/responses/BadGateway'
        503:
          $ref: '#/components/responses/ServiceUnavailable'
        504:
          $ref: '#/components/responses/GatewayTimeout'


components:
  responses:
    #HTTP Status 400
    BadRequest:
      description: "Invalid data supplied"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 401
    InvalidAuthorization:
      description: "Invalid authorization"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 403
    Forbidden:
      description: "Authentication failed"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 404
    NotFound:
      description: "Resource not found"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 412
    PreConditionFailed:
      description: Precondition Failed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 500
    UnexpectedServerError:
      description: "Unexpected Server Error"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 502
    BadGateway:
      description: "Bad Gateway"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 503
    ServiceUnavailable:
      description: "Service unavailable"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    #HTTP Status 504
    GatewayTimeout:
      description: "Gateway Timeout"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    Response:
      description: The object containing the result
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Response'
  schemas:
    Correlation-Id:
      description: "ID of the transaction. Use this ID for log tracing and incident handling."
      type: string
      maxLength: 36
      minLength: 10

    #----------------------- START CIR payloads to be replaced -------------------------------

    DossierDienstZoekCriteria:
      type: object
      properties:
        dossierType:
          $ref: '#/components/schemas/RegistrationDossierTypeWaarden'
        dossierStatus:
          $ref: '#/components/schemas/DossierStatusCodeWaarden'
        dossierNummer:
          maxLength: 15
          type: string
          description: Dossiernummer
          nullable: true
        postCode:
          maxLength: 15
          type: string
          description: Postcode van de personen in het dossier.
          nullable: true
        aanvragerRijksregisternummer:
          maxLength: 15
          type: string
          description: Rijksregisternummer van de personen in het dossier.
          nullable: true
        creatieDatumVanaf:
          type: string
          description: Vroegste datum waarop het dossier werd aangemaakt.
          format: date-time
          nullable: true
        creatieDatumTot:
          type: string
          description: Laatste datum waarop het dossier werd aangemaakt.
          format: date-time
          nullable: true
        updateDatumVanaf:
          type: string
          description: Vroegste datum waarop het dossier werd gewijzigd.
          format: date-time
          nullable: true
        updateDatumTot:
          type: string
          description: Laatste datum waarop het dossier werd gewijzigd.
          format: date-time
          nullable: true
        ontvangstDatumVanaf:
          type: string
          description: Vroegste datum waarop het dossier ontvangen werd in het CIR.
          format: date-time
          nullable: true
        ontvangstDatumTot:
          type: string
          description: Laatste datum waarop het dossier ontvangen werd in het CIR.
          format: date-time
          nullable: true
        nietGesynchroniseerd:
          type: boolean
          description: >-
            Geeft aan of de laatste versie van het dossier reeds werd
            gesynchroniseerd.
          nullable: true
        partijCode:
          maxLength: 15
          type: string
          description: >-
            KBO nummer of CIR code van de partij die betrokken is bij het
            dossier.
          nullable: true
      additionalProperties: false
      nullable: true
    DossierDienstZoekResultaat:
      type: object
      properties:
        dossierType:
          $ref: '#/components/schemas/RegistrationDossierTypeWaarden'
        dossierStatus:
          $ref: '#/components/schemas/DossierStatusCodeWaarden'
        dossierNummer:
          maxLength: 15
          type: string
          nullable: true
        inschrijvingsDatum:
          type: string
          format: date-time
          nullable: true
        creatieDatum:
          type: string
          format: date-time
        laatsteWijzigingsDatum:
          type: string
          format: date-time
          nullable: true
        voorNaam:
          maxLength: 48
          type: string
          nullable: true
        naam:
          maxLength: 128
          type: string
          nullable: true
        aanvragerRijksregisternummer:
          maxLength: 15
          type: string
          nullable: true
        versieNummer:
          type: integer
          format: int32
      additionalProperties: false
      nullable: true
    RegistrationDossierTypeWaarden:
      enum:
        - RFH
        - RFM
        - VMU
        - RMA
      type: string
      description: >-
        <p>Members:</p><ul><li><i>RFH</i>-Aanvraag voor wonen </li >
        <li><i>RFM</i>-Interne mutatie aanvraag </li > <li><i>VMU</i>-Verplichte
        mutatie </li > <li><i>RMA</i>-Manuele inschrijving </li > </ul>
      nullable: true
    DossierStatusCodeWaarden:
      enum:
        - REG
        - CHKO
        - CHKS
        - OFFER
        - WAITS
        - RJCT
        - RFSD
        - INFOS
        - SAVED
        - TEMP
        - INFOR
        - CHKR
        - WAITO
        - ARCH
        - CNRQ
        - AIIR
        - TREG
      type: string
      description: >-
        <p>Members:</p><ul><li><i>REG</i>-Ingeschreven </li > <li><i>CHKO</i>-in
        onderzoek verhaal </li > <li><i>CHKS</i>-In onderzoek </li >
        <li><i>OFFER</i>-In wacht in aanbod </li > <li><i>WAITS</i>-In wacht op
        eigen vraag </li > <li><i>RJCT</i>-Geschrapt </li >
        <li><i>RFSD</i>-Geweigerd </li > <li><i>INFOS</i>-In onderzoek: extra
        info gevraagd </li > <li><i>SAVED</i>-Opgeslagen </li >
        <li><i>TEMP</i>-Tijdelijk opgeslagen </li >
        <li><i>INFOR</i>-Ingeschreven in onderzoek </li >
        <li><i>CHKR</i>-Ingeschreven in onderzoek </li > <li><i>WAITO</i>-in
        wacht na aanbod </li > <li><i>ARCH</i>-Gearchiveerd </li >
        <li><i>CNRQ</i>-Wachten op dossierdeelname </li > <li><i>AIIR</i>-Extra
        inkomen info gevraagd </li > <li><i>TREG</i>-Tijdelijk na registratie
        </li > </ul>
      nullable: true
    DossierDienstZoekResultaten:
      type: object
      properties:
        dossiers:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstZoekResultaat'
          nullable: true
      additionalProperties: false
      nullable: true
    DossierDienstDossier:
      type: object
      properties:
        dossierStatusHistoriek:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierStatusHistoriek'
          description: Historiek van Statuswijzigingen
          nullable: true
        dossierInkomstenSamenvattingen:
          $ref: '#/components/schemas/DossierDienstDossierInkomstenSamenvattingen'
        dossierPersonen:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierPersoon'
          description: Contacten
          nullable: true
        dossierLocatieVoorkeuren:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierVoorkeurLocatie'
          description: Locatie Voorkeuren
          nullable: true
        dossierOptioneleVoorkeuren:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierOptioneleVoorkeur'
          description: Locatie Voorkeuren
          nullable: true
        dossierEigendommen:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierEigendom'
          description: Eigendommen
          nullable: true
          readOnly: true
        dossierDienstDossierDomicilieHistoriek:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierDomiciliePeriode'
          description: Domicilie Historiek
          nullable: true
          readOnly: true
        dossierBijlages:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierBijlage'
          description: Bijlages
          nullable: true
        dossierBetrokkenPartijen:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierPartij'
          description: Betrokken Partijen (primaire / secundaire verhuurders,...)
          nullable: true
        bewindvoerder:
          $ref: '#/components/schemas/DossierDienstDossierBewindvoerder'
        oudDossier:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstOudDossier'
          nullable: true
        aanvaardingDossiers:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierComment'
          description: Dossier Dienst Dossier Comment
          nullable: true
        dossierZwarteLijsten:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierZwarteLijst'
          description: Dossier Dienst Dossier BlackList
          nullable: true
        dossierPanden:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierPand'
          description: Dossier Dienst Dossier Pand Aanbiedingen
          nullable: true
        dossierHuidigInkomen:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierHuidigInkomen'
          description: Huidig Inkomen
          nullable: true
          readOnly: true
        dossierNummer:
          maxLength: 15
          type: string
          description: DossierNummer
          nullable: true
          example: 2022.09.07.0019
        dossierType:
          $ref: '#/components/schemas/RegistrationDossierTypeWaarden'
        statusCode:
          $ref: '#/components/schemas/DossierStatusCodeWaarden'
        woningVoorkeuren:
          $ref: '#/components/schemas/DossierDienstDossierVoorkeuren'
        inschrijving:
          $ref: '#/components/schemas/DossierDienstDossierInschrijving'
        schrapping:
          $ref: '#/components/schemas/DossierDienstDossierSchrapping'
        woningNood:
          $ref: '#/components/schemas/DossierDienstDossierWoningNood'
        woonsituaties:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierWoonsituatie'
          description: Lijst van woonsituaties voor het dossier
          nullable: true
          readOnly: true
        versieNummer:
          type: integer
          description: Versie nummer van dit dossier
          format: int32
          example: 3
        mogelijkeActies:
          type: array
          items:
            $ref: '#/components/schemas/DossierActieCodeWaarden'
          description: mogelijke acties op het dossier
          nullable: true
        inkomenVoorwaardeStatusCode:
          $ref: '#/components/schemas/InkomenVoorwaardeStatusCodeWaarden'
        eigendomVoorwaardeStatusCode:
          $ref: '#/components/schemas/EigendomVoorwaardeStatusCodeWaarden'
        tijdstipLaatsteHandeling:
          type: string
          description: >-
            Tijdstip waarop het dossier het laatste werd behandeld door
            Kandidaat-huurder, Woonmaatschappij of automatische actie uit het
            CIR.
          format: date-time
          nullable: true
        volmachtWijzigingen:
          $ref: '#/components/schemas/RegistratieVolmachtWijzigingenCodeWaarden'
      additionalProperties: false
      description: Description
      nullable: true
    DossierDienstDossierStatusHistoriek:
      type: object
      properties:
        statusCodeVan:
          $ref: '#/components/schemas/DossierStatusCodeWaarden'
        statusCodeTot:
          $ref: '#/components/schemas/DossierStatusCodeWaarden'
        actie:
          $ref: '#/components/schemas/DossierActieWaarden'
        statusDatum:
          type: string
          description: Datum waarop de status van het dossier wijzigde
          format: date-time
          nullable: true
          example: '2022-10-01T09:45:00.000+02:00'
        partijCode:
          maxLength: 15
          type: string
          description: >-
            KBO nummer of CIR code van de partij die betrokken is bij het
            dossier.
          nullable: true
        commentaar:
          type: string
          description: Notificatie voor gebruiker
          nullable: true
      additionalProperties: false
      description: Historiek van satuswijzigingen
      nullable: true
    DossierDienstDossierInkomstenSamenvattingen:
      type: object
      properties:
        totaalInkomsten:
          type: number
          description: Som van alle inkomsten
          format: double
          nullable: true
        totaalInkomstenGeindexeerd:
          type: number
          description: Geïndexeeerde som van alle inkomsten
          format: double
          nullable: true
        dossierInkomstenSamenvattingen:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierInkomstenSamenvatting'
          description: Inkomsten  Samenvattingen
          nullable: true
          readOnly: true
      additionalProperties: false
      nullable: true
    DossierDienstDossierPersoon:
      type: object
      properties:
        contactTypeCode:
          $ref: '#/components/schemas/ContactTypeCodeWaarden'
        contactAardCode:
          $ref: '#/components/schemas/ContactAardCodeWaarden'
        geboorteDatum:
          type: string
          description: Geboortedatum
          format: date-time
          nullable: true
        rijksregisternummer:
          maxLength: 15
          type: string
          description: Rijksregisternummer
          nullable: true
        voorNaam:
          maxLength: 48
          type: string
          description: Voornaam van contact/gezinslid
          nullable: true
          example: Marc
        naam:
          maxLength: 128
          type: string
          description: Achternaam van het contact/gezinslid
          nullable: true
          example: Molenbergs
        genderCode:
          $ref: '#/components/schemas/GenderCodeWaarden'
        burgelijkeStaatCode:
          $ref: '#/components/schemas/BurgelijkeStaatCodeWaarden'
        mantelzorgGeefCode:
          $ref: '#/components/schemas/MantelzorgCodeWaarden'
        mantelzorgGeefPostcode:
          maxLength: 15
          type: string
          description: >-
            Dit is de postcode van de gemeenten van de derde die mantzorg geeft
            van het  gezinslid.
          nullable: true
        mantelzorgKrijgCode:
          $ref: '#/components/schemas/MantelzorgCodeWaarden'
        mantelzorgKrijgPostcode:
          maxLength: 15
          type: string
          description: >-
            Dit is de postcode van de gemeenten van de derde die mantzorg krijgt
            van het  gezinslid.
          nullable: true
        taalkennisCode:
          $ref: '#/components/schemas/TaalkennisCodeWaarden'
        taalkennisSneltestCode:
          $ref: '#/components/schemas/TaalkennisSneltestCodeWaarden'
        email:
          maxLength: 50
          type: string
          description: E-mailadres van het contact/gezinslid
          nullable: true
          example: Marc.Molenbergs@hotmail.be
        telefoon1:
          maxLength: 15
          type: string
          description: Telefoonnummer van het contact/gezinslid
          nullable: true
          example: 015/43 43 43
        telefoon2:
          maxLength: 15
          type: string
          description: Telefoonnummer van het contact/gezinslid
          nullable: true
          example: 0477 / 43 43 43
        adressen:
          $ref: '#/components/schemas/DossierDienstDossierPersoonAdressen'
        beperkingMutualiteitErkenningCode:
          $ref: '#/components/schemas/BeperkingMutualiteitErkenningCodeWaarden'
        verblijfsAdresCode:
          $ref: '#/components/schemas/VerblijfsAdresCodeWaarden'
        contactInvaliditeitCode:
          $ref: '#/components/schemas/ContactInvaliditeitCodeWaarden'
        werkzaamheidGeschiedenisCode:
          $ref: '#/components/schemas/WerkzaamheidGeschiedenisCodeWaarden'
        contactSubTypeCode:
          $ref: '#/components/schemas/ContactSubTypeCodeWaarden'
        contactAantalKinderenCode:
          $ref: '#/components/schemas/ContactAantalKinderenCodeWaarden'
        contactPersoonTenLaste:
          $ref: '#/components/schemas/RegistratieContactPersoonTenLaste'
        contactErkenningAfhankelijk:
          type: array
          items:
            $ref: '#/components/schemas/RegistratieContactErkenningAfhankelijk'
          description: Geeft aan of de financiële afhankelijkheid erkend is
          nullable: true
          example:
            - LLFP
            - BLIND
            - ULAM
            - ULPA
        registratieContactErkenningInformatieVoorKind:
          type: string
          description: Bijkomende info uit ksz rond handicap
          nullable: true
        registratieContactErkenningInformatieVoorVolwassenen:
          type: string
          description: Bijkomende info uit ksz rond handicap
          nullable: true
        bewindvoerderCode:
          $ref: '#/components/schemas/RegistratieContactBewindvoerderCode'
        bewindvoerderRijksregisternummer:
          maxLength: 15
          type: string
          description: Rijksregisternummer van bewindvoerder (indien bekend)
          nullable: true
          example: '2209280001'
        verbondenAanVennootschap:
          $ref: '#/components/schemas/RegistratieContactVerbondenAanVennootschap'
      additionalProperties: false
      nullable: true
    DossierDienstDossierVoorkeurLocatie:
      type: object
      properties:
        gemeenteNisCode:
          maxLength: 15
          type: string
          description: >-
            Geeft de NIScode van de gemeente weer, waar de Kandidaat-huurder wil
            wonen.
          nullable: true
          example: '41002'
        wijken:
          maxLength: 3000
          type: string
          description: >-
            Geeft de wijk van de gemeente/deelgemeenten weer, waar de
            Kandidaat-huurder wil wonen.
          nullable: true
          example: Ajoin Koté,Amylum Waik
        sorteerIndex:
          type: integer
          description: Sortering van de vragen
          format: int32
          nullable: true
      additionalProperties: false
      nullable: true
    DossierDienstDossierOptioneleVoorkeur:
      type: object
      properties:
        partijCode:
          maxLength: 15
          type: string
          description: >-
            KBO nummer of CIR code van de partij die betrokken is bij het
            dossier.
          nullable: true
          example: '5025'
        optioneleVoorkeurVraagCode:
          $ref: '#/components/schemas/OptioneleVoorkeurVraagCodeWaarden'
        optioneleVoorkeurAntwoordCode:
          maxLength: 5
          type: string
          description: Geeft het antwoord op de optionele voorkeurvragen
          nullable: true
          example: 'YES'
      additionalProperties: false
      nullable: true
    DossierDienstDossierEigendom:
      type: object
      properties:
        rijksregisternummer:
          maxLength: 15
          type: string
          description: Rijksregisternummer gekoppeld aan een eigendom.
          nullable: true
        eigendomTypeCode:
          $ref: '#/components/schemas/EigendomTypeCodeWaarden'
        eigendomAardCode:
          $ref: '#/components/schemas/EigendomAardCodeWaarden'
        waarde:
          maxLength: 15
          type: string
          description: Het percentage van de woning die de persoon bezit.
          nullable: true
        perceelID:
          maxLength: 50
          type: string
          description: Perceel identificatie
          nullable: true
        justificatie:
          type: string
          description: Opmerking van KH bij een gekende eigendom
          nullable: true
        justificatieDeclaratie:
          type: string
          description: Opmerking van KH bij het aangeven van een eigendom
          nullable: true
        straat:
          maxLength: 100
          type: string
          description: Straatnaam van het onroerend goed
          nullable: true
        huisNummer:
          maxLength: 12
          type: string
          description: Huisnummer van het onroerend goed
          nullable: true
        gemeente:
          maxLength: 100
          type: string
          description: Gemeente waarin het onroerend goed zich bevindt
          nullable: true
        postCode:
          maxLength: 15
          type: string
          description: Postcode van de gemeente waarin het onroerend ged zich bevindt
          nullable: true
        gemeenteNisCode:
          maxLength: 15
          type: string
          description: Niscode van de gemeente waarin het onroerend ged zich bevindt
          nullable: true
        landCode:
          maxLength: 5
          type: string
          description: Code van het land waar het onroerend ged zich bevindt
          nullable: true
      additionalProperties: false
      nullable: true
    DossierDienstDossierDomiciliePeriode:
      type: object
      properties:
        landCode:
          maxLength: 5
          type: string
          description: Code van het land waar het gezinslid verbleef
          nullable: true
        rijksregisternummer:
          maxLength: 15
          type: string
          description: Rijksregisternummer gekoppeld aan een dossier.
          nullable: true
          example: '2209280001'
        postCode:
          maxLength: 15
          type: string
          description: Postcode van het adress waar het gezinslid verbleef.
          nullable: true
        gemeente:
          maxLength: 100
          type: string
          description: Gemeente het gezinslid verbleef.
          nullable: true
        gemeenteNisCode:
          maxLength: 15
          type: string
          description: Niscode van de gemeente waar het gezinslid verbleef
          nullable: true
        straat:
          maxLength: 50
          type: string
          description: Straat het gezinslid verbleef.
          nullable: true
        huisNummer:
          maxLength: 15
          type: string
          description: Huisnummer van de woning waarin het gezinslid verbleef.
          nullable: true
        huisNummerBus:
          maxLength: 5
          type: string
          description: Busnummer van de woning waarin het gezinslid verbleef
          nullable: true
        beginDatum:
          type: string
          description: Begindatum vanaf wanneer het gezinslid in de woning verbleef
          format: date-time
          example: '2022-09-25'
        eindDatum:
          type: string
          description: "Einddatum tot wanneer het geznslid in de woning verbleef\r\nEinddatum tot wanneer het geznslid in de woning verbleef"
          format: date-time
          nullable: true
          example: '2022-09-28'
      additionalProperties: false
      nullable: true
    DossierDienstDossierBijlage:
      type: object
      properties:
        bestandNaam:
          maxLength: 225
          type: string
          description: Naam van het bestand
          nullable: true
        bestandGrootte:
          type: integer
          description: Grootte van het bestand
          format: int32
          nullable: true
        bestandExtensieCode:
          $ref: '#/components/schemas/BestandExtensieCodeWaarden'
        identificatie:
          maxLength: 225
          type: string
          description: Identificatie naam van de bijlage
          nullable: true
        indentificatieRijksregisternummer:
          maxLength: 15
          type: string
          description: RRN van persoon die het bestand opgeladen heeft
          nullable: true
        identificatieBestandCode:
          $ref: '#/components/schemas/IdentificatieBestandCodeWaarden'
        identificatieBestandIndex:
          type: integer
          format: int32
        bestand:
          type: string
          description: Het effectieve bestand zelf
          nullable: true
        opmerking:
          type: string
          description: Opmerkingen die bij het bestand kunnen worden toegevoed\
          nullable: true
        bijlageDatum:
          type: string
          description: Datum waarop de bijlage werd toegevoegd
          format: date-time
        aanvaardingBijlageCode:
          $ref: '#/components/schemas/AanvaardingBijlageCodeWaarden'
      additionalProperties: false
      nullable: true
    DossierDienstDossierPartij:
      type: object
      properties:
        partijTypeCode:
          $ref: '#/components/schemas/DossierPartijTypeCodeWaarden'
        partijRolCode:
          $ref: '#/components/schemas/DossierPartijRolCodeWaarden'
        partijIdentificatie:
          type: string
          description: >-
            Ondernemingsnummer van de woonmaatschappij, rijksregisternummer voor
            kandidaat-huurder.
          nullable: true
        postCode:
          maxLength: 15
          type: string
          description: Hoofdzetel van de woonmaatschappij.
          nullable: true
          example: '2830'
        gemeente:
          maxLength: 100
          type: string
          description: Gemeente van de hoofdzetel van de woonmaatschappij
          nullable: true
          example: Willebroek
        gemeenteNisCode:
          maxLength: 15
          type: string
          description: Niscode van de gemeente van de betrokken partij
          nullable: true
        straat:
          maxLength: 100
          type: string
          description: Straat van de hoofdzetel van de woonmaatschappij.
          nullable: true
          example: Bos
        huisNummer:
          maxLength: 12
          type: string
          description: Nummer van de  hoofdzetel van de woonmaatschappij.
          nullable: true
          example: '502'
        huisNummerBus:
          maxLength: 10
          type: string
          description: Busnummer van de hoofdzetel van de woonmaatschappij.
          nullable: true
          example: X
      additionalProperties: false
      description: Alle betrokken partijen(primaire/secundaire verhuurders)
      nullable: true
    DossierDienstDossierBewindvoerder:
      type: object
      properties:
        rijksregisternummer:
          maxLength: 15
          type: string
          description: Rijksregisternummer van bewindgevoerde
          nullable: true
          example: '2209280001'
        voorNaam:
          maxLength: 48
          type: string
          description: Voornaam van bewindvoerder
          nullable: true
          example: Marc
        naam:
          maxLength: 128
          type: string
          description: Achternaam van bewindvoerder
          nullable: true
          example: Molenbergs
        email:
          maxLength: 50
          type: string
          description: E-mailadres van bewindvoerder
          nullable: true
          example: Marc.Molenbergs@hotmail.be
        telefoon1:
          maxLength: 15
          type: string
          description: Telefoonnummer van bewindvoerder
          nullable: true
          example: 015/43 43 43
        telefoon2:
          maxLength: 15
          type: string
          description: Telefoonnummer van bewindvoerder
          nullable: true
          example: 0477 / 43 43 43
        postCode:
          maxLength: 15
          type: string
          description: Postcode van de domicilie van bewindvoerder
          nullable: true
          example: '2830'
        gemeente:
          maxLength: 100
          type: string
          description: Naam van de gemeente van bewindvoerder
          nullable: true
          example: Willebroek
        gemeenteNisCode:
          maxLength: 15
          type: string
          description: Niscode
          nullable: true
          example: 41002A
        landCode:
          maxLength: 5
          type: string
          nullable: true
        straat:
          maxLength: 100
          type: string
          description: Straat van bewindvoerder
          nullable: true
          example: Bos
        huisNummer:
          maxLength: 12
          type: string
          description: Huisnummer van bewindvoerder
          nullable: true
          example: '502'
        huisNummerBus:
          maxLength: 10
          type: string
          description: Bus nr van bewindvoerder
          nullable: true
          example: X
      additionalProperties: false
      nullable: true
    DossierDienstOudDossier:
      type: object
      properties:
        oudDossierNummer:
          maxLength: 250
          type: string
          nullable: true
          example: '2022.03.25.0001 '
        partijCode:
          maxLength: 15
          type: string
          description: >-
            KBO nummer of CIR code van de partij die betrokken is bij het
            dossier.
          nullable: true
          example: '3343'
      additionalProperties: false
      nullable: true
    DossierDienstDossierComment:
      type: object
      properties:
        aanvaardingTypeCode:
          $ref: '#/components/schemas/AanvaardingDossierTypeCode'
        aanvaardingCode:
          $ref: '#/components/schemas/AanvaardingDossierCode'
        opmerking:
          type: string
          description: opmerking aanvaarding
          nullable: true
      additionalProperties: false
      nullable: true
    DossierDienstDossierZwarteLijst:
      type: object
      properties:
        partijIdentificatie:
          maxLength: 15
          type: string
          description: Rijksregisternummer van kandidaat-hurder/ gezinslid
          nullable: true
        reden:
          $ref: '#/components/schemas/ZwarteLijstRedenCodeWaarden'
        datum:
          type: string
          description: Datum waarop de persoon op de zwarte lijst werd gezet
          format: date-time
          nullable: true
      additionalProperties: false
      nullable: true
    DossierDienstDossierPand:
      type: object
      allOf:
        - $ref: '#/components/schemas/DossierDienstDossierPandUpdate'
      properties:
        pandAanbiedingStatus:
          $ref: '#/components/schemas/DossierPandAanbiedingStatusCodeWaarden'
        partijCode:
          type: string
          description: >-
            KBO nummer of CIR code van de partij die betrokken is bij het
            dossier.
          nullable: true
          example: '1234'
        aanbiedingsDatum:
          type: string
          description: Datum van aanmaak van de aanbieding
          format: date-time
          nullable: true
        statusDatum:
          type: string
          description: Datum (laatste) status wijziging
          format: date-time
          nullable: true
      additionalProperties: false
      nullable: true
    DossierDienstDossierHuidigInkomen:
      type: object
      properties:
        rijksregisternummer:
          maxLength: 15
          type: string
          description: Rijksregisternummer gekoppeld aan een dossier.
          nullable: true
        authentiekebron:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierIncomeAuthentiekebron'
          nullable: true
        gewerktLaatste6Maand:
          type: string
          description: >-
            Geeft per maand aan of de kandidaat-huurder werkte of niet (t= heeft
            gewerkt, f= heeft niet gewerkt).
          nullable: true
          example: T;F;T;F;T;F
        schuldenregeling:
          $ref: '#/components/schemas/SchuldenregelingCodeWaarden'
        onderhoudsgelden:
          $ref: '#/components/schemas/OnderhoudsgeldenCodeWaarden'
      additionalProperties: false
      nullable: true
    GenderCodeWaarden:
      enum:
        - MAN
        - VROUW
        - X
      type: string
      description: >-
        Gender Code (GNDR)<p>Members:</p><ul><li><i>MAN</i>-Mannelijk </li >
        <li><i>VROUW</i>-Vrouwelijk </li > <li><i>X</i>-Onbekend </li > </ul>
      nullable: true
    DossierDienstDossierVoorkeuren:
      type: object
      properties:
        maximaalHuurBedrag:
          type: integer
          description: Maximale huurbedrag die de kandidaathuurder wenst te betalen
          format: int32
          nullable: true
        maximaalHuurLast:
          type: integer
          description: Maximale huurlast die de kandidaathuurder wenst te betalen
          format: int32
          nullable: true
          example: 500
        minimumAantalKamers:
          type: integer
          description: Het minimaal aantal kamers die het gezin wenst
          format: int32
          nullable: true
          example: 2
        maximumAantalKamers:
          type: integer
          description: Het maximaal aantal kamers die het gezin wenst
          format: int32
          nullable: true
          example: 3
        woningTypeCode:
          type: array
          items:
            $ref: '#/components/schemas/WoningTypeCodeWaarden'
          description: Type van de woning die het gezin wenst
          nullable: true
          example:
            - H
        lichamelijkeBeperkingCode:
          $ref: '#/components/schemas/LichamelijkeBeperkingCodeWaarden'
      additionalProperties: false
      description: Woning voorkeuren voor het dossier
      nullable: true
    DossierDienstDossierInschrijving:
      type: object
      properties:
        hulpCode:
          $ref: '#/components/schemas/InschrijfhulpCodeWaarden'
        hulpInformerenCode:
          $ref: '#/components/schemas/InschrijfhulpInformerenCodeWaarden'
        hulpNaam:
          type: string
          description: Naam van organisatie die KH hielp inschrijven
          nullable: true
        hulpEmail:
          maxLength: 50
          type: string
          description: Email adress van inschrijfhulp
          nullable: true
          example: een.goed.mens@live.be
        datum:
          type: string
          description: Eerste indieningsdatum van het dossier
          format: date-time
          nullable: true
      additionalProperties: false
      description: Inschrijvings data van het dossier
      nullable: true
    DossierDienstDossierSchrapping:
      type: object
      properties:
        datum:
          type: string
          description: Datum van schrapping van het dossier
          format: date-time
          nullable: true
        redenCode:
          $ref: '#/components/schemas/SchrappingRedenCodeWaarden'
      additionalProperties: false
      description: Schrapping informatie binnen het dossier
      nullable: true
    DossierDienstDossierWoningNood:
      type: object
      properties:
        redenCode:
          $ref: '#/components/schemas/WoningnoodRedenEnumCode'
        omschrijving:
          type: string
          description: Woningnood reden omschrijving
          nullable: true
        indentificatie:
          type: string
          description: Identificatie  van de woonnood
          nullable: true
      additionalProperties: false
      description: Woningnood voor het dossier
      nullable: true
    DossierActieCodeWaarden:
      enum:
        - OFFER
        - CCL
        - OBJCT
        - REQI
        - REF
        - RJCT
        - WAIT
        - WAKE
        - VOL
        - ACC
        - APP
        - ARCH
        - FRAUD
        - DEC
        - NCOMP
        - NORES
        - OVRVW
        - REG
        - RSPND
        - SAVE
        - UNDO
        - ACTUA
        - MIGRA
        - NOACT
        - CCLGW
        - NOCOMP
        - CONF
        - UNDNR
        - UNDRF
        - OND
      type: string
      description: >-
        nvarchar(5)<p>Members:</p><ul><li><i>OFFER</i>-Aanbod Maken </li >
        <li><i>CCL</i>-Annuleren </li > <li><i>OBJCT</i>-Annuleren </li >
        <li><i>REQI</i>-Bijkomende informatie vragen </li >
        <li><i>REF</i>-Weigeren </li > <li><i>RJCT</i>-Afwijzen </li >
        <li><i>WAIT</i>-In wacht zetten </li > <li><i>WAKE</i>-Uit wacht halen
        </li > <li><i>VOL</i>-vrijwillig vertrekken </li > <li><i>ACC</i>-Aanbod
        geaccepteerd </li > <li><i>APP</i>-Van toepassing zijn </li >
        <li><i>ARCH</i>-Archief </li > <li><i>FRAUD</i>-frauduleus </li >
        <li><i>DEC</i>-Overleden </li > <li><i>NCOMP</i>-Niet-conform </li >
        <li><i>NORES</i>-Geen antwoord </li > <li><i>OVRVW</i>-Overzicht </li >
        <li><i>REG</i>-Register </li > <li><i>RSPND</i>-Antwoorden </li >
        <li><i>SAVE</i>-Opslaan </li > <li><i>UNDO</i>-Ga terug naar de vorige
        echte staat </li > <li><i>ACTUA</i>-Actualisatie </li >
        <li><i>MIGRA</i>-Via de actualisatie zijn wijzigingen aangebracht </li >
        <li><i>NOACT</i>-Actie na 2 jaar inactiviteit </li >
        <li><i>CCLGW</i>-Gegronde weigering door kandidaat-huurder na aanbod
        </li > <li><i>NOCOMP</i>-Schrapping door niet voldoen
        inschrijvingsvoorwaarde </li > <li><i>CONF</i>-Bevestigen van dossier na
        migratie </li > <li><i>UNDNR</i>-Ongedaan maken van vroegere niet
        reactie </li > <li><i>UNDRF</i>-Ongedaan maken van vroegere weigering
        </li > <li><i>OND</i>-Schrapping door ontdubbeling </li > </ul>
      nullable: true
    InkomenVoorwaardeStatusCodeWaarden:
      enum:
        - EI
        - MCN
        - OK
      type: string
      description: >-
        Resultaat van de automatische
        controle<p>Members:</p><ul><li><i>EI</i>-Er is extra informatie nodig
        </li > <li><i>MCN</i>-Er kan momenteel geen controle uitgevoerd worden
        </li > <li><i>OK</i>-U Voldoet </li > </ul>
      nullable: true
    EigendomVoorwaardeStatusCodeWaarden:
      enum:
        - MCN
        - OK
      type: string
      description: >-
        Resultaat van de automatische
        controle<p>Members:</p><ul><li><i>MCN</i>-Er kan momenteel geen controle
        uitgevoerd worden </li > <li><i>OK</i>-U Voldoet </li > </ul>
      nullable: true
    RegistratieVolmachtWijzigingenCodeWaarden:
      enum:
        - 'NO'
        - 'YES'
        - 'UNK'
      type: string
      description: >-
        <p>Members:</p><ul>
        <li><i>NO</i>-Primaire woonmaatschappij mag geen aanpassingen doen op vraag van de KH.</li >
        <li><i>YES</i>-Primaire woonmaatschappij mag aanpassingen doen op vraag van de KH.</li >
        <li><i>UNK</i>-Onbekend</li ></ul>
      nullable: true
    DossierActieWaarden:
      enum:
        - OFFER
        - CCL
        - OBJCT
        - REQI
        - REF
        - RJCT
        - WAIT
        - WAKE
        - VOL
        - ACC
        - APP
        - ARCH
        - FRAUD
        - DEC
        - NCOMP
        - NORES
        - OVRVW
        - REG
        - RSPND
        - SAVE
        - UNDO
        - ACTUA
        - MIGRA
        - NOACT
        - CCLGW
        - NOCOMP
        - CONF
        - UNDNR
        - UNDRF
        - OND
      type: string
      description: >-
        <p>Members:</p><ul><li><i>OFFER</i>-Aanbod Maken </li >
        <li><i>CCL</i>-Annuleren </li > <li><i>OBJCT</i>-Annuleren </li >
        <li><i>REQI</i>-Bijkomende informatie vragen </li >
        <li><i>REF</i>-Weigeren </li > <li><i>RJCT</i>-Afwijzen </li >
        <li><i>WAIT</i>-In wacht zetten </li > <li><i>WAKE</i>-Uit wacht halen
        </li > <li><i>VOL</i>-vrijwillig vertrekken </li > <li><i>ACC</i>-Aanbod
        geaccepteerd </li > <li><i>APP</i>-Van toepassing zijn </li >
        <li><i>ARCH</i>-Archief </li > <li><i>FRAUD</i>-frauduleus </li >
        <li><i>DEC</i>-Overleden </li > <li><i>NCOMP</i>-Niet-conform </li >
        <li><i>NORES</i>-Geen antwoord </li > <li><i>OVRVW</i>-Overzicht </li >
        <li><i>REG</i>-Register </li > <li><i>RSPND</i>-Antwoorden </li >
        <li><i>SAVE</i>-Opslaan </li > <li><i>UNDO</i>-Ga terug naar de vorige
        echte staat </li > <li><i>ACTUA</i>-Actualisatie </li >
        <li><i>MIGRA</i>-Via de actualisatie zijn wijzigingen aangebracht </li >
        <li><i>NOACT</i>-Actie na 2 jaar inactiviteit </li >
        <li><i>CCLGW</i>-Gegronde weigering door kandidaat-huurder na aanbod
        </li > <li><i>NOCOMP</i>-Schrapping door niet voldoen
        inschrijvingsvoorwaarde </li > <li><i>CONF</i>-Bevestigen van dossier na
        migratie </li > <li><i>UNDNR</i>-Ongedaan maken van vroegere niet
        reactie </li > <li><i>UNDRF</i>-Ongedaan maken van vroegere weigering
        </li > <li><i>OND</i>-Schrapping door ontdubbeling </li > </ul>
      nullable: true
    DossierDienstDossierInkomstenSamenvatting:
      type: object
      properties:
        inkomstenJaar:
          type: string
          description: Jaar van het referentie-inkomen
          nullable: true
          example: '2022'
        belastbaarInkomenAanwezigheidCode:
          $ref: '#/components/schemas/BelastbaarInkomenAanwezigheidCodeWaarden'
        belastbaarInkomenJaarTotaal:
          type: number
          description: >-
            Geeft aan hoeveel het totale belastbare inkomen bedraagt op
            jaarbasis.
          format: double
          nullable: true
          example: 12345
        leefLoonAanwezigheidCode:
          $ref: '#/components/schemas/LeefLoonAanwezigheidCodeWaarden'
        leefLoonJaarTotaal:
          type: number
          description: Geeft aan hoeveel het totale leefloon bedraagt op jaarbasis.
          format: double
          nullable: true
          example: 12345
        inkomensVervangendeTegemoetkomingCode:
          $ref: '#/components/schemas/InkomensVervangendeTegemoetkomingCodeWaarden'
        inkomensVervangendeTegemoetkomingJaarTotaal:
          type: number
          description: >-
            Dit is de intensiteit/aard van verblijf dat het gezinslid zal hebben
            in de sociale woning.
          format: double
          nullable: true
          example: 12345
        inkomensPensioenJaarTotaal:
          type: number
          description: Geeft aan hoeveel pensioen het gezinslid krijgt
          format: double
          nullable: true
          example: 12345
        extraBeroepsBuitenlandInkomstenJaarTotaal:
          type: number
          description: Geeft het niet geïndexeerde bedrag van het buitenlandsinkomen
          format: double
          nullable: true
        extraBeroepsInstellingenInkomenstenJaarTotaal:
          type: number
          description: >-
            Geeft het niet-geïndexeerde inkomensbedrag uit Europese of
            internationale instellingen
          format: double
          nullable: true
        rijksregisternummer:
          maxLength: 15
          type: string
          description: Rijksregisternummer gekoppeld aan een dossier.
          nullable: true
      additionalProperties: false
      nullable: true
    ContactTypeCodeWaarden:
      enum:
        - _1
        - _2
        - _3
        - _4
        - _5
        - _6
        - _7
        - _8
        - _9
        - _10
        - _11
        - _12
        - _13
        - _14
        - _15
        - _16
        - _17
        - _20
        - _21
        - _22
        - _23
        - _50
        - _51
        - _0
      type: string
      description: >-
        Contact Type Code
        (RCTPL)<p>Members:</p><ul><li><i>_1</i>-Referentiepersoon </li >
        <li><i>_2</i>-Echtgenoot, Echtgenote </li > <li><i>_3</i>-Zoon, Dochter
        </li > <li><i>_4</i>-Schoonzoon, Schoondochter </li >
        <li><i>_5</i>-Kleinzoon, Kleindochter </li > <li><i>_6</i>-Vader, Moeder
        </li > <li><i>_7</i>-Schoonvader, Schoonmoeder </li >
        <li><i>_8</i>-Grootvader, Grootmoeder </li > <li><i>_9</i>-Broer, Zuster
        </li > <li><i>_10</i>-Schoonbroer, Schoonzuster </li >
        <li><i>_11</i>-Verwant, Verwante </li > <li><i>_12</i>-Zonder
        familieverband </li > <li><i>_13</i>-Stiefzoon, Stiefdochter </li >
        <li><i>_14</i>-Achterkleinzoon, Achterkleindochter </li >
        <li><i>_15</i>-Tante, Oom </li > <li><i>_16</i>-Nicht, Neef
        (verwantschap: 3de graad) </li > <li><i>_17</i>-Nicht, Neef
        (verwantschap: 4de graad) </li > <li><i>_20</i>-Gemeenschappen, tehuizen
        </li > <li><i>_21</i>-Partner </li > <li><i>_22</i>-Wettelijk
        samenwonende </li > <li><i>_23</i>-Meemoederschap </li >
        <li><i>_50</i>-SamenwonendePartner </li > <li><i>_51</i>-Samenwonend
        </li > <li><i>_0</i>-Onbekend </li > </ul>
      nullable: true
    ContactAardCodeWaarden:
      enum:
        - DOM
        - COP
        - VRO
        - OTH
        - SDD
      type: string
      description: >-
        Contact Aard Code
        (RCRT)<p>Members:</p><ul><li><i>DOM</i>-Inwonend(domicilie) </li >
        <li><i>COP</i>-Co-ouderschap </li > <li><i>VRO</i>-Bezoekrecht met
        overnachting </li > <li><i>OTH</i>-Ander soort duurzaam verblijf </li >
        <li><i>SDD</i>-Kind gedomicilieerd in buitenland </li > </ul>
      nullable: true
    BurgelijkeStaatCodeWaarden:
      enum:
        - _10
        - _20
        - _25
        - _26
        - _30
        - _40
        - _41
        - _50
        - _51
        - _60
        - _80
        - _81
        - _90
        - _95
        - _96
        - _97
        - _98
      type: string
      description: >-
        Burgelijke Staat<p>Members:</p><ul><li><i>_10</i>-Ongehuwd </li >
        <li><i>_20</i>-Gehuwd </li > <li><i>_25</i>-Nietigverklaring van het
        huwelijk </li > <li><i>_26</i>-Putatief huwelijk </li >
        <li><i>_30</i>-Weduwenaar </li > <li><i>_40</i>-Echtgescheiden </li >
        <li><i>_41</i>-Echtscheiding uitgesproken met toepassing van de wet van
        30 juni 1994 </li > <li><i>_50</i>-Scheiding van tafel en bed en van
        goederen </li > <li><i>_51</i>-Scheiding van tafel en bed en van
        goederen uitgesproken met toepassing van de wet van 30 juni 1994 </li >
        <li><i>_60</i>-Ontbinding van het huwelijk op een bijzondere wijze </li
        > <li><i>_80</i>-Partnerschap </li > <li><i>_81</i>-Beëindiging
        partnerschap </li > <li><i>_90</i>-Onbepaald </li > <li><i>_95</i>-Op
        verklaring zonder bewijs - Ongehuwd </li > <li><i>_96</i>-Op verklaring
        zonder bewijs - Gehuwd </li > <li><i>_97</i>-Op verklaring zonder bewijs
        – Gescheiden </li > <li><i>_98</i>-Op verklaring zonder bewijs – Weduwe
        (naar) </li > </ul>
      nullable: true
    MantelzorgCodeWaarden:
      enum:
        - 'NO'
        - CARER
        - CAREG
      type: string
      description: >-
        Mantelzorg Code (CARE)<p>Members:</p><ul><li><i>NO</i>-Geen Manterzorg
        </li > <li><i>CARER</i>-Krijgt mantelzorg </li > <li><i>CAREG</i>-Geeft
        mantelzorg </li > </ul>
      nullable: true
    TaalkennisCodeWaarden:
      enum:
        - NA
        - 'NO'
        - 'YES'
      type: string
      description: >-
        Resultaat van authentieke
        bron<p>Members:</p><ul><li><i>NA</i>-Taalkennis kan niet gecontroleerd
        worden </li > <li><i>NO</i>-Taalkennis niet in orde </li >
        <li><i>YES</i>-Taalkennis in orde </li > </ul>
      nullable: true
    TaalkennisSneltestCodeWaarden:
      enum:
        - 'NO'
        - 'YES'
      type: string
      description: >-
        <p>Members:</p><ul><li><i>NO</i>-Taalkennis niet in orde </li >
        <li><i>YES</i>-Taalkennis in orde </li > </ul>
      nullable: true
    DossierDienstDossierPersoonAdressen:
      type: object
      properties:
        contactVoorkeurCode:
          $ref: '#/components/schemas/ContactVoorkeurCodeWaarden'
        domicilie:
          $ref: '#/components/schemas/DossierDienstDossierPersoonAdresDomicilie'
        verblijf:
          $ref: '#/components/schemas/DossierDienstDossierPersoonAdresVerblijf'
        contact:
          $ref: '#/components/schemas/DossierDienstDossierPersoonAdresContact'
      additionalProperties: false
      nullable: true
    BeperkingMutualiteitErkenningCodeWaarden:
      enum:
        - 'NO'
        - 'YES'
      type: string
      description: >-
        Beperking Mutualiteit Erkenning Code
        (RRBM)<p>Members:</p><ul><li><i>NO</i>-Geen beperking erkend door
        mutualiteit </li > <li><i>YES</i>-Beperking erkend door mutualiteit </li
        > </ul>
      nullable: true
    VerblijfsAdresCodeWaarden:
      enum:
        - DOM
        - ALT
      type: string
      description: >-
        Verblijfs Adres Code (RADR)<p>Members:</p><ul><li><i>DOM</i>-Domicilie
        Adress </li > <li><i>ALT</i>-Verblijfs Adress </li > </ul>
      nullable: true
    ContactInvaliditeitCodeWaarden:
      enum:
        - NINV
        - INV
      type: string
      description: >-
        Contact Invaliditeit Code (RCNV)<p>Members:</p><ul><li><i>NINV</i>-Geen
        invaliditeit geregistreerd </li > <li><i>INV</i>-Invalidateit gekend en
        geregistreerd </li > </ul>
      nullable: true
    WerkzaamheidGeschiedenisCodeWaarden:
      enum:
        - Y6M
        - N6M
        - NA
      type: string
      description: >-
        Werkzaamheid Geschiedenis Code
        (RCLH)<p>Members:</p><ul><li><i>Y6M</i>-Heeft de afgelopen 6 maanden
        gewerkt </li > <li><i>N6M</i>-Heeft de afgelopen 6 maanden niet gewerkt
        </li > <li><i>NA</i>-Niet ingevuld </li > </ul>
      nullable: true
    ContactSubTypeCodeWaarden:
      enum:
        - PRGA
        - PRT
        - REU
        - SOJ
      type: string
      description: >-
        Contact Sub Type Code
        (RCSU)<p>Members:</p><ul><li><i>PRGA</i>-Zwangerschap / Adoptie </li >
        <li><i>PRT</i>-Partner </li > <li><i>REU</i>-Familie hereniging </li >
        <li><i>SOJ</i>-Sojourner </li > </ul>
      nullable: true
    ContactAantalKinderenCodeWaarden:
      enum:
        - ONE
        - TWO
        - THRIM
      type: string
      description: >-
        Contact Aantal Kinderen Code (RCNC)<p>Members:</p><ul><li><i>ONE</i>-Een
        </li > <li><i>TWO</i>-Twee </li > <li><i>THRIM</i>-Drie of meer </li >
        </ul>
      nullable: true
    RegistratieContactPersoonTenLaste:
      enum:
        - DEP
        - DDEP
      type: string
      description: >-
        <p>Members:</p><ul><li><i>DEP</i>-Ten laste </li >
        <li><i>DDEP</i>-Dubbel ten laste </li > </ul>
      nullable: true
    RegistratieContactErkenningAfhankelijk:
      enum:
        - LLFP
        - BLIND
        - ULAM
        - ULPA
      type: string
      description: >-
        <p>Members:</p><ul><li><i>LLFP</i>-Onderste ledenmaten vijftig percent
        </li > <li><i>BLIND</i>-Volledige blindheid </li >
        <li><i>ULAM</i>-Bovenste ledenmaten geamputeerd </li >
        <li><i>ULPA</i>-upper limbs paralysed </li > </ul>
      nullable: true
    RegistratieContactBewindvoerderCode:
      enum:
        - 'YES'
        - UNK
      type: string
      description: >-
        <p>Members:</p><ul><li><i>YES</i>-Onder bewindvoering </li >
        <li><i>UNK</i>-Niet gekend </li > </ul>
      nullable: true
    RegistratieContactVerbondenAanVennootschap:
      enum:
        - 'NO'
        - 'YES'
        - UNK
      type: string
      description: >-
        <p>Members:</p><ul><li><i>NO</i>-Kandidaat-huurder is niet verbonden aan
        een vennootschap </li > <li><i>YES</i>-Kandidaat-huurder is verbonden
        aan een vennootschap </li > <li><i>UNK</i>-Onbekend </li > </ul>
      nullable: true
    OptioneleVoorkeurVraagCodeWaarden:
      enum:
        - OPHV
        - OPST
        - OPKO
        - OPLT
        - OPTR
        - OPDN
        - OPWM
      type: string
      description: >-
        <p>Members:</p><ul><li><i>OPHV</i>-Hoogste verdieping waar je wilt
        wonen? </li > <li><i>OPST</i>-Zijn traptreden in het gebouw of de woning
        een probleem? </li > <li><i>OPKO</i>-Heb je een kamer op overschot
        nodig? </li > <li><i>OPLT</i>-Heb je een lift nodig? </li >
        <li><i>OPTR</i>-Heb je een terras nodig? </li > <li><i>OPDN</i>-Heb je
        een douche nodig? </li > <li><i>OPWM</i>-Heb je een aansluiting voor een
        wasmachine nodig? </li > </ul>
      nullable: true
    EigendomTypeCodeWaarden:
      enum:
        - BLE
        - BEBW
        - BEEP
        - BEGB
        - BEGK
        - BEOP
        - BEW
        - EP
        - EVG
        - BAT
        - GB
        - GK
        - SOL
        - ONB
        - OP
        - OPEP
        - VE
        - VEBW
        - VEEP
        - VEGB
        - VEGK
        - VEOP
        - VG
        - VGBW
        - VGEP
        - VGGB
        - VGGK
        - VGOP
        - JUST
      type: string
      description: >-
        Eigendom Type (= Recht Aard) Code
        (ROTP)<p>Members:</p><ul><li><i>BLE</i>-Blote eigendom </li >
        <li><i>BEBW</i>-Blote eigendom bezwaard met een recht van bewoning </li
        > <li><i>BEEP</i>-Blote eigendom bezwaard met een recht van erfpacht
        </li > <li><i>BEGB</i>-Blote eigendom bezwaard met een recht van gebruik
        en bewoning </li > <li><i>BEGK</i>-Blote eigendom bezwaard met een recht
        van gebruik </li > <li><i>BEOP</i>-Blote eigendom bezwaard met een recht
        van opstal </li > <li><i>BEW</i>-Bewoning </li > <li><i>EP</i>-Erfpacht
        </li > <li><i>EVG</i>-Eventueel vruchtgebruik </li >
        <li><i>BAT</i>-Gebouw </li > <li><i>GB</i>-Gebruik en bewoning </li >
        <li><i>GK</i>-Gebruik </li > <li><i>SOL</i>-Eigenaar grond </li >
        <li><i>ONB</i>-Onbekend recht </li > <li><i>OP</i>-Opstal </li >
        <li><i>OPEP</i>-Opstal bezwaard met een recht van erfpacht </li >
        <li><i>VE</i>-Volle eigendom </li > <li><i>VEBW</i>-Volle eigendom
        bezwaard met een recht van bewoning </li > <li><i>VEEP</i>-Volle
        eigendom bezwaard met een recht van erfpacht </li >
        <li><i>VEGB</i>-Volle eigendom bezwaard met een recht van gebruik en
        bewoning </li > <li><i>VEGK</i>-Volle eigendom bezwaard met een recht
        van gebruik </li > <li><i>VEOP</i>-Volle eigendom bezwaard met een recht
        van opstal </li > <li><i>VG</i>-Vruchtgebruik </li >
        <li><i>VGBW</i>-Vruchtgebruik bezwaard met een recht van bewoning </li >
        <li><i>VGEP</i>-Vruchtgebruik bezwaard met een recht van erfpacht </li >
        <li><i>VGGB</i>-Vruchtgebruik bezwaard met een recht van gebruik en
        bewoning </li > <li><i>VGGK</i>-Vruchtgebruik bezwaard met een recht van
        gebruik </li > <li><i>VGOP</i>-Vruchtgebruik bezwaard met een recht van
        opstal </li > <li><i>JUST</i>-Code voor extra justificatie of
        justificatiedeclaratie </li > </ul>
      nullable: true
    EigendomAardCodeWaarden:
      enum:
        - APP
        - TERRB
        - HOME
        - CONS
        - HAYF
        - MEAD
        - TRADH
        - HOTEL
        - STD
        - RM
      type: string
      description: >-
        Eigendom Aard Code (ROKD)<p>Members:</p><ul><li><i>APP</i>-Appartement
        </li > <li><i>TERRB</i>-Bouwgrond </li > <li><i>HOME</i>-Huis </li >
        <li><i>CONS</i>-Bouwland </li > <li><i>HAYF</i>-Hooiland </li >
        <li><i>MEAD</i>-Weiland </li > <li><i>TRADH</i>-Handelshuis </li >
        <li><i>HOTEL</i>-Hotel </li > <li><i>STD</i>-Studio </li >
        <li><i>RM</i>-Kamer </li > </ul>
      nullable: true
    BestandExtensieCodeWaarden:
      enum:
        - JPG
        - JPEG
        - TIF
        - TIFF
        - PDF
        - PNG
        - GIF
      type: string
      description: >-
        <p>Members:</p><ul><li><i>JPG</i>-Jpeg </li > <li><i>JPEG</i>-Jpeg </li
        > <li><i>TIF</i>-Tagged Image File Format </li > <li><i>TIFF</i>-Tagged
        Image File Format </li > <li><i>PDF</i>-Acrobat Reader </li >
        <li><i>PNG</i>-Portable Network Graphic </li > <li><i>GIF</i>-Afbeelding
        </li > </ul>
      nullable: true
    IdentificatieBestandCodeWaarden:
      enum:
        - DM
        - CCTS
        - CCPD
        - CFR
        - CPA
        - INCA
        - INCE
        - INCPS
        - INCYB
        - INCYM
        - INCNB
        - INCNM
        - PRF
        - OWN
        - REJUU
        - REJUS
        - HONE
        - CRCV
        - CGIV
        - PROXY
      type: string
      description: >-
        Identificatie Bestand Code<p>Members:</p><ul><li><i>DM</i>-Bijlage rond
        arbeidsongeschiktheid (wederzijds) </li > <li><i>CCTS</i>-Bijlage rond
        type verblijf </li > <li><i>CCPD</i>-Bijlage rond lichamelijke of
        geestelijke handicap </li > <li><i>CFR</i>-Bijlage rond geplande
        gezinshereniging </li > <li><i>CPA</i>-Bijlage rond zwangerschaps- of
        adoptieprocedure </li > <li><i>INCA</i>-Bijlage rond vrijgestelde
        beroepsinkomsten uit het buitenland </li > <li><i>INCE</i>-Bijlage rond
        vrijgestelde beroepsinkomsten verworven bij Europese of internationale
        instellingen </li > <li><i>INCPS</i>-Tot 3 bijlages voor opeenvolgende
        loonstroken van de afgelopen 6 maanden </li > <li><i>INCYB</i>-Bijlage
        rond collectieve schuldenregeling, budgetbegeleiding of budgetbeheer
        </li > <li><i>INCYM</i>-Bijlage rond onderhoudskosten </li >
        <li><i>INCNB</i>-Bijlage rond collectieve schuldenregeling,
        budgetbegeleiding of budgetbeheer </li > <li><i>INCNM</i>-Bijlage rond
        onderhoudskosten </li > <li><i>PRF</i>-Bijlage rond lichamelijke
        beperking </li > <li><i>OWN</i>-Bijlage over eigendomsbestanden </li >
        <li><i>REJUU</i>-Bijlage over additionele eigendommen </li >
        <li><i>REJUS</i>-Bijlage over bestaande eigendommen </li >
        <li><i>HONE</i>-Bijlage over woonsituatie </li > <li><i>CRCV</i>-Bijlage
        voor mantelzorg ontvanger </li > <li><i>CGIV</i>-Bijlage voor mantelzorg
        gever </li > <li><i>PROXY</i>-Bijlage voor volmacht </li > </ul>
      nullable: true
    AanvaardingBijlageCodeWaarden:
      enum:
        - ACC
        - REJ
        - INC
      type: string
      description: >-
        <p>Members:</p><ul><li><i>ACC</i>-Goedgekeurd </li >
        <li><i>REJ</i>-Afgekeurd </li > <li><i>INC</i>-Extra informatie nodig
        </li > </ul>
      nullable: true
    DossierPartijTypeCodeWaarden:
      enum:
        - PP
        - SVK
        - CPA
        - TWN
        - AMC
        - VMSW
        - SHM
        - VWF
        - PROV
        - INMC
      type: string
      description: >-
        <p>Members:</p><ul><li><i>PP</i>-Private Persoon </li >
        <li><i>SVK</i>-SVK </li > <li><i>CPA</i>-OCMW </li >
        <li><i>TWN</i>-Gemeente </li > <li><i>AMC</i>-Autonoom Gemeentebedrijf
        </li > <li><i>VMSW</i>-VMSW </li > <li><i>SHM</i>-SHM </li >
        <li><i>VWF</i>-VWF </li > <li><i>PROV</i>-Provincie </li >
        <li><i>INMC</i>-Intercommunale </li > </ul>
      nullable: true
    DossierPartijRolCodeWaarden:
      enum:
        - REQ1
        - REQ2
        - CO
        - SUP
        - S
        - P
      type: string
      description: >-
        <p>Members:</p><ul><li><i>REQ1</i>-Referentiehuurder1 </li >
        <li><i>REQ2</i>-Referentiehuurder2 </li > <li><i>CO</i>-Medebewoner </li
        > <li><i>SUP</i>-Ondersteunende parij (OCMW…) </li >
        <li><i>S</i>-Secundaire woonmaatschappij </li > <li><i>P</i>-Primaire
        woonmaatschappij </li > </ul>
      nullable: true
    AanvaardingDossierTypeCode:
      enum:
        - PCOMP
        - WPREF
        - INCOM
        - PROP
        - PLR2
        - PLR3
        - PLR4
      type: string
      description: >-
        <p>Members:</p><ul><li><i>PCOMP</i>-PersoonSamenstelling </li >
        <li><i>WPREF</i>-Woningvoorkeuren </li > <li><i>INCOM</i>-Inkomsten </li
        > <li><i>PROP</i>-Eigendom </li > <li><i>PLR2</i>-Woonnoodpijler2 </li >
        <li><i>PLR3</i>-Woonnoodpijler3 </li > <li><i>PLR4</i>-Woonnoodpijler4
        </li > </ul>
      nullable: true
    AanvaardingDossierCode:
      enum:
        - ACC
        - NCOM
        - FURI
      type: string
      description: >-
        <p>Members:</p><ul><li><i>ACC</i>-Uitzondering toegekend </li >
        <li><i>NCOM</i>-Uitzondering niet toegekend </li > <li><i>FURI</i>-Extra
        informatie nodig </li > </ul>
      nullable: true
    ZwarteLijstRedenCodeWaarden:
      enum:
        - DEF
        - HMNGL
      type: string
      description: >-
        nvarchar(5)<p>Members:</p><ul><li><i>DEF</i>-Wanbetaling </li >
        <li><i>HMNGL</i>-Huisverwaarlozing </li > </ul>
      nullable: true
    DossierDienstDossierPandUpdate:
      type: object
      properties:
        postCode:
          maxLength: 15
          type: string
          description: Postcode van het aangeboden pand
          nullable: true
          example: '2830'
        gemeente:
          maxLength: 100
          type: string
          description: Naam van de gemeente van het aangeboden pand
          nullable: true
          example: Willebroek
        gemeenteNisCode:
          maxLength: 15
          type: string
          description: Niscode
          nullable: true
          example: 41002A
        straat:
          maxLength: 100
          type: string
          description: Straat van het aangeboden pand
          nullable: true
          example: Bos
        huisNummer:
          maxLength: 12
          type: string
          description: Huisnummer van het aangeboden pand
          nullable: true
          example: '502'
        huisNummerBus:
          maxLength: 10
          type: string
          description: Bus nr van het aangeboden pand
          nullable: true
          example: X
        landNisCode:
          maxLength: 5
          type: string
          description: Land code van het aangeboden pand
          nullable: true
      additionalProperties: false
      nullable: true
    DossierPandAanbiedingStatusCodeWaarden:
      enum:
        - OFFER
        - CCL
        - OBJCT
        - REQI
        - REF
        - RJCT
        - WAIT
        - WAKE
        - VOL
        - ACC
        - APP
        - ARCH
        - FRAUD
        - DEC
        - NCOMP
        - NORES
        - OVRVW
        - REG
        - RSPND
        - SAVE
        - UNDO
        - ACTUA
        - MIGRA
        - NOACT
        - CCLGW
        - NOCOMP
        - CONF
        - UNDNR
        - UNDRF
        - OND
      type: string
      description: >-
        nvarchar(5)<p>Members:</p><ul><li><i>OFFER</i>-Aanbod Maken </li >
        <li><i>CCL</i>-Annuleren </li > <li><i>OBJCT</i>-Annuleren </li >
        <li><i>REQI</i>-Bijkomende informatie vragen </li >
        <li><i>REF</i>-Weigeren </li > <li><i>RJCT</i>-Afwijzen </li >
        <li><i>WAIT</i>-In wacht zetten </li > <li><i>WAKE</i>-Uit wacht halen
        </li > <li><i>VOL</i>-vrijwillig vertrekken </li > <li><i>ACC</i>-Aanbod
        geaccepteerd </li > <li><i>APP</i>-Van toepassing zijn </li >
        <li><i>ARCH</i>-Archief </li > <li><i>FRAUD</i>-frauduleus </li >
        <li><i>DEC</i>-Overleden </li > <li><i>NCOMP</i>-Niet-conform </li >
        <li><i>NORES</i>-Geen antwoord </li > <li><i>OVRVW</i>-Overzicht </li >
        <li><i>REG</i>-Register </li > <li><i>RSPND</i>-Antwoorden </li >
        <li><i>SAVE</i>-Opslaan </li > <li><i>UNDO</i>-Ga terug naar de vorige
        echte staat </li > <li><i>ACTUA</i>-Actualisatie </li >
        <li><i>MIGRA</i>-Via de actualisatie zijn wijzigingen aangebracht </li >
        <li><i>NOACT</i>-Actie na 2 jaar inactiviteit </li >
        <li><i>CCLGW</i>-Gegronde weigering door kandidaat-huurder na aanbod
        </li > <li><i>NOCOMP</i>-Schrapping door niet voldoen
        inschrijvingsvoorwaarde </li > <li><i>CONF</i>-Bevestigen van dossier na
        migratie </li > <li><i>UNDNR</i>-Ongedaan maken van vroegere niet
        reactie </li > <li><i>UNDRF</i>-Ongedaan maken van vroegere weigering
        </li > <li><i>OND</i>-Schrapping door ontdubbeling </li > </ul>
      nullable: true
    DossierDienstDossierIncomeAuthentiekebron:
      type: object
      properties:
        inkomenType:
          $ref: '#/components/schemas/HuidigInkomenType'
        jaarMaand:
          maxLength: 15
          type: string
          description: Jaar maand van het inkomen
          nullable: true
        bedrag:
          maxLength: 15
          type: number
          description: Bedrag inkomen
          format: double
          nullable: true
      additionalProperties: false
      nullable: true
    SchuldenregelingCodeWaarden:
      enum:
        - 'YES'
        - 'NO'
        - UNK
      type: string
      description: >-
        <p>Members:</p><ul><li><i>YES</i>-YES </li > <li><i>NO</i>-NO </li >
        <li><i>UNK</i>-UNK </li > </ul>
      nullable: true
    OnderhoudsgeldenCodeWaarden:
      enum:
        - 'YES'
        - 'NO'
        - UNK
      type: string
      description: >-
        <p>Members:</p><ul><li><i>YES</i>-YES </li > <li><i>NO</i>-NO </li >
        <li><i>UNK</i>-UNK </li > </ul>
      nullable: true
    WoningTypeCodeWaarden:
      enum:
        - H
        - R
        - A
        - S
      type: string
      description: >-
        Woning Type (PRES)<p>Members:</p><ul><li><i>H</i>-Huis </li >
        <li><i>R</i>-Kamer </li > <li><i>A</i>-Appartement </li >
        <li><i>S</i>-Studio </li > </ul>
      nullable: true
    LichamelijkeBeperkingCodeWaarden:
      enum:
        - 'NO'
        - 'YES'
      type: string
      description: >-
        Of de KH een aangepaste woning wenst aan medische
        noden<p>Members:</p><ul><li><i>NO</i>-Geen aanpassing voor lichamelijke
        beperking nodig </li > <li><i>YES</i>-Aanpassing voor lichamelijke
        beperking nodig </li > </ul>
      nullable: true
    InschrijfhulpCodeWaarden:
      enum:
        - HC
        - OCMW
        - OTH
        - SUP
        - WH
        - HOEH
      type: string
      description: >-
        Inschrijfhulp Code (RAOP)<p>Members:</p><ul><li><i>HC</i>-Samen met een
        medewerker van de woonmaatschapij </li > <li><i>OCMW</i>-Samen met een
        medewerker van een sociaalHuis </li > <li><i>OTH</i>-Samen met andere
        persoon </li > <li><i>SUP</i>-Samen met begeleider </li >
        <li><i>WH</i>-Zonder Hulp </li > <li><i>HOEH</i>-Gemeentelijk
        woonloket/gemeentelijk woon- en energieloket </li > </ul>
      nullable: true
    InschrijfhulpInformerenCodeWaarden:
      enum:
        - 'NO'
        - 'YES'
      type: string
      description: >-
        Inschrijfhulp Informeren Code
        (PKIS)<p>Members:</p><ul><li><i>NO</i>-Niet Informeren </li >
        <li><i>YES</i>-Informeren </li > </ul>
      nullable: true
    SchrappingRedenCodeWaarden:
      enum:
        - DEAD
        - SNRE
        - SUNR
        - ASGN
        - OWNR
        - NCOM
        - FRAUD
        - JOAN
        - NACT
      type: string
      description: >-
        Schrapping Redenen (RCNC)<p>Members:</p><ul><li><i>DEAD</i>-Overlijden
        </li > <li><i>SNRE</i>-Tweede niet reactie </li > <li><i>SUNR</i>-Tweede
        ongegronde weigering </li > <li><i>ASGN</i>-Toewijzing </li >
        <li><i>OWNR</i>-Eigen vraag </li > <li><i>NCOM</i>-Niet voldoen aan
        voorwaarden </li > <li><i>FRAUD</i>-Frauduleuze verklaringen </li >
        <li><i>JOAN</i>-Gerechterlijk bevel na overlast </li >
        <li><i>NACT</i>-Non-activiteit </li > </ul>
      nullable: true
    WoningnoodRedenEnumCode:
      enum:
        - EHOME
        - UASIL
        - MHP
        - SUBSH
        - SPSC
      type: string
      description: >-
        <p>Members:</p><ul><li><i>EHOME</i>-Personen die dak- en thuisloos zijn
        of dreigen te worden  </li > <li><i>UASIL</i>-Jongeren die zelfstandig
        wonen of gaan wonen met begeleiding door een erkende dienst  </li >
        <li><i>MHP</i>-Personen met geestelijke gezondheidsproblemen  </li >
        <li><i>SUBSH</i>-Personen die in slechte huisvesting wonen  </li >
        <li><i>SPSC</i>-Personen die zich in bijzondere omstandigheden van
        sociale aard bevinden  </li > </ul>
      nullable: true
    BelastbaarInkomenAanwezigheidCodeWaarden:
      enum:
        - TBV
        - SND
        - S6
        - FT
        - UV
      type: string
      description: >-
        Dit veld geeft aan of er inkomen (FOD Financiën) gevonden werden bij de
        authentieke bron en/of ze opgenomen worden in het
        CIR.<p>Members:</p><ul><li><i>TBV</i>-Te verifiëren </li >
        <li><i>SND</i>-Succesvol geverifieerd zonder gegevens </li >
        <li><i>S6</i>-Succesvol geverifieerd </li > <li><i>FT</i>-Verificatie
        mislukt om technische reden </li > <li><i>UV</i>-Niet verifieerbaar of
        verificatie mislukt </li > </ul>
      nullable: true
    LeefLoonAanwezigheidCodeWaarden:
      enum:
        - TBV
        - SND
        - S6
        - FT
        - UV
      type: string
      description: >-
        Dit veld geeft aan of er leefloongegevens gevonden werden bij de
        authentieke bron en/of ze opgenomen worden in het
        CIR.<p>Members:</p><ul><li><i>TBV</i>-Te verifiëren </li >
        <li><i>SND</i>-Succesvol geverifieerd zonder gegevens </li >
        <li><i>S6</i>-Succesvol geverifieerd </li > <li><i>FT</i>-Verificatie
        mislukt om technische reden </li > <li><i>UV</i>-Niet verifieerbaar of
        verificatie mislukt </li > </ul>
      nullable: true
    InkomensVervangendeTegemoetkomingCodeWaarden:
      enum:
        - TBV
        - SND
        - S6
        - FT
        - UV
      type: string
      description: >-
        Dit veld geeft aan of er inkomen vervangende-gegevens gevonden werden
        bij de authentieke bron en/of ze opgenomen worden in het
        CIR.<p>Members:</p><ul><li><i>TBV</i>-Te verifiëren </li >
        <li><i>SND</i>-Succesvol geverifieerd zonder gegevens </li >
        <li><i>S6</i>-Succesvol geverifieerd </li > <li><i>FT</i>-Verificatie
        mislukt om technische reden </li > <li><i>UV</i>-Niet verifieerbaar of
        verificatie mislukt </li > </ul>
      nullable: true
    ContactVoorkeurCodeWaarden:
      enum:
        - ALT
        - DOM
        - OTH
      type: string
      description: >-
        Wat als contactadres gerbuikt mag
        worden<p>Members:</p><ul><li><i>ALT</i>-Verblijfs Adress </li >
        <li><i>DOM</i>-Domicilie Adress </li > <li><i>OTH</i>-Contact Adress
        </li > </ul>
      nullable: true
    DossierDienstDossierPersoonAdresDomicilie:
      type: object
      properties:
        postCode:
          maxLength: 15
          type: string
          description: Postcode van de domicilie van het contact/gezinslid
          nullable: true
          example: '2830'
        gemeente:
          maxLength: 100
          type: string
          description: Naam van de gemeente waar domicilie gevestigd is.
          nullable: true
          example: Willebroek
        gemeenteNisCode:
          maxLength: 15
          type: string
          description: Gemeenteniscode van het domicilie adress
          nullable: true
        landCode:
          maxLength: 5
          type: string
          description: landcode van de domicilie.
          nullable: true
        straat:
          maxLength: 100
          type: string
          description: Naam van de straat waar domicilie gevestigd is.
          nullable: true
          example: Bos
        huisNummer:
          maxLength: 12
          type: string
          description: Huisnummer waar domicilie gevestigd is.
          nullable: true
          example: '502'
        huisNummerBus:
          maxLength: 10
          type: string
          description: Bus van de domicilie.
          nullable: true
          example: X
      additionalProperties: false
      nullable: true
    DossierDienstDossierPersoonAdresVerblijf:
      type: object
      properties:
        postCode:
          maxLength: 15
          type: string
          description: Postcode waar het contact/gezinslid verblijft.
          nullable: true
          example: '2830'
        gemeente:
          maxLength: 100
          type: string
          description: Gemeente waar het contact/gezinslid verblijft
          nullable: true
          example: Willebroek
        gemeenteNisCode:
          maxLength: 15
          type: string
          description: Niscode van verblijf aanvrager
          nullable: true
        landCode:
          maxLength: 5
          type: string
          description: Niscode van verblijf aanvrager
          nullable: true
        straat:
          maxLength: 100
          type: string
          description: Straat van verblijf van aanvrager
          nullable: true
          example: Bos
        huisNummer:
          maxLength: 12
          type: string
          description: Huisnummer van verblijf aanvrager
          nullable: true
          example: '502'
        huisNummerBus:
          maxLength: 10
          type: string
          description: Bus van verbflijf van het contact/gezinslid
          nullable: true
          example: X
      additionalProperties: false
      nullable: true
    DossierDienstDossierPersoonAdresContact:
      type: object
      properties:
        postCode:
          maxLength: 15
          type: string
          description: De postcode van het postadres van het contact/gezinslid.
          nullable: true
          example: '2830'
        gemeente:
          maxLength: 100
          type: string
          description: De gemeente van het postadres van het contact/gezinslid.
          nullable: true
          example: Willebroek
        gemeenteNisCode:
          maxLength: 15
          type: string
          description: Niscode van het postadres van het contact/gezinslid
          nullable: true
        landCode:
          maxLength: 5
          type: string
          description: De landcode van het postadres van het contact/gezinslid.
          nullable: true
        straat:
          maxLength: 100
          type: string
          description: De straat van het postadres van het contact/gezinslid.
          nullable: true
          example: Bos
        huisNummer:
          maxLength: 12
          type: string
          description: Het huisnummer van het postadres van het contact/gezinslid.
          nullable: true
          example: '502'
        huisNummerBus:
          maxLength: 10
          type: string
          description: De busnummer van het postadres van het contact/gezinslid.
          nullable: true
          example: X
      additionalProperties: false
      nullable: true
    HuidigInkomenType:
      enum:
        - PENS
        - LINC
        - IVT
        - UNEMP
        - INCAP
      type: string
      description: >-
        <p>Members:</p><ul><li><i>PENS</i>-Pensioen6m </li >
        <li><i>LINC</i>-Leefloon6m </li > <li><i>IVT</i>-IVT6m </li >
        <li><i>UNEMP</i>-Werkloosheidsuitkering6m </li >
        <li><i>INCAP</i>-Uitkeringarbeidsongeschikdheid6m </li > </ul>
      nullable: true
    DossierDienstDossierWijziging:
      type: object
      properties:
        dossierPersonen:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierPersoonWijziging'
          description: Contacten
          nullable: true
        dossierBijlages:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierUpdateBijlage'
          nullable: true
        aanvaardingDossier:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierAanvaarding'
          nullable: true
        extraBeroepsInkomsten:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierUpdateExtraBeroepsInkomsten'
          nullable: true
        aanvaardingWoonnood:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierUpdateAanvaardingWoonnood'
          nullable: true
      additionalProperties: false
      description: Description
      nullable: true
    DossierDienstDossierPersoonWijziging:
      type: object
      properties:
        rijksregisternummer:
          maxLength: 15
          type: string
          description: RRN
          nullable: true
          example: '2209280001'
        contactPersoonTenLaste:
          $ref: '#/components/schemas/RegistratieContactPersoonTenLaste'
        taalkennisSneltestCode:
          $ref: '#/components/schemas/TaalkennisSneltestCodeWaarden'
      additionalProperties: false
      nullable: true
    DossierDienstDossierUpdateBijlage:
      type: object
      properties:
        identificatie:
          maxLength: 255
          type: string
          description: Identificatie van de bijlage
          nullable: true
        aanvaardingBijlageCode:
          $ref: '#/components/schemas/AanvaardingBijlageCodeWaarden'
        aanvaardingOpmerking:
          type: string
          description: Geeft de opmerking bij de bijlage
          nullable: true
      additionalProperties: false
      nullable: true
    DossierDienstDossierAanvaarding:
      type: object
      properties:
        typeCode:
          $ref: '#/components/schemas/TypeCodeWaarden'
        aanvaardingCode:
          $ref: '#/components/schemas/AanvaardingCodeWaarden'
        opmerking:
          type: string
          description: Opmerking bij de beslissing.
          nullable: true
      additionalProperties: false
      nullable: true
    DossierDienstDossierUpdateAanvaardingWoonnood:
      type: object
      properties:
        identificatie:
          type: integer
          description: ID van de woonsituatie die goedgekeurd moet worden
          format: int64
          nullable: true
        aanvaardingCode:
          $ref: '#/components/schemas/AanvaardingDossierCode'
        conclusie:
          type: string
          description: Conclusie bij de woonnood
          nullable: true
      additionalProperties: false
      nullable: true
    DossierDienstDossierUpdateExtraBeroepsInkomsten:
      type: object
      properties:
        inkomstenType:
          $ref: '#/components/schemas/ExtraBeroepsInkomstenCodeWaarden'
        jaarTotaal:
          type: number
          description: Geeft het jaar waarin het inkomen werd ontvangen
          format: double
          nullable: true
          example: 2022
        rijksregisternummer:
          maxLength: 15
          type: string
          description: Rijksregisternummer
          nullable: true
          example: '2209280001'
      additionalProperties: false
      nullable: true
    TypeCodeWaarden:
      enum:
        - PCOMP
        - WPREF
        - INCOM
        - PROP
        - PLR2
        - PLR3
        - PLR4
      type: string
      description: >-
        <p>Members:</p><ul><li><i>PCOMP</i>-PersoonSamenstelling </li >
        <li><i>WPREF</i>-Woningvoorkeuren </li > <li><i>INCOM</i>-Inkomsten </li
        > <li><i>PROP</i>-Eigendom </li > <li><i>PLR2</i>-Woonnoodpijler2 </li >
        <li><i>PLR3</i>-Woonnoodpijler3 </li > <li><i>PLR4</i>-Woonnoodpijler4
        </li > </ul>
      nullable: true
    AanvaardingCodeWaarden:
      enum:
        - ACC
        - NCOM
        - FURI
      type: string
      description: >-
        <p>Members:</p><ul><li><i>ACC</i>-Uitzondering toegekend </li >
        <li><i>NCOM</i>-Uitzondering niet toegekend </li > <li><i>FURI</i>-Extra
        informatie nodig </li > </ul>
      nullable: true
    ExtraBeroepsInkomstenCodeWaarden:
      enum:
        - FORI
        - INSTI
      type: string
      description: >-
        <p>Members:</p><ul><li><i>FORI</i>-Inkomsten uit het buitenland </li >
        <li><i>INSTI</i>-Inkomsten uit europese of internationale instellingen
        </li > </ul>
      nullable: true
    DossierDienstDossierVersieBevestiging:
      type: object
      properties:
        dossierNummer:
          type: string
          description: nvarchar(15)
          nullable: true
          example: YYY.MM.DD.XXXX
        partijCode:
          type: string
          description: "KBO nummer of CIR code van de partij die betrokken is bij het dossier.\r\n nvarchar(15)"
          nullable: true
        versieNummer:
          type: integer
          description: Int
          format: int32
      additionalProperties: false
      nullable: true
    DossierDienstDossierRanglijstWijzigingen:
      type: object
      properties:
        partijCode:
          maxLength: 15
          type: string
          description: >-
            KBO nummer of CIR code van de partij die betrokken is bij het
            dossier.
          nullable: true
        ranglijstWijzigingen:
          type: array
          items:
            $ref: '#/components/schemas/DossierDienstDossierRanglijstWijziging'
          description: >-
            RanglijstWijzigingen kunnen doorgestuurd worden voor meerdere
            gemeentes voor meerdere dossiers
          nullable: true
      additionalProperties: false
      description: >-
        RanglijstWijzigingen kunnen doorgestuurd worden voor meerdere gemeentes
        voor meerdere dossiers
      nullable: true
    DossierDienstDossierRanglijstWijziging:
      type: object
      properties:
        rangLijstType:
          $ref: '#/components/schemas/RangLijstTypeCodeWaarden'
        dossierNummer:
          maxLength: 15
          type: string
          description: ''
          nullable: true
          example: 2022.09.08.0001
        beperkteRegioKeuze:
          $ref: '#/components/schemas/beperkteregiokeuze'
        lokaleBinding:
          $ref: '#/components/schemas/localebinding'
        gemeenteNisCode:
          maxLength: 15
          type: string
          description: Niscode van de gemeente waar de kandidaat-huurder wil wonen.
          nullable: true
          example: '12100'
        wijk:
          type: string
          description: >-
            Geeft de wijk van de gemeente/deelgemeenten weer, waar de
            Kandidaat-huurder wil wonen.
          nullable: true
        criterium1:
          $ref: '#/components/schemas/RangLijstCriteria1CodeWaarden'
        criterium2:
          maxLength: 500
          type: string
          nullable: true
        criterium3:
          maxLength: 500
          type: string
          nullable: true
        rangschikking:
          type: integer
          description: >-
            Geeft weer op welke plaats de kandidaat-huurder op de wachtlijst
            staat.
          format: int32
          nullable: true
          example: 17
        rangschikkingDatum:
          type: string
          description: >-
            Geeft de datum weer wanneer de kandidaat-huurder op de wachtlijst
            geplaatst werd.
          format: date-time
          nullable: true
      additionalProperties: false
      nullable: true
    RangLijstTypeCodeWaarden:
      enum:
        - PLR1
        - PLR2
        - PLR3
        - PLR4
      type: string
      description: >-
        Rang Lijst Type Code (RRTP)<p>Members:</p><ul><li><i>PLR1</i>-Pijler 1
        </li > <li><i>PLR2</i>-Pijler 2 </li > <li><i>PLR3</i>-Pijler 3 </li >
        <li><i>PLR4</i>-Pijler 4 </li > </ul>
      nullable: true
    beperkteregiokeuze:
      enum:
        - 'YES'
        - 'NO'
        - UNK
      type: string
      description: >-
        <p>Members:</p><ul><li><i>YES</i>-Wel beperkte regiokeuze </li >
        <li><i>NO</i>-Geen beperkte regiokeuze </li > <li><i>UNK</i>-Niet gekend
        </li > </ul>
      nullable: true
    localebinding:
      enum:
        - 'YES'
        - 'NO'
        - UNK
      type: string
      description: >-
        <p>Members:</p><ul><li><i>YES</i>-Wel locale binding </li >
        <li><i>NO</i>-Geen locale binding </li > <li><i>UNK</i>-Niet gekend </li
        > </ul>
      nullable: true
    RangLijstCriteria1CodeWaarden:
      enum:
        - H
        - R
        - A
        - S
        - EHOME
        - UASIL
        - MHP
        - SUBSH
        - SPSC
        - D
        - DERES
        - UOCCU
        - OCRWD
        - NCRAT
        - PRFR
        - NOADA
        - TOEZ
        - REHOU
      type: string
      description: >-
        nvarchar(15)<p>Members:</p><ul><li><i>H</i>-Huis (Pijler 1) </li >
        <li><i>R</i>-Kamer (Pijler 1) </li > <li><i>A</i>-Appartement (Pijler 1)
        </li > <li><i>S</i>-Studio (Pijler 1) </li > <li><i>EHOME</i>-Personen
        die dak- en thuisloos zijn of dreigen te worden (Pijler 2) </li >
        <li><i>UASIL</i>-Jongeren die zelfstandig wonen of gaan wonen met
        begeleiding door een erkende dienst (Pijler 2) </li >
        <li><i>MHP</i>-Personen met geestelijke gezondheidsproblemen (Pijler 2)
        </li > <li><i>SUBSH</i>-Personen die in slechte huisvesting wonen
        (Pijler 2) </li > <li><i>SPSC</i>-Personen die zich in bijzondere
        omstandigheden van sociale aard bevinden (Pijler 2) </li >
        <li><i>D</i>-Specifieke Doelgroep (Pijler 3) </li >
        <li><i>DERES</i>-Sloop, renovatie en verkoop van de sociale huurwoning
        (Pijler 4) </li > <li><i>UOCCU</i>-Onderbezetting van de sociale
        huurwoning  (Pijler 4) </li > <li><i>OCRWD</i>-Overbezetting van de
        sociale huurwoning (Pijler 4) </li > <li><i>NCRAT</i>-Niet meer voldoen
        aan de rationele bezetting (Pijler 4) </li > <li><i>PRFR</i>-Vooraf
        vermelde gezinshereniging die plaatsvindt (Pijler 4) </li >
        <li><i>NOADA</i>-Het niet meer nodig hebben van een aangepaste woning
        (Pijler 4) </li > <li><i>TOEZ</i>-Het gegrond vinden van het verhaal bij
        de toezichthouder (Pijler 4) </li > <li><i>REHOU</i>-Het herhuisvesten
        bij de beëindiging van het hoofdhuurcontract van een ingehuurde woning
        (Pijler 4) </li > </ul>
      nullable: true
    ZwarteLijstMeldingen:
      type: object
      properties:
        partijCode:
          type: string
          description: >-
            KBO nummer of CIR code van de partij die betrokken is bij het
            dossier.
          nullable: true
        meldingen:
          type: array
          items:
            $ref: '#/components/schemas/ZwarteLijstMelding'
          description: ZwarteLijstMeldingen kunnen doorgestuurd worden voor partijen
          nullable: true
      additionalProperties: false
      nullable: true
    ZwarteLijstMelding:
      type: object
      properties:
        rijksregisternummer:
          maxLength: 15
          type: string
          description: RRN van persoon op zwartelijst
          nullable: true
        reden:
          $ref: '#/components/schemas/ZwarteLijstRedenCodeWaarden'
        startDatum:
          type: string
          description: Datum vanaf wanneer persoon op zwartelijst staat
          format: date-time
      additionalProperties: false
      nullable: true
    PartijInformatieWijzigingen:
      type: object
      properties:
        partijCode:
          type: string
          description: >-
            KBO nummer of CIR code van de partij die betrokken is bij het
            dossier.
          nullable: true
        wijzingingen:
          type: array
          items:
            $ref: '#/components/schemas/PartijInformatieWijziging'
          nullable: true
      additionalProperties: false
      nullable: true
    PartijInformatieWijziging:
      type: object
      properties:
        rijksregisternummer:
          maxLength: 15
          type: string
          description: Rijksregisternummer
          nullable: true
          example: '2209280001'
        voorNaam:
          maxLength: 48
          type: string
          description: Voornaam van bewindvoerder
          nullable: true
          example: Marc
        naam:
          maxLength: 128
          type: string
          description: Achternaam van bewindvoerder
          nullable: true
          example: Molenbergs
        email:
          maxLength: 50
          type: string
          description: E-mailadres van bewindvoerder
          nullable: true
          example: Marc.Molenbergs@hotmail.be
        telefoon1:
          maxLength: 15
          type: string
          description: Telefoonnummer van bewindvoerder
          nullable: true
          example: 015/43 43 43
        telefoon2:
          maxLength: 15
          type: string
          description: Telefoonnummer van bewindvoerder
          nullable: true
          example: 0477 / 43 43 43
        adres:
          $ref: '#/components/schemas/PartijAdres'
        registratieTijdstip:
          type: string
          format: date-time
          nullable: true
      additionalProperties: false
      nullable: true
    PartijAdres:
      type: object
      properties:
        postCode:
          maxLength: 15
          type: string
          description: Postcode van de domicilie van bewindvoerder
          nullable: true
          example: '2830'
        gemeente:
          maxLength: 100
          type: string
          description: Naam van de gemeente van bewindvoerder
          nullable: true
          example: Willebroek
        gemeenteNisCode:
          maxLength: 15
          type: string
          description: Niscode
          nullable: true
          example: 41002A
        landCode:
          maxLength: 5
          type: string
          nullable: true
        straat:
          maxLength: 225
          type: string
          description: Straat van bewindvoerder
          nullable: true
          example: Bos
        huisNummer:
          maxLength: 50
          type: string
          description: Huisnummer van bewindvoerder
          nullable: true
          example: '502'
        huisNummerBus:
          maxLength: 50
          type: string
          description: Bus nr van bewindvoerder
          nullable: true
          example: X
      additionalProperties: false
      nullable: true
    GetZwarteLijstMeldingVerzoek:
      type: object
      properties:
        rijksregisternummer:
          type: string
          nullable: true
          example: '12345678901'
      additionalProperties: false
      nullable: true
    GetZwarteLijstMelding:
      type: object
      properties:
        opZwarteLijst:
          type: boolean
          description: Aanduiding of de persoon op de zwartelijst staat of niet.
        partijCode:
          type: string
          description: >-
            KBO nummer of CIR code van de partij die betrokken is bij het
            dossier.
          nullable: true
        reden:
          $ref: '#/components/schemas/ZwarteLijstRedenCodeWaarden'
        startDatum:
          type: string
          description: Datum vanaf wanneer persoon op zwartelijst moet
          format: date-time
          nullable: true
      additionalProperties: false
      nullable: true
    DossierDienstDossierActie:
      type: object
      properties:
        dossierNummer:
          type: string
          description: nvarchar(15)
          nullable: true
          example: YYY.MM.DD.XXXX
        partijCode:
          type: string
          description: >-
            KBO nummer of CIR code van de partij die betrokken is bij het
            dossier.
          nullable: true
          example: '1234'
        actie:
          $ref: '#/components/schemas/DossierActieCodeWaarden'
        commentaar:
          type: string
          description: Commentaar bij de actie
          nullable: true
        datumIngangContract:
          type: string
          description: Datum van ingang contract huurder
          format: date-time
          nullable: true
        pand:
          $ref: '#/components/schemas/DossierDienstDossierPandUpdate'
      additionalProperties: false
      nullable: true
    GemeenteDienstZoekResultaats:
      type: object
      properties:
        gemeentes:
          type: array
          items:
            $ref: '#/components/schemas/GemeenteDienstZoekResultaat'
          nullable: true
      additionalProperties: false
      nullable: true
    GemeenteDienstZoekResultaat:
      type: object
      properties:
        nisCode:
          type: string
          nullable: true
        naam:
          type: string
          nullable: true
        taal:
          type: string
          nullable: true
        regioCode:
          type: string
          nullable: true
        provincieCode:
          type: string
          nullable: true
        districtCode:
          type: string
          nullable: true
        lengteGraad:
          type: number
          format: double
          nullable: true
        breedteGraad:
          type: number
          format: double
          nullable: true
        deelgemeentes:
          type: array
          items:
            $ref: '#/components/schemas/GemeenteDienstZoekResultaatDeelgemeente'
          nullable: true
      additionalProperties: false
      nullable: true
    GemeenteDienstZoekResultaatDeelgemeente:
      type: object
      properties:
        nisCode:
          type: string
          nullable: true
        zip:
          type: string
          nullable: true
        naam:
          type: string
          nullable: true
      additionalProperties: false
      nullable: true
    GemeenteDienstWijken:
      type: object
      properties:
        wijken:
          type: array
          items:
            $ref: '#/components/schemas/GemeenteDienstWijk'
          nullable: true
      additionalProperties: false
      nullable: true
    GemeenteDienstWijk:
      type: object
      properties:
        wijkNaam:
          type: string
          nullable: true
        gemeenteNisCode:
          type: string
          nullable: true
      additionalProperties: false
      nullable: true
    DossierDienstBijlageCriteria:
      required:
        - bijlageIdentificatie
        - dossierNummer
        - partijCode
      type: object
      properties:
        partijCode:
          maxLength: 15
          type: string
          description: >-
            KBO nummer of CIR code van de partij die betrokken is bij het
            dossier.
          example: '5025'
        dossierNummer:
          maxLength: 15
          type: string
          description: DossierNummer nvarchar(15)
          example: YYYY.MM.DD.XXXX
        bijlageIdentificatie:
          type: string
          description: Identificatie van de bijlage
          example: CCTS-0-12345678900
      additionalProperties: false
      nullable: true
    DossierDienstDossierWoonsituatie:
      type: object
      properties:
        omschrijving:
          type: string
          description: Woonsituatie reden omschrijving
          nullable: true
        identificatie:
          type: string
          description: Identificatie van de Woonsituatie
          nullable: true
      additionalProperties: false
      description: Woonsituatie voor het dossier
      nullable: true

    #----------------------- END CIR payloads -------------------------------

    #----------------------- START CWR WoningenAPI -------------------------------
    WoningV2Response:
      type: object
      properties:
        '@context':
          type: string
          nullable: true
        '@id':
          type: string
          format: uri
          nullable: true
        '@magdaId':
          type: string
          format: uri
          nullable: true
        '@type':
          type: string
          default: WivWoningResource
          nullable: true
        value:
          $ref: '#/components/schemas/WivWoningResource'
      additionalProperties: false
    WivWoningResource:
      type: object
      properties:
        eigenaar:
          $ref: '#/components/schemas/OrganisatieResourceMetOsloType'
        beheerder:
          $ref: '#/components/schemas/OrganisatieResourceMetOsloType'
        verhuringsStelsel:
          enum:
            - Sociale verhuur gesubsidieerd
            - Geconventioneerde verhuur
            - Sociale verhuur
          type: string
        woonmaatschappijWoningId:
          type: string
          description: Het Id van de woning in de applicatie van de woonmaatschappij
          nullable: true
          example: O02034#22
        woonmaatschappijWoningCode:
          type: string
          description: De code voor de woning in de applicatie van de woonmaatschappij
          nullable: true
          example: 29 06 00 00 00 27
        woonmaatschappijWoningGroepCode:
          type: string
          description: De code van de groep waartoe de woning behoort
          nullable: true
          example: ZJV-JVB-V
        bouwjaar:
          type: integer
          format: int32
          nullable: true
        vmswWoningId:
          type: string
          nullable: true
        gebouweenheidIds:
          type: array
          items:
            type: string
          nullable: true
        adres:
          $ref: '#/components/schemas/VmswAdres'
        statistischeSector:
          type: string
          nullable: true
        wijk:
          type: string
          nullable: true
        woningType:
          type: string
          nullable: true
        woningStatus:
          type: string
          nullable: true
        bebouwingsType:
          type: string
          nullable: true
      additionalProperties: false
    VmswAdres:
      type: object
      properties:
        straatnaam:
          $ref: '#/components/schemas/TaalString'
        huisnummer:
          type: string
          nullable: true
        busnummer:
          type: string
          nullable: true
        postcode:
          type: string
          nullable: true
        gemeentenaam:
          $ref: '#/components/schemas/TaalString'
        gemeenteNISCode:
          type: string
          nullable: true
      additionalProperties: false
    TaalString:
      type: object
      properties:
        '@type':
          type: string
          default: http://www.w3.org/1999/02/22-rdf-syntax-ns#langString
          nullable: true
        spelling:
          type: string
          nullable: true
        taal:
          type: string
          default: nl-BE
          nullable: true
      additionalProperties: false
    OrganisatieResourceMetOsloType:
      type: object
      properties:
        '@type':
          type: string
          default: OrganisatieResource
          nullable: true
        organisatieType:
          enum:
            - Woonmaatschappij
            - OCMW
            - Gemeente
            - Private initiatiefnemer
          type: string
        organisatieId:
          type: string
          nullable: true
      additionalProperties: false
    V2WoningWijzigen:
      type: object
      properties:
        status:
          enum:
            - In beheer
            - Uit beheer
          type: string
          nullable: true
        eigenaarOrganisatieId:
          type: string
          nullable: true
        gebouweenheidId:
          type: string
          nullable: true
          example: '16480205'
        woonmaatschappijWoningId:
          type: string
          description: Het Id van de woning in de applicatie van de woonmaatschappij
          nullable: true
          example: O02034#22
        woonmaatschappijWoningCode:
          type: string
          description: De code voor de woning in de applicatie van de woonmaatschappij
          nullable: true
          example: 29 06 00 00 00 27
        woonmaatschappijWoningGroepCode:
          type: string
          description: De code van de groep waartoe de woning behoort
          nullable: true
          example: ZJV-JVB-V
        adres:
          $ref: '#/components/schemas/AdresZoeken'
        bouwjaar:
          type: integer
          format: int32
          nullable: true
        bebouwingsType:
          type: string
          nullable: true
      additionalProperties: false
    AdresZoeken:
      type: object
      properties:
        straatnaam:
          type: string
          nullable: true
        huisnummer:
          type: string
          nullable: true
        busnummer:
          type: string
          nullable: true
        postcode:
          type: string
          nullable: true
        gemeenteNISCode:
          type: string
          nullable: true
      additionalProperties: false
    V2WoningToevoegen:
      type: object
      properties:
        eigenaarOrganisatieId:
          type: string
          nullable: true
        gebouweenheidId:
          type: string
          nullable: true
          example: '16480205'
        woonmaatschappijWoningId:
          type: string
          description: Het Id van de woning in de applicatie van de woonmaatschappij
          nullable: true
          example: O02034#22
        woonmaatschappijWoningCode:
          type: string
          description: De code voor de woning in de applicatie van de woonmaatschappij
          nullable: true
          example: 29 06 00 00 00 27
        woonmaatschappijWoningGroepCode:
          type: string
          description: De code van de groep waartoe de woning behoort
          nullable: true
          example: ZJV-JVB-V
        adres:
          $ref: '#/components/schemas/AdresZoeken'
        bouwjaar:
          type: integer
          format: int32
          nullable: true
        bebouwingsType:
          type: string
          nullable: true
      additionalProperties: false
    ProblemDetailsValidationErrorExtension:
      type: object
      properties:
        validationErrors:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
          nullable: true
          readOnly: true
        type:
          type: string
          default: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/{Status}
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
      additionalProperties: false
    ValidationError:
      type: object
      properties:
        name:
          type: string
          nullable: true
          readOnly: true
        reason:
          type: string
          nullable: true
          readOnly: true
      additionalProperties: false
    #----------------------- END CWR WoningenAPI payloads -------------------------------

    #----------------------- START CWR Woningbezetting payloads -------------------------------

    WoningBezetting:
      type: object
      title: WoningBezetting
      properties:
        '@id':
          type: string
          format: uri
          example: 'https://cwr-host/id/woningbezetting/123'
        '@type':
          type: string
          default: WoningBezetting
        woningBezettingsType:
          $ref: '#/components/schemas/WoningBezettingsType'
        vmswWoningId:
          type: string
        datumBezettingVan:
          type: string
          format: date
        datumBezettingTot:
          type: string
          format: date
          description: 'Verplicht veld, maar kan leeg zijn'
        leegstandsType:
          $ref: '#/components/schemas/LeegstandsType'
        verhuring:
          $ref: '#/components/schemas/Verhuring'
        huurstelsel:
          type: string
          description: |-
            - BIS = Verhuring binnen het sociaal stelsel zoals vermeld in het kaderbesluit sociale huur
            - BUS = Verhuring buiten het sociaal stelsel zoals vermeld in artikel 55bis tot en met artikel 55exies van het Kaderbesluit Sociale Huur
            - GW = Goede woning zoals vermeld in hoofdstuk 3 van het ministerieel besluit van 19/12/2008
            - COM = Verhuring als niet-residentieële ruimte (garages, winkels)
            - BOV = Bezettingsovereenkomst gesloten met bijwoners wanneer de laatste huurder overlijdt
            - Andere = Ander soort verhuring
            - NVT = Niet van toepassing
          enum:
            - BIS
            - BUS
            - GW
            - COM
            - BOV
            - Andere
            - NVT
      required:
        - woningBezettingsType
        - vmswWoningId
        - datumBezettingTot
        - huurstelsel
    Verhuring:
      type: object
      title: ''
      description: ''
      properties:
        '@type':
          type: string
          default: Verhuring
        huurder:
          $ref: '#/components/schemas/Agent'
        huurprijsberekening:
          type: array
          items:
            $ref: '#/components/schemas/Huurprijsberekening'
        tijdelijkHuurContract:
          type: boolean
        begindatumHuurContract:
          type: string
          description: Verplicht bij tijdelijk contract
          format: date
          pattern: yyyy-mm-dd
        einddatumHuurContract:
          type: string
          description: Verplicht bij tijdelijk contract
          format: date
          pattern: yyy-mm-dd
        basisHuurprijs:
          type: string
          format: double
          pattern: '[0-9]+\.?[0-9]*'
        referentieHuurprijs:
          type: string
          format: double
          description: 'Is de referentiehuurprijs van de woning. Deze huurprijs geldt enkel tijdens de overgangsperiode. Gebruik als decimaal scheidingsteken een punt (“.”). Gebruik geen duizend-scheidingsteken, plusteken of enige andere opmaak. Dit veld is enkel verplicht voor woongelegenheden en dit zolang de overgangsregeling vermeld in het kaderbesluit sociale huur van toepassing is.'
          pattern: '[0-9]+\.?[0-9]*'
        patrimoniumkorting:
          type: string
          description: 'Dit veld is niet van toepassing tijdens de overgangsperiode. Is een decimaal getal. Gebruik als decimaal scheidingsteken een punt (“.”). Gebruik geen duizend-scheidingsteken, plusteken of enige andere opmaak. Dit veld is verplicht voor alle woongelegenheden verhuurd binnen het sociaal stelsel van zodra de patrimoniumkorting effectief ingevoerd wordt.'
          pattern: '[0-9]+\.?[0-9]*'
        energiecorrectie:
          type: string
          format: double
          description: 'De totale energiecorrectie. Voorlopig kan dit nog niet ingevuld worden. Is een decimaal getal. Gebruik als decimaal scheidingsteken een punt (“.”). Gebruik geen duizend-scheidingsteken, plusteken of enige andere opmaak. Dit veld is verplicht voor alle woongelegenheden verhuurd binnen het sociaal stelsel van zodra de energiecorrectie effectief ingevoerd wordt.'
          pattern: '[0-9]+\.?[0-9]*'
        huurlasten:
          type: string
          format: double
          pattern: '[0-9]+\.?[0-9]*'
        toegepasteBasisHuurprijs:
          type: string
          format: double
          pattern: '[0-9]+\.?[0-9]*'
        gezinsleden:
          type: array
          items:
            $ref: '#/components/schemas/Gezinslid'
        huurOpzegging:
          $ref: '#/components/schemas/HuurOpzegging'
      required:
        - tijdelijkHuurContract
    LeegstandsType:
      type: object
      x-examples: {}
      properties:
        '@type':
          type: string
          default: LeegstandsType
        structureel:
          type: boolean
        leegstandsTypeCode:
          type: integer
          description: |-
            Indien niet-structureel => opties:
            1 Overlijden van huurder
            2 Woning die leegstaat in afwachting van verhuring aan de huurde die door renovatie zijn sociale woning gaat ontruimen
            3 Frictieleegstand
      required:
        - structureel
    Huurprijsberekening:
      type: object
      properties:
        '@type':
          type: string
          default: Huurprijsberekening
        beginDatumHuurprijsberekening:
          type: string
          format: date
          pattern: yyyy-mm-dd
        eindDatumHuurprijsberekening:
          type: string
          format: date
          pattern: yyyy-mm-dd
        personenTenLaste:
          type: string
          format: double
          description: |-
            Is het aantal personen ten laste voor de betreffende huurder zoals van toepassing in het kaderbesluit sociale huur. Is niet altijd hetzelfde als het aantal gezinsleden. Is een getal tussen 0 en 99 (grenzen inbegrepen).
            Het cijfer kan ook **halve personen** ten laste bevatten. PTL is de som van Aantalkinderen en AantalHandicap. Dit veld is niet verplicht wanneer het winkels of garages betreft.
          pattern: '[0-9]+\.?[0-9]*'
        aantalKinderen:
          type: integer
          format: int32
        aantalMetHandicap:
          type: integer
          format: int32
        aantalGezinsleden:
          type: integer
          format: int32
        totaalInkomen:
          type: string
          format: double
          pattern: '[0-9]+\.?[0-9]*'
        totaalInkomenNietGeindexeerd:
          type: string
          format: double
          pattern: '[0-9]+\.?[0-9]*'
        reeleHuur:
          type: string
          format: double
          pattern: '[0-9]+\.?[0-9]*'
        gezinskorting:
          type: string
          format: double
          pattern: '[0-9]+\.?[0-9]*'
        onderbezettingsvergoeding:
          type: string
          format: double
          pattern: '[0-9]+\.?[0-9]*'
      required:
        - beginDatumHuurprijsberekening
        - eindDatumHuurprijsberekening
        - reeleHuur
    Gezinslid:
      type: object
      description: ''
      title: Gezinslid
      properties:
        '@type':
          type: string
          default: Gezinslid
        computerNummer:
          type: string
          description: |
            Het nummer waarmee de huurder in de databank van de SHM wordt geïdentificeerd.
        metHandicap:
          type: boolean
        gezinsRelatie:
          $ref: '#/components/schemas/RelatieType'
        persoon:
          $ref: '#/components/schemas/GeregistreerdPersoon'
      required:
        - gezinsRelatie
    Geboorte:
      title: Geboorte
      x-stoplight:
        id: nzn6f8k9i10uq
      type: object
      properties:
        '@type':
          type: string
          default: Geboorte
        datum:
          type: string
        plaats:
          $ref: '#/components/schemas/Plaats'
    Agent:
      title: Agent
      x-stoplight:
        id: r30hkva8og2gy
      type: object
      description: Dit is een persoon of organisatie aan wie de woning verhuurd wordt
      properties:
        '@type':
          type: string
          default: Agent
        persoon:
          $ref: '#/components/schemas/PersoonRegistratie'
        organisatie:
          $ref: '#/components/schemas/OrganisatieRegistratie'
    HuurOpzegging:
      title: HuurOpzegging
      x-stoplight:
        id: u407h8hjtuktk
      type: object
      properties:
        '@type':
          type: string
          default: HuurOpzegging
        UithuiszettingsReden:
          type: array
          items:
            $ref: '#/components/schemas/TaalString'
        UithuiszettingDetail:
          type: array
          items:
            $ref: '#/components/schemas/TaalString'
        UithuiszettingOpgestart:
          type: boolean
        UithuiszettingEffectief:
          type: boolean
        OntbindingsReden:
          type: array
          items:
            $ref: '#/components/schemas/TaalString'
        OntbindingsDetail:
          type: array
          items:
            $ref: '#/components/schemas/TaalString'
    Nationaliteit:
      title: Nationaliteit
      x-stoplight:
        id: 2xul36lbmwsvc
      type: object
      properties:
        '@type':
          type: string
          default: Nationaliteit
        nationaliteitscode:
          type: string
        nationaliteit:
          type: array
          items:
            $ref: '#/components/schemas/TaalString'
    GeregistreerdPersoon:
      title: GeregistreerdPersoon
      x-stoplight:
        id: yf0e42cfm26wc
      type: object
      properties:
        '@type':
          type: string
          default: 'https://data.vlaanderen.be/ns/persoon#GeregistreerdPersoon'
        registratie:
          $ref: '#/components/schemas/Identificator'
        voornaam:
          type: array
          items:
            type: string
        gebruikteVoornaam:
          type: string
        achternaam:
          type: array
          items:
            type: string
        volledigeNaam:
          type: string
        heeftGeboorte:
          $ref: '#/components/schemas/Geboorte'
        geslacht:
          type: array
          items:
            $ref: '#/components/schemas/TaalString'
        heeftNationaliteit:
          type: array
          items:
            $ref: '#/components/schemas/Nationaliteit'
    Identificator:
      title: Identificator
      x-stoplight:
        id: bipk6o53h7iof
      type: object
      properties:
        '@type':
          type: string
          default: Identificator
        identificator:
          type: string
      description: |
        Insznummer
    Response:
      title: Response
      x-stoplight:
        id: u18uoyp5urpwd
      type: object
      properties:
        '@context':
          type: string
        items:
          type: array
          items:
            $ref: '#/components/schemas/WoningBezetting'
    RelatieType:
      title: RelatieType
      type: object
      properties:
        '@type':
          type: string
          default: RelatieType
        spelling:
          type: string
          enum:
            - Onbekend
            - Gezinshoofd
            - Echtgenoot of Echtgenote
            - Zoon of Dochter
            - Schoonzoon of Schoondochter
            - Kleinzoon of Kleindochter
            - Vader of Moeder
            - Schoonvader of Schoonmoeder
            - Grootvader of Grootmoeder
            - Broer of Zuster
            - Schoonbroer of Schoonzuster
            - Verwant of Verwante
            - Zonder familieband
            - Stiefzoon of Stiefdochter
            - Achterkleinzoon of Achterkleindochter
            - Oom of Tante
            - Neef of Nicht (verwantschap 3de graad)
            - Neef of Nicht (verwantschap 4de graad)
            - Gemeenschappen of Tehuizen
        taal:
          type: string
          default: nl-BE
    Plaats:
      title: Plaats
      x-stoplight:
        id: wv6bi8bdfuxu3
      type: object
      properties:
        '@type':
          type: string
          description: 'http://purl.org/dc/terms/Location'
        plaatsnaam:
          type: array
          items:
            $ref: '#/components/schemas/TaalString'
    WoningBezettingsType:
      type: object
      title: WoningBezettingsType
      x-stoplight:
        id: rb7gf278qcyrv
      enum:
        - Verhuring
        - Leegstand
      properties:
        '@type':
          type: string
          default: WoningBezettingsType
        spelling:
          type: string
        taal:
          type: string
    AgentType:
      title: AgentType
      x-stoplight:
        id: b3iwm5jjn8pft
      type: object
      properties:
        '@type':
          type: string
          default: AgentType
        spelling:
          type: string
        lang:
          type: string
      description: Persoon of organisatie die de woning zal huren
    PersoonRegistratie:
      title: PersoonRegistratie
      x-stoplight:
        id: 6fojgqsqwox32
      type: object
      properties:
        '@type':
          type: string
          default: 'Huurder'
        registratie:
          $ref: '#/components/schemas/Identificator'
        inkomen:
          type: string
          format: double
          pattern: '[0-9]+\.?[0-9]*'
        inkomensjaar:
          type: integer
        inkomenFictief:
          type: boolean
    OrganisatieRegistratie:
      title: OrganisatieRegistratie
      x-stoplight:
        id: ozefub6q99za5
      type: object
      properties:
        '@type':
          type: string
          default: 'https://data.vlaanderen.be/ns/organisatie'
        registratie:
          $ref: '#/components/schemas/Identificator'
        wettelijkeNaam:
          type: string
    #----------------------- END CWR Woningbezetting payloads -------------------------------

    #----------------------- START Notifications payloads -------------------------------

    AsynchroonBerichtResponse:
      type: object
      properties:
        version:
          type: string
          nullable: true
        sender:
          type: string
          nullable: true
        resource:
          type: string
          nullable: true
        magdaResource:
          type: string
          nullable: true
          description: Resource to be used on the MAGDA platform. This element is not present if the VMSW resource can not be parsed.
        identification:
          type: string
          nullable: true
        magdaIdentification:
          type: string
          nullable: true
          description: Identification to be used on the MAGDA platform. This element is not present if the VMSW identification can not be parsed.
        timeStamp:
          type: string
          format: date-time
        changeType:
          enum:
            - C
            - U
            - D
          type: string
          description: Oplijsting mogelijke acties die via berichtenflow kan gebeuren.
        changeReasonCode:
          type: string
          nullable: true
        changeReasonComment:
          type: string
          nullable: true
        receiver:
          type: string
          nullable: true
      additionalProperties: false

    #----------------------- END Notifications payloads -------------------------------


    #----------------------- START Markthuurwaarden payloads --------------------------
    Huurschatting:
      type: object
      properties:
        woningKenmerkScores:
          type: array
          items:
            $ref: '#/components/schemas/WoningKenmerkScore'
          nullable: true
        markthuurwaardePerSchattingsmodel:
          type: array
          items:
            $ref: '#/components/schemas/MarkthuurwaardeSchattingsmodel'
          nullable: true
      additionalProperties: false
    HuurschattingSimulatie:
      type: object
      properties:
        woningKenmerkScores:
          type: array
          items:
            $ref: '#/components/schemas/WoningKenmerkScore'
          nullable: true
        markthuurwaardePerSchattingsmodel:
          type: array
          items:
            $ref: '#/components/schemas/MarkthuurwaardeSimulatieSchattingsmodel'
          nullable: true
      additionalProperties: false
    Markthuurwaarde:
      type: object
      properties:
        voorWoning:
          type: string
          format: uri
          example: >-
            https://cwr.vmsw.vonet.be/api/v1/woonmaatschappijen/{organisatieId}/woningen/{vmswWoningId}
          nullable: true
        magdaVoorWoning:
          type: string
          format: uri
          nullable: true
          description: Resource to be used on the MAGDA platform. This element is not present if the VMSW resource can not be parsed.
        opReferentieDatum:
          $ref: '#/components/schemas/Huurschatting'
        opHuidigeStaat:
          $ref: '#/components/schemas/Huurschatting'
      additionalProperties: false
    MarkthuurwaardeResponse:
      type: object
      properties:
        '@context':
          type: string
          nullable: true
        '@id':
          type: string
          format: uri
          example: >-
            https://cwr.vmsw.vonet.be/api/v1/woonmaatschappijen/{organisatieId}/woningen/{vmswWoningId}/markthuurwaarden
          nullable: true
        '@magdaId':
          type: string
          format: uri
          nullable: true
        '@type':
          type: string
          default: MarkthuurwaardeResource
          nullable: true
        value:
          $ref: '#/components/schemas/Markthuurwaarde'
      additionalProperties: false
    MarkthuurwaardeSchattingsmodel:
      type: object
      properties:
        '@type':
          type: string
          default: MarkthuurwaardeSchattingsmodelResource
          nullable: true
        bedragInclusiefAfwijkingEnAfronding:
          type: integer
          format: int32
        toegestaneAfwijkingPercentage:
          type: number
          format: double
        foutmelding:
          type: string
          nullable: true
        jaar:
          type: integer
          format: int32
        bedrag:
          type: number
          format: double
        berekendOp:
          type: string
          format: date-time
      additionalProperties: false
    MarkthuurwaardeSimulatieResponse:
      type: object
      properties:
        '@context':
          type: string
          nullable: true
        '@id':
          type: string
          format: uri
          nullable: true
        '@magdaId':
          type: string
          format: uri
          nullable: true
        '@type':
          type: string
          default: MarkthuurwaardeSimulatieResource
          nullable: true
        value:
          $ref: '#/components/schemas/HuurschattingSimulatie'
      additionalProperties: false
    MarkthuurwaardeSimulatieSchattingsmodel:
      type: object
      properties:
        '@type':
          type: string
          default: MarkthuurwaardeSimulatieSchattingsmodelResource
          nullable: true
        jaar:
          type: integer
          format: int32
        bedrag:
          type: number
          format: double
        berekendOp:
          type: string
          format: date-time
      additionalProperties: false
    ProblemDetail:
      type: object
      properties:
        type:
          type: string
          default: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/{Status}
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
      additionalProperties: false
    WoningKenmerkDefinitie:
      type: object
      properties:
        '@id':
          type: string
          format: uri
          example: /v1/woningkenmerken/{code}
          nullable: true
        '@magdaId':
          type: string
          format: uri
          nullable: true
        '@type':
          type: string
          default: WoningKenmerkDefinitieResource
          nullable: true
        label:
          type: string
          nullable: true
        code:
          type: string
          nullable: true
      additionalProperties: false
    WoningKenmerkScore:
      type: object
      properties:
        '@type':
          type: string
          default: WoningKenmerkScoreResource
          nullable: true
        woningKenmerk:
          $ref: '#/components/schemas/WoningKenmerkDefinitie'
        score:
          type: string
          description: >-
            Waarde (score) voor het kenmerk. De waarde moet voldoen aan de
            schaal die gekoppeld is aan het kenmerk.
          nullable: true
      additionalProperties: false
    WoningKenmerkScoreLijst:
      type: object
      properties:
        woningKenmerkSimulatieScores:
          type: array
          items:
            $ref: '#/components/schemas/WoningKenmerkScoreWijziging'
          nullable: true
      additionalProperties: false
    WoningKenmerkScoreWijziging:
      type: object
      properties:
        code:
          type: string
          description: Code om het woningkenmerk uniek te identificeren
          nullable: true
        score:
          type: string
          description: >-
            Score voor het kenmerk. De score moet voldoen aan de schaal die
            gekoppeld is aan het kenmerk.
          nullable: true
      additionalProperties: false
    #----------------------- END Markthuurwaarden payloads ----------------------------

    #----------------------- START Conditiescore payloads ----------------------------

    ConditiescoreWoningKenmerkScore:
      type: object
      properties:
        '@type':
          type: string
          default: ConditiescoreWoningKenmerkScoreResource
          nullable: true
          readOnly: true
        woningKenmerk:
          $ref: '#/components/schemas/WoningKenmerkDefinitie'
        score:
          type: string
          description: Score voor het kenmerk. De score moet voldoen aan de schaal die gekoppeld is aan het kenmerk.
          nullable: true
          readOnly: true
        scoreLabel:
          type: string
          nullable: true
          readOnly: true
        wegingsfactorProcent:
          type: number
          format: double
        totaalProcent:
          type: number
          format: double
      additionalProperties: false

    ConditiescoreGroep:
      type: object
      properties:
        naam:
          type: string
          nullable: true
        scores:
          type: array
          items:
            $ref: '#/components/schemas/ConditiescoreWoningKenmerkScore'
          nullable: true
        wegingsfactorProcent:
          type: number
          format: double
        totaalProcent:
          type: number
          format: double
      additionalProperties: false
    ConditiescoreCategorie:
      type: object
      properties:
        naam:
          type: string
          nullable: true
        groepen:
          type: array
          items:
            $ref: '#/components/schemas/ConditiescoreGroep'
          nullable: true
      additionalProperties: false

    Conditiescore:
      type: object
      properties:
        voorWoning:
          type: string
          format: uri
          example: >-
            https://cwr.vmsw.vonet.be/api/v1/woonmaatschappijen/{organisatieId}/woningen/{vmswWoningId}
          nullable: true
        magdaVoorWoning:
          type: string
          format: uri
          nullable: true
          description: Resource to be used on the MAGDA platform. This element is not present if the VMSW resource can not be parsed.
        gebouwstaat:
          $ref: '#/components/schemas/ConditiescoreCategorie'
        veiligheidEnGezondheid:
          $ref: '#/components/schemas/ConditiescoreCategorie'
        gebouwstaatScoreProcent:
          type: number
          format: double
        gebouwstaatWegingsfactorProcent:
          type: number
          format: double
        veiligheidEnGezondheidScoreProcent:
          type: number
          format: double
        veiligheidEnGezondheidWegingsfactorProcent:
          type: number
          format: double
        totaalScoreProcent:
          type: number
          format: double
    
    ConditiescoreResponse:
      type: object
      properties:
        '@context':
          type: string
          nullable: true
        '@id':
          type: string
          format: uri
          example: >-
            https://cwr.vmsw.vonet.be/api/v1/woonmaatschappijen/{organisatieId}/woningen/{vmswWoningId}/conditiescore
          nullable: true
        '@magdaId':
          type: string
          format: uri
          nullable: true
        '@type':
          type: string
          default: ConditiescoreVoorWoningResource
          nullable: true
        value:
          $ref: '#/components/schemas/Conditiescore'

    ConditiescoreSimulatie:
      type: object
      properties:
        gebouwstaat:
          $ref: '#/components/schemas/ConditiescoreCategorie'
        veiligheidEnGezondheid:
          $ref: '#/components/schemas/ConditiescoreCategorie'
        gebouwstaatScoreProcent:
          type: number
          format: double
        gebouwstaatWegingsfactorProcent:
          type: number
          format: double
        veiligheidEnGezondheidScoreProcent:
          type: number
          format: double
        veiligheidEnGezondheidWegingsfactorProcent:
          type: number
          format: double
        totaalScoreProcent:
          type: number
          format: double
      additionalProperties: false

    ConditiescoreSimulatieResponse:
      type: object
      properties:
        '@context':
          type: string
          nullable: true
        '@id':
          type: string
          format: uri
          example: >-
            https://cwr.vmsw.vonet.be/api/v1/woonmaatschappijen/{organisatieId}/markthuurwaarden/simulatie#2023-04-13T16:15
          nullable: true
        '@type':
          type: string
          default: ConditiescoreSimulatieResource
          nullable: true
        value:
          $ref: '#/components/schemas/ConditiescoreSimulatie'
      additionalProperties: false

    #----------------------- END Conditiescore payloads ----------------------------

    #----------------------- START WoningKenmerken payloads -------------------------------
    WoningKenmerkScoreWijzigen:
      type: object
      properties:
        woningKenmerkScores:
          type: array
          items:
            $ref: '#/components/schemas/WoningKenmerkScoreWijziging'
          nullable: true
      additionalProperties: false
    WoningKenmerkScoresMetWoning:
      type: object
      properties:
        voorWoning:
          type: string
          format: uri
          example: /v1/woonmaatschappijen/{organisatieId}/woningen/{vmswWoningId}
          nullable: true
        magdaVoorWoning:
          type: string
          format: uri
          nullable: true
          description: Resource to be used on the MAGDA platform. This element is not present if the VMSW resource can not be parsed.
        scores:
          type: array
          items:
            $ref: '#/components/schemas/WoningKenmerkScore'
          nullable: true
      additionalProperties: false
    WoningKenmerkScoresResponse:
      type: object
      properties:
        '@context':
          type: string
          nullable: true
        '@id':
          type: string
          format: uri
          example: /v1/woonmaatschappijen/{organisatieId}/woningen/{vmswWoningId}/woningkenmerkscores
          nullable: true
        '@magdaId':
          type: string
          format: uri
          nullable: true
        '@type':
          type: string
          default: WoningKenmerkScoresMetWoningResource
          nullable: true
        value:
          $ref: '#/components/schemas/WoningKenmerkScoresMetWoning'
      additionalProperties: false
    WoningKenmerkCategorie:
      type: string
      enum:
        - Alles
        - Huurschatting
        - Energiecorrectie
        - Conditiemeting
        - ERP
        - PV forfait
    #----------------------- END WoningKenmerken payloads -------------------------------

    #----------------------- START Energiecorrectie payloads ----------------------------

    WoningEnergiecorrectieResponse:
      type: object
      properties:
        '@context':
          type: string
          nullable: true
        '@id':
          type: string
          format: uri
          example: '{requestUrl}'
          nullable: true
        '@magdaId':
          type: string
          format: uri
          nullable: true
        '@type':
          type: string
          default: WoningEnergiecorrectieResource
          nullable: true
        value:
          $ref: '#/components/schemas/WoningEnergiecorrectieResource'
      additionalProperties: false
    WoningEnergiecorrectieResource:
      type: object
      properties:
        voorWoning:
          type: string
          format: uri
          example: /v1/woonmaatschappijen/{organisatieId}/woningen/{vmswWoningId}
          nullable: true
        magdaVoorWoning:
          type: string
          format: uri
          nullable: true
        referentieDatumHuur:
          type: string
          format: date
        epcGegevens:
          $ref: '#/components/schemas/EpcGegevensResource'
        woningKenmerkScores:
          $ref: '#/components/schemas/EnergiecorrectieWoningKenmerkScoresResource'
        voorPeriode:
          $ref: '#/components/schemas/EnergiecorrectieVoorPeriodeResource'
      additionalProperties: false
    EpcGegevensResource:
      type: object
      properties:
        certificaatNummer:
          type: string
          nullable: true
        epcType:
          enum:
            - EpcBestaand
            - EpcBouw
          type: string
        epcKengetal:
          type: number
          format: double
        ePeil:
          type: number
          format: double
        kPeil:
          type: number
          format: double
        datumEpc:
          type: string
          format: date
        beschermdVolume:
          type: number
          format: double
        totaleVerliesoppervlakte:
          type: number
          format: double
        gemiddeldeUWaardeSchil:
          type: number
          format: double
        energieVerbruikRuimteVerwarming:
          type: number
          format: double
        energieVerbruikSanitairWarmWater:
          type: number
          format: double
        brutoBruikbareVloerOppervlakte:
          type: number
          format: double
        totaleOppervlakteVensters:
          type: number
          format: double
      additionalProperties: false
    EnergiecorrectieWoningKenmerkScoresResource:
      type: object
      properties:
        energieDragerRuimteVerwarming:
          $ref: '#/components/schemas/WoningKenmerkScore'
        energieDragerSanitairWarmWater:
          $ref: '#/components/schemas/WoningKenmerkScore'
      additionalProperties: false
    EnergiecorrectieVoorPeriodeResource:
      type: object
      properties:
        datumVanaf:
          type: string
          format: date
        datumTot:
          type: string
          format: date
        dagenInPeriode:
          type: number
          format: double
        maandenInPeriode:
          type: number
          format: double
        bedragSanitairWarmWater:
          type: number
          format: double
        bedragRuimteVerwarming:
          type: number
          format: double
        bedragTotaalPeriode:
          type: number
          format: double
        bedragTotaalPerMaand:
          type: number
          format: double
      additionalProperties: false
    EpcVersie:
      type: string
      enum:
        - Huidig
        - Referentie
    #----------------------- END Energiecorrectie payloads ----------------------------


    ErrorMessage:
      required:
        - detail
        - title
      type: object
      properties:
        type:
          type: string
          description: A URI reference that identifies the problem type. This specification encourages that, when dereferenced, it provide human-readable documentation for the problem type. When this member is not present, its value is assumed to be "about:blank".
        title:
          type: string
          description: A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization (e.g., using proactive content negotiation.
        status:
          type: string
          description: The HTTP status code generated by the origin server for this occurrence of the problem.
        detail:
          type: string
          description: A human-readable explanation specific to this occurrence of the problem.
        instance:
          type: string
          description: A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
      description: A representation of a generic error message

  securitySchemes:
    oauth2:
      type: apiKey
      description: "Standard Authorization header using the Bearer scheme. Example: \"bearer {token}\""
      name: Authorization
      in: header

Werk

Verrichtingen

View file
nameverrichtingen.yaml

Expand
titleKlik hier om de inhoud te bekijken
Swagger open api macro
displayOperationIdfalse
methodsnone,get,put,post,delete,options,head,patch,trace
validator
defaultModelsExpandDepth1
url
token
defaultModelRenderingexample
filter
password
expandlist
showCommonExtensionsfalse
filename
operations
maxDisplayedTags
attachfalse

...

showExtensionsfalse

...

displayRequestDurationfalse
username
order
openapi: 3.0.3
info:
  title: werk.verrichtingen Service
  description: ''
  contact:
    name: werk.verrichtingenAPI
    email: helpdesk.magda@vlaanderen.be
  license:
    name: werk.verrichtingenAPI
    url: 'https://overheid.vlaanderen.be/magda'
  version: '1.0'
servers:
  - url: /api/v1/werk
tags:
  - name: verrichtingen
paths:
  /verrichtingen:
    get:
      tags:
        - verrichtingen
      summary: opvragen verrichtingen voor een persoon/maatregel/fiscaal jaar
      description: Jobbonus plus voor zelfstandigen is een maatregel die door DWSE in samenwerking met Digitaal Vlaanderen
      operationId: verrichtingen
      parameters:
        - name: x-correlation-id
          in: header
          required: true
          schema:
            $ref: '#/components/schemas/Correlation-Id'
        - in: header
          name: x-insz
          schema:
            $ref: '#/components/schemas/InsznummerHeader'
          description: het insznummer waarvoor de verrichting informatie bevraagd wordt
          required: true
        - in: query
          name: maatregel
          schema:
            $ref: '#/components/schemas/Maatregel'
          required: false
          description: de maatregel waarvoor de verrichting informatie bevraagd wordt
        - in: query
          name: fiscaalJaar
          schema:
            $ref: '#/components/schemas/FiscaalJaar'
          description: Het fiscale jaar waarvoor de verrichtingen moeten opgehaald worden
          required: false

      responses:
        "200":
          description: Lijst van de verrichtingen voor een persoon per fiscaal jaar
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetVerrichtingDto'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/InvalidAuthorization'
        '403':
          $ref: '#/components/responses/NoAttestationAuthorization'
        '404':
          $ref: '#/components/responses/AttestationNotFound'
        '412':
          $ref: '#/components/responses/PreConditionFailed'
        '500':
          $ref: '#/components/responses/UnexpectedServerError'
        '502':
          $ref: '#/components/responses/BadGateway'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/GatewayTimeout'

components:
  responses:
    BadRequest:
      description: Invalid data supplied
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    InvalidAuthorization:
      description: Invalid authorization
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    NoAttestationAuthorization:
      description: Not authorized to obtain this attestation
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    AttestationNotFound:
      description: Attestation not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    PreConditionFailed:
      description: Precondition Failed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    UnexpectedServerError:
      description: Unexpected Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    BadGateway:
      description: Bad Gateway
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    ServiceUnavailable:
      description: Service unavailable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
    GatewayTimeout:
      description: Gateway Timeout
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessage'
  schemas:
    Insznummer:
      description: "Het insznummer van een persoon"
      type: object
      properties:
        identificator:
          type: string
          pattern: '^\d{11}$'
    InsznummerHeader:
      description: "Het insznummer van een persoon"
      type: string
      pattern: '^\d{11}$'

    Maatregel:
      example: JBPLUS
      description: "De maatregel waarvoor de informatie geldig is"
      type: string
    FiscaalJaar:
      example: 2023
      description: "Fiscale jaar - formaat yyyy"
      type: integer
      minimum: 2000
      maximum: 2100

    GetVerrichtingDto:
      type: object
      description: Verrichting informatie
      properties: 
        "@context":
          type: string
          default: "https://vlaamseoverheid.atlassian.net/wiki/download/attachments/6118410708/context-werk.verrichtingen.jsonld?api=v2"
        insznummer: 
            $ref: '#/components/schemas/Insznummer'
        verrichtingen: 
          type: array
          items:
            $ref: '#/components/schemas/MaatregelDto'
    MaatregelDto:
      type: object
      description: Verrichting informatie voor fiscale jaren
      properties:
        maatregel: 
            $ref: '#/components/schemas/Maatregel'
        fiscaleJaren: 
          type: array
          items:
            $ref: '#/components/schemas/FiscaleJarenDto'
    FiscaleJarenDto:
      type: object
      description: Verrichting informatie voor fiscale jaren
      properties:
        fiscaalJaar:
          $ref: '#/components/schemas/FiscaalJaar'
        totaalBedrag:
          $ref: '#/components/schemas/MonetairBedrag'
        detailVerrichtingen:
          type: array
          items:
            type: object
            properties:
              bedragType: 
                example: SCHIJF_1
                type: string
              effectieveVerrichtingDatum: 
                type: string
                format: date
              verrichtingBedrag: 
                $ref: '#/components/schemas/MonetairBedrag'
    MonetairBedrag:
      type: object
      properties:
        waarde:
          type: number
          format: float
        valuta:
          type: string
          default: EUR


    Correlation-Id:
      description: "ID of the transaction. Use this ID for log tracing and incident handling."
      type: string
      maxLength: 36
      minLength: 10

    ErrorMessage:
      required:
        - detail
        - title
      type: object
      properties:
        type:
          type: string
          description: 'A URI reference that identifies the problem type. This specification encourages that, when dereferenced, it provide human-readable documentation for the problem type. When this member is not present, its value is assumed to be "about:blank".'
        title:
          type: string
          description: 'A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization (e.g., using proactive content negotiation.'
        status:
          type: string
          description: The HTTP status code generated by the origin server for this occurrence of the problem.
        detail:
          type: string
          description: A human-readable explanation specific to this occurrence of the problem.
        instance:
          type: string
          description: A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
      description: A representation of a generic error message