openapi: 3.0.3
info:
  title: HP Mutatie Service - Delivery
  description: mutatie service delivery
  version: 1.0.9
servers:
- url: https://api.kvk.nl/test/api
  description: Test API
- url: https://api.kvk.nl/api
  description: Production API
security:
- ApiKeyAuth: []
tags:
- name: Abonnement
- name: Signaal
paths:
  /v1/abonnementen:
    get:
      tags:
      - Abonnement
      description: Geef een lijst terug van alle actieve abonnementen van de klant
      operationId: listAbonnementen
      responses:
        "200":
          description: ""
          content:
            application/hal+json:
              schema:
                $ref: '#/components/schemas/AbonnementenHalJsonResponseType'
            application/json:
              schema:
                $ref: '#/components/schemas/AbonnementenJsonResponseType'
        "401":
          description: ""
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
        "403":
          description: ""
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
  /v1/abonnementen/{abonnementId}:
    get:
      tags:
      - Abonnement
      description: "Geef een lijst van alle signalen, gepagineerd en gebaseerd op\
        \ de vanaf parameter"
      operationId: listSignalsByAbonnementId
      parameters:
      - name: abonnementId
        in: path
        description: abonnement id
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: vanaf
        in: query
        description: de vanaf datum-tijd
        required: false
        style: form
        explode: true
        schema:
          type: string
          format: date-time
      - name: tot
        in: query
        description: de tot datum-tijd
        required: false
        style: form
        explode: true
        schema:
          type: string
          format: date-time
      - name: pagina
        in: query
        description: Geeft aan welke pagina je op wilt vragen. Start vanaf pagina
          1
        required: false
        style: form
        explode: true
        schema:
          minimum: 1
          type: integer
          default: 1
      - name: aantal
        in: query
        description: Aantal zoekresultaten per pagina.
        required: false
        style: form
        explode: true
        schema:
          maximum: 500
          minimum: 10
          type: integer
          default: 100
      responses:
        "200":
          description: ""
          content:
            application/hal+json:
              schema:
                $ref: '#/components/schemas/PagedSignalenHalJsonType'
            application/json:
              schema:
                $ref: '#/components/schemas/PagedSignalenJsonType'
        "401":
          description: ""
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
        "403":
          description: ""
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
  /v1/abonnementen/{abonnementId}/signalen/{signaalId}:
    get:
      tags:
      - Signaal
      operationId: getSignalByAbonnementIdAndSignalId
      parameters:
      - name: abonnementId
        in: path
        description: abonnement id
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: signaalId
        in: path
        description: signaal id
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        "200":
          description: Geef opgevraagde signaal terug
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSignaalResponseType'
              examples:
                SignaalGewijzigdeInschrijving:
                  $ref: '#/components/examples/SignaalGewijzigdeInschrijving'
                SignaalGewijzigdeVestiging:
                  $ref: '#/components/examples/SignaalGewijzigdeVestiging'
                SignaalNieuweInschrijving:
                  $ref: '#/components/examples/SignaalNieuweInschrijving'
                SignaalBeeindiging202501:
                  $ref: '#/components/examples/SignaalBeeindiging202501'
                SignaalRechtsvormwijziging202501:
                  $ref: '#/components/examples/SignaalRechtsvormwijziging202501'
                SignaalVoortzettingEnOverdracht202501:
                  $ref: '#/components/examples/SignaalVoortzettingEnOverdracht202501'
                SignaalAdreswijziging202501:
                  $ref: '#/components/examples/SignaalAdreswijziging202501'
                SignaalNaamgeving202501:
                  $ref: '#/components/examples/SignaalNaamgeving202501'
                SignaalFusieSplitsing202501:
                  $ref: '#/components/examples/SignaalFusieSplitsing202501'
                SignaalActiviteitenWijziging202501:
                  $ref: '#/components/examples/SignaalActiviteitenWijziging202501'
        "401":
          description: ""
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
        "403":
          description: ""
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
        "422":
          description: ""
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
components:
  schemas:
    PaginationInfo:
      required:
      - aantal
      - pagina
      - totaal
      - totaalPaginas
      type: object
      properties:
        pagina:
          type: integer
        aantal:
          type: integer
        totaal:
          type: number
        totaalPaginas:
          type: integer
    ProblemDetail:
      required:
      - status
      - type
      type: object
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
        instance:
          type: string
        properties:
          type: object
          additionalProperties:
            type: object
      description: beschrijving van een fout die opgetreden is
    HateoasLink:
      title: Link Description
      required:
      - href
      - rel
      type: object
      properties:
        href:
          type: string
          description: "The complete target URL. To make the related call, combine\
            \ the method with this [URI Template-formatted](https://tools.ietf.org/html/rfc6570)\
            \ link. For pre-processing, include the `$`, `(`, and `)` characters.\
            \ The `href` is the key HATEOAS component that links a completed call\
            \ with a subsequent call."
        rel:
          type: string
          description: "The [link relation type](https://tools.ietf.org/html/rfc5988#section-4),\
            \ which serves as an ID for a link that unambiguously describes the semantics\
            \ of the link. See [Link Relations](https://www.iana.org/assignments/link-relations/link-relations.xhtml)."
        method:
          type: string
          description: The HTTP method required to make the related call.
          enum:
          - GET
          - POST
          - PUT
          - DELETE
          - HEAD
          - CONNECT
          - OPTIONS
          - PATCH
    HateoasLinks:
      required:
      - links
      type: object
      properties:
        links:
          maxItems: 10
          minItems: 1
          type: array
          description: Een array van HATEOAS links.
          items:
            $ref: '#/components/schemas/HateoasLink'
    Abonnement:
      required:
      - actief
      - contract
      - id
      - startDatum
      type: object
      properties:
        id:
          type: string
        contract:
          $ref: '#/components/schemas/ContractInfo'
        startDatum:
          type: string
          format: date-time
        eindDatum:
          type: string
          format: date-time
        actief:
          type: boolean
    AbonnementJson:
      allOf:
      - $ref: '#/components/schemas/Abonnement'
    AbonnementHalJson:
      allOf:
      - $ref: '#/components/schemas/Abonnement'
      - $ref: '#/components/schemas/HateoasLinks'
    AbonnementenHalJsonResponseType:
      allOf:
      - $ref: '#/components/schemas/AbonnementenResponseType'
      - required:
        - abonnementen
        type: object
        properties:
          abonnementen:
            type: array
            items:
              $ref: '#/components/schemas/AbonnementHalJson'
    AbonnementenJsonResponseType:
      allOf:
      - $ref: '#/components/schemas/AbonnementenResponseType'
      - required:
        - abonnementen
        type: object
        properties:
          abonnementen:
            type: array
            items:
              $ref: '#/components/schemas/AbonnementJson'
    AbonnementenResponseType:
      required:
      - klantId
      type: object
      properties:
        klantId:
          type: string
    PagedSignalenJsonType:
      allOf:
      - required:
        - signalen
        type: object
        properties:
          signalen:
            type: array
            items:
              $ref: '#/components/schemas/SignaalInfo'
      - $ref: '#/components/schemas/PaginationInfo'
    PagedSignalenHalJsonType:
      allOf:
      - required:
        - signalen
        type: object
        properties:
          signalen:
            type: array
            items:
              $ref: '#/components/schemas/SignaalInfoHal'
      - $ref: '#/components/schemas/PaginationInfo'
      - type: object
        properties:
          vorige:
            type: string
          volgende:
            type: string
    GetSignaalResponseType:
      required:
      - signaal
      type: object
      properties:
        signaal:
          discriminator:
            propertyName: signaalType
            mapping:
              SignaalGewijzigdeInschrijving: '#/components/schemas/SignaalGewijzigdeInschrijvingSignalType'
              SignaalGewijzigdeVestiging: '#/components/schemas/SignaalGewijzigdeVestigingSignalType'
              SignaalNieuweInschrijving: '#/components/schemas/SignaalNieuweInschrijvingSignalType'
              SignaalBeeindiging_2025_01: '#/components/schemas/SignaalBeeindiging202501SignalType'
              SignaalRechtsvormwijziging_2025_01: '#/components/schemas/SignaalRechtsvormwijziging202501SignalType'
              SignaalVoortzettingEnOverdracht_2025_01: '#/components/schemas/SignaalVoortzettingEnOverdracht202501SignalType'
              SignaalAdreswijziging_2025_01: '#/components/schemas/SignaalAdreswijziging202501SignalType'
              SignaalNaamgeving_2025_01: '#/components/schemas/SignaalNaamgeving202501SignalType'
              SignaalFusieSplitsing_2025_01: '#/components/schemas/SignaalFusieSplitsing202501SignalType'
          oneOf:
          - $ref: '#/components/schemas/SignaalGewijzigdeInschrijvingSignalType'
          - $ref: '#/components/schemas/SignaalGewijzigdeVestigingSignalType'
          - $ref: '#/components/schemas/SignaalNieuweInschrijvingSignalType'
          - $ref: '#/components/schemas/SignaalBeeindiging202501SignalType'
          - $ref: '#/components/schemas/SignaalRechtsvormwijziging202501SignalType'
          - $ref: '#/components/schemas/SignaalVoortzettingEnOverdracht202501SignalType'
          - $ref: '#/components/schemas/SignaalAdreswijziging202501SignalType'
          - $ref: '#/components/schemas/SignaalNaamgeving202501SignalType'
          - $ref: '#/components/schemas/SignaalFusieSplitsing202501SignalType'
          - $ref: '#/components/schemas/SignaalActiviteitenWijziging202501SignalType'
    ContractInfo:
      required:
      - id
      type: object
      properties:
        id:
          type: string
    SignaalInfo:
      required:
      - id
      - kvknummer
      - timestamp
      type: object
      properties:
        id:
          type: string
        timestamp:
          type: string
          format: date-time
        kvknummer:
          type: string
          default: ""
        signaalType:
          $ref: '#/components/schemas/SignaalType'
        vestigingsnummer:
          type: string
    SignaalInfoHal:
      allOf:
      - $ref: '#/components/schemas/SignaalInfo'
      - $ref: '#/components/schemas/HateoasLinks'
    SignaalGewijzigdeInschrijvingSignalType:
      allOf:
      - $ref: '#/components/schemas/BaseSignalType'
      - required:
        - heeftGewijzigdeGegevens
        type: object
        properties:
          heeftGewijzigdeGegevens:
            $ref: '#/components/schemas/GewijzigdeGegevensType'
    SignaalGewijzigdeVestigingSignalType:
      allOf:
      - $ref: '#/components/schemas/BaseSignalType'
      - required:
        - heeftGewijzigdeVestiging
        type: object
        properties:
          heeftGewijzigdeVestiging:
            $ref: '#/components/schemas/VestigingDetailsType'
    SignaalNieuweInschrijvingSignalType:
      allOf:
      - $ref: '#/components/schemas/BaseSignalType'
      - required:
        - heeftNieuweGegevens
        type: object
        properties:
          heeftNieuweGegevens:
            $ref: '#/components/schemas/SignaalNieuweInschrijvingType'
    SignaalBeeindiging202501SignalType:
      allOf:
      - $ref: '#/components/schemas/BaseSignalType'
      - required:
        - aanleiding
        - startdatum
        type: object
        properties:
          startdatum:
            type: string
            description: "Een datum heeft een vast formaat: 8 posities, met als invulling\
              \ jjjjmmdd (jaar-maand-dag), waarbij alleen cijfers zijn toegestaan.\
              \  Wanneer een gedeelte van de datum onbekend is, wordt dat gerepresenteerd\
              \ door nullen.  De mogelijke waarden van datum zijn:jjjjmmdd volledige\
              \ datum, jjjjmm00 dag onbekend, jjjj0000 maand onbekend, 00000000 datum\
              \ onbekend, standaardwaarde"
            format: YYYYMMDD
            example: "20241216"
          aanleiding:
            $ref: '#/components/schemas/EnumeratieType'
    SignaalRechtsvormwijziging202501SignalType:
      allOf:
      - $ref: '#/components/schemas/BaseSignalType'
      - required:
        - startdatum
        type: object
        properties:
          startdatum:
            type: string
            format: YYYYMMDD
            example: "20241216"
          persoonRechtsvormOud:
            type: string
            example: Rechtspersoon in oprichting
    SignaalVoortzettingEnOverdracht202501SignalType:
      allOf:
      - $ref: '#/components/schemas/BaseSignalType'
      - required:
        - startdatum
        - voortzettingEnOverdracht
        type: object
        properties:
          startdatum:
            type: string
            format: YYYYMMDD
            example: "20241216"
          voortzettingEnOverdracht:
            $ref: '#/components/schemas/VoortzettingEnOverdrachtType'
    SignaalAdreswijziging202501SignalType:
      allOf:
      - $ref: '#/components/schemas/BaseSignalType'
      - required:
        - adreswijzigings
        - startdatum
        type: object
        properties:
          startdatum:
            type: string
            format: YYYYMMDD
            example: "20230213"
          indicatieCorrectie:
            type: boolean
            example: false
          adreswijzigings:
            type: array
            items:
              $ref: '#/components/schemas/AdreswijzigingType'
    AdreswijzigingType:
      required:
      - aanleiding
      - betreft
      - vestigingsnummer
      type: object
      properties:
        vestigingsnummer:
          type: string
          example: "000067022391"
        betreft:
          $ref: '#/components/schemas/EnumeratieType'
        aanleiding:
          $ref: '#/components/schemas/EnumeratieType'
    SignaalNaamgeving202501SignalType:
      allOf:
      - $ref: '#/components/schemas/BaseSignalType'
      - required:
        - betrokkenVestigingen
        - wijzigingNaam
        type: object
        properties:
          wijzigingNaam:
            $ref: '#/components/schemas/WijzigingNaam'
          betrokkenVestigingen:
            $ref: '#/components/schemas/BetrokkenVestigingType'
    SignaalFusieSplitsing202501SignalType:
      allOf:
      - $ref: '#/components/schemas/BaseSignalType'
      - required:
        - fusieSplitsing
        type: object
        properties:
          fusieSplitsing:
            $ref: '#/components/schemas/FusieSplitsingType'
    SignaalActiviteitenWijziging202501SignalType:
      allOf:
      - $ref: '#/components/schemas/BaseSignalType'
      - required:
        - indicatieCorrectie
        - isUniekeSbiCodeWijziging
        - startdatum
        type: object
        properties:
          indicatieCorrectie:
            type: boolean
          startdatum:
            type: string
            format: YYYYMMDD
            example: "20241216"
          isUniekeSbiCodeWijziging:
            type: boolean
    BaseSignalType:
      required:
      - berichtId
      - heeftBetrekkingOp
      - registratieId
      - registratieTijdstip
      - signaalType
      type: object
      properties:
        berichtId:
          type: string
        heeftBetrekkingOp:
          $ref: '#/components/schemas/MaatschappelijkeActiviteitType'
        registratieId:
          type: string
        registratieTijdstip:
          type: string
          format: date-time
        signaalType:
          $ref: '#/components/schemas/SignaalType'
    EnumeratieType:
      required:
      - code
      - omschrijving
      type: object
      properties:
        code:
          type: string
          example: " AA, BB, CC"
        omschrijving:
          type: string
    VoortzettingEnOverdrachtType:
      required:
      - betrokkenVestigingen
      - kvkNummer
      - persoonRechtsvorm
      - rolBijVoortzettingOverdracht
      type: object
      properties:
        betrokkenVestigingen:
          $ref: '#/components/schemas/BetrokkenVestigingenType'
        rolBijVoortzettingOverdracht:
          $ref: '#/components/schemas/EnumeratieType'
        kvkNummer:
          type: string
          default: ""
        persoonRechtsvorm:
          type: string
          example: Stichting
    BetrokkenVestigingenType:
      required:
      - vestigingsnummers
      type: object
      properties:
        vestigingsnummers:
          type: array
          items:
            $ref: '#/components/schemas/VestigingsnummerType'
    VestigingsnummerType:
      type: string
      example: "000067170137"
    WijzigingNaam:
      required:
      - handelsNaam
      - statutaireNaam
      type: object
      properties:
        statutaireNaam:
          type: string
        handelsNaam:
          type: string
    BetrokkenVestigingType:
      type: object
      properties:
        vestigingsnummers:
          type: array
          items:
            $ref: '#/components/schemas/VestigingsnummerType'
    FusieSplitsingType:
      required:
      - betrokkenOndernemingen
      - rol
      - startdatum
      - status
      - type
      type: object
      properties:
        startdatum:
          type: string
          format: YYYYMMDD
          example: "20230213"
        type:
          type: string
          example: FUSIE
        status:
          type: string
          example: GEREALISEERD
        rol:
          type: string
          example: VERKRIJGEND
        betrokkenOndernemingen:
          $ref: '#/components/schemas/betrokkenOndernemingenType'
    ActiviteitenWijzigingItemType:
      required:
      - categories
      - functie
      - soortMutatie
      type: object
      properties:
        functie:
          $ref: '#/components/schemas/ActiviteitenWijzigingItemType_functie'
        soortMutatie:
          $ref: '#/components/schemas/ActiviteitenWijzigingItemType_soortMutatie'
        categories:
          type: array
          description: Categories associated with the position change
          items:
            type: string
    betrokkenOndernemingenType:
      type: object
      properties:
        kvkNummers:
          type: array
          items:
            type: string
            example: "71236333"
    SignaalType:
      type: string
      enum:
      - SignaalGewijzigdeInschrijving
      - SignaalNieuweInschrijving
      - SignaalGewijzigdeVestiging
      - SignaalBeeindiging_2025_01
      - SignaalRechtsvormwijziging_2025_01
      - SignaalVoortzettingEnOverdracht_2025_01
      - SignaalAdreswijziging_2025_01
      - SignaalNaamgeving_2025_01
      - SignaalFusieSplitsing_2025_01
      - SignaalActiviteitenWijziging_2025_01
    GewijzigdeGegevensType:
      required:
      - deponeringen
      - eigenaar
      - functionarissen
      - maOnderneming
      - vestigingen
      type: object
      properties:
        deponeringen:
          $ref: '#/components/schemas/GewijzigdeDeponeringenType'
        eigenaar:
          $ref: '#/components/schemas/GewijzigdeEigenaarType'
        functionarissen:
          $ref: '#/components/schemas/GewijzigdeFunctionarissenType'
        maOnderneming:
          $ref: '#/components/schemas/GewijzigdeMaOndernemingType'
        vestigingen:
          $ref: '#/components/schemas/GewijzigdeVestigingenType'
    GewijzigdeDeponeringenType:
      type: object
      properties:
        gewijzigdeDeponeringen:
          type: array
          items:
            $ref: '#/components/schemas/GewijzigdeDeponeringType'
    GewijzigdeDeponeringType:
      required:
      - aansprakelijkheid
      - depotId
      - jaarstuk
      - overigeDeponering
      type: object
      properties:
        aansprakelijkheid:
          type: boolean
        depotId:
          type: string
        jaarstuk:
          type: boolean
        overigeDeponering:
          type: boolean
    GewijzigdeEigenaarType:
      required:
      - beperkingInRechtshandeling
      - bijzondererechtstoestand
      - buitenlandseVennootschap
      - eenmanszaak
      - eenmanszaakMetMeerdereEigenaren
      - fusieEnSplitsing
      - ontbindingEnLiquidatie
      - rechtspersoon
      - rechtspersoonActiviteiten
      - rechtspersoonAdresgegevens
      - rechtspersoonInOprichting
      - samenwerkingsverband
      type: object
      properties:
        beperkingInRechtshandeling:
          type: boolean
        bijzondererechtstoestand:
          type: boolean
        buitenlandseVennootschap:
          type: boolean
        eenmanszaak:
          type: boolean
        eenmanszaakMetMeerdereEigenaren:
          type: boolean
        fusieEnSplitsing:
          type: boolean
        ontbindingEnLiquidatie:
          type: boolean
        rechtspersoon:
          type: boolean
        rechtspersoonActiviteiten:
          type: boolean
        rechtspersoonAdresgegevens:
          type: boolean
        rechtspersoonInOprichting:
          type: boolean
        samenwerkingsverband:
          type: boolean
    GewijzigdeFunctionarissenType:
      required:
      - aansprakelijke
      - bestuursfunctie
      - functionarisBijzondereRechtstoestand
      - gemachtigde
      - overigeFunctionaris
      - publiekRechtelijkeFunctionaris
      type: object
      properties:
        aansprakelijke:
          type: boolean
        bestuursfunctie:
          type: boolean
        functionarisBijzondereRechtstoestand:
          type: boolean
        gemachtigde:
          type: boolean
        overigeFunctionaris:
          type: boolean
        publiekRechtelijkeFunctionaris:
          type: boolean
    GewijzigdeMaOndernemingType:
      required:
      - algemeen
      type: object
      properties:
        algemeen:
          type: boolean
    GewijzigdeVestigingenType:
      type: object
      properties:
        gewijzigdevestigingen:
          type: array
          items:
            $ref: '#/components/schemas/GewijzigdeVestigingType'
    GewijzigdeVestigingType:
      required:
      - activiteiten
      - adresgegevens
      - algemeen
      - gevolmachtigden
      - naamgeving
      - vestigingsnummer
      type: object
      properties:
        activiteiten:
          type: boolean
        adresgegevens:
          type: boolean
        algemeen:
          type: boolean
        gevolmachtigden:
          type: boolean
        naamgeving:
          type: boolean
        vestigingsnummer:
          type: string
    VestigingDetailsType:
      required:
      - gewijzigdeGegevens
      - isCommercieel
      - isHoofdvestiging
      - vestigingsnummer
      type: object
      properties:
        gewijzigdeGegevens:
          $ref: '#/components/schemas/GewijzigdeVestigingGegevensType'
        isCommercieel:
          type: boolean
        isHoofdvestiging:
          type: boolean
        vestigingsnummer:
          type: string
    GewijzigdeVestigingGegevensType:
      required:
      - activiteiten
      - adresgegevens
      - gevolmachtigden
      - naamgeving
      type: object
      properties:
        activiteiten:
          type: boolean
        adresgegevens:
          type: boolean
        gevolmachtigden:
          type: boolean
        naamgeving:
          type: boolean
    SignaalNieuweInschrijvingType:
      required:
      - aanleiding
      - startdatum
      type: object
      properties:
        aanleiding:
          $ref: '#/components/schemas/EnumeratieType_1'
        kvkNummer:
          type: string
        startdatum:
          type: string
    EnumeratieType_1:
      required:
      - code
      - omschrijving
      type: object
      properties:
        code:
          type: string
        omschrijving:
          type: string
    MaatschappelijkeActiviteitType:
      required:
      - kvkNummer
      - nonMailing
      type: object
      properties:
        heeftAlsEigenaar:
          $ref: '#/components/schemas/EigenaarType'
        kvkNummer:
          type: string
        nonMailing:
          type: boolean
        totaalWerkzamePersonen:
          type: integer
        wordtUitgeoefendIn:
          type: array
          items:
            $ref: '#/components/schemas/VestigingType'
    EigenaarType:
      type: object
      properties:
        natuurlijkPersoon:
          $ref: '#/components/schemas/NatuurlijkPersoonType'
        rechtspersoon:
          $ref: '#/components/schemas/RechtspersoonType'
    NatuurlijkPersoonType:
      type: object
      properties:
        persoonRechtsvorm:
          type: string
    RechtspersoonType:
      type: object
      properties:
        activiteiten:
          type: array
          items:
            $ref: '#/components/schemas/ActiviteitType'
        bezoekadres:
          $ref: '#/components/schemas/LocatieType'
        persoonRechtsvorm:
          type: string
        rsin:
          type: string
    ActiviteitType:
      required:
      - sbiCode
      type: object
      properties:
        isHoofdactiviteit:
          type: boolean
        sbiCode:
          type: string
    LocatieType:
      required:
      - afgeschermd
      type: object
      properties:
        afgeschermd:
          type: boolean
        postcode:
          $ref: '#/components/schemas/PostcodeType'
    PostcodeType:
      required:
      - cijfercombinatie
      type: object
      properties:
        cijfercombinatie:
          type: string
        lettercombinatie:
          type: string
    VestigingType:
      required:
      - vestigingsnummer
      type: object
      properties:
        activiteiten:
          type: array
          items:
            $ref: '#/components/schemas/ActiviteitType'
        bezoekadres:
          $ref: '#/components/schemas/LocatieType'
        isHoofdvestiging:
          type: boolean
        totaalWerkzamePersonen:
          type: integer
        vestigingsnummer:
          type: string
    ActiviteitenWijzigingItemType_functie:
      required:
      - code
      - omschrijving
      type: object
      properties:
        code:
          type: string
          description: Code identifying the position
          example: "02"
        omschrijving:
          type: string
          description: Human-readable name of the position
          example: Bestuurder
      example: null
    ActiviteitenWijzigingItemType_soortMutatie:
      required:
      - code
      - omschrijving
      type: object
      properties:
        code:
          type: string
          description: Code identifying the type of change
          example: "01"
        omschrijving:
          type: string
          description: Human-readable description of the change
          example: Toetreding
      example: null
  responses:
    ForbiddenResponse:
      description: ""
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    ProblemDetailResponse:
      description: ""
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    UnprocessableResponse:
      description: ""
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    UnauthorizedResponse:
      description: ""
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
  parameters:
    AbonnementId:
      name: abonnementId
      in: path
      description: abonnement id
      required: true
      style: simple
      explode: false
      schema:
        type: string
    Vanaf:
      name: vanaf
      in: query
      description: de vanaf datum-tijd
      required: false
      style: form
      explode: true
      schema:
        type: string
        format: date-time
    Aantal:
      name: aantal
      in: query
      description: Aantal zoekresultaten per pagina.
      required: false
      style: form
      explode: true
      schema:
        maximum: 500
        minimum: 10
        type: integer
        default: 100
    Tot:
      name: tot
      in: query
      description: de tot datum-tijd
      required: false
      style: form
      explode: true
      schema:
        type: string
        format: date-time
    SignaalId:
      name: signaalId
      in: path
      description: signaal id
      required: true
      style: simple
      explode: false
      schema:
        type: string
    Pagina:
      name: pagina
      in: query
      description: Geeft aan welke pagina je op wilt vragen. Start vanaf pagina 1
      required: false
      style: form
      explode: true
      schema:
        minimum: 1
        type: integer
        default: 1
  examples:
    SignaalGewijzigdeInschrijving:
      summary: SignaalGewijzigdeInschrijving
      description: Voorbeeld van SignaalGewijzigdeInschrijving
      value:
        signaal:
          berichtId: 3e96fad5-606e-43be-9bd5-4718f8afd273
          heeftBetrekkingOp:
            kvkNummer: "69792917"
            nonMailing: true
            heeftAlsEigenaar:
              rechtspersoon:
                activiteiten: []
                bezoekadres:
                  afgeschermd: false
                  postcode:
                    cijfercombinatie: "3436"
                    lettercombinatie: JD
                persoonRechtsvorm: Besloten Vennootschap
                rsin: "858435020"
            totaalWerkzamePersonen: 12
            wordtUitgeoefendIn:
            - vestigingsnummer: "000038821281"
              activiteiten:
              - sbiCode: "93127"
                isHoofdactiviteit: true
              bezoekadres:
                afgeschermd: false
                postcode:
                  cijfercombinatie: "3436"
                  lettercombinatie: JD
              isHoofdvestiging: true
              totaalWerkzamePersonen: 8
            - vestigingsnummer: "000038821303"
              activiteiten:
              - sbiCode: "93127"
                isHoofdactiviteit: true
              bezoekadres:
                afgeschermd: false
                postcode:
                  cijfercombinatie: "6611"
                  lettercombinatie: CH
              isHoofdvestiging: false
              totaalWerkzamePersonen: 4
          registratieId: -64945f8e:18f77b51fa3:-4654
          registratieTijdstip: 2024-05-14T15:25:13.773Z
          signaalType: SignaalGewijzigdeInschrijving
          heeftGewijzigdeGegevens:
            deponeringen:
              gewijzigdeDeponeringen: []
            eigenaar:
              beperkingInRechtshandeling: false
              bijzondererechtstoestand: false
              buitenlandseVennootschap: false
              eenmanszaak: false
              eenmanszaakMetMeerdereEigenaren: false
              fusieEnSplitsing: false
              ontbindingEnLiquidatie: false
              rechtspersoon: false
              rechtspersoonActiviteiten: false
              rechtspersoonAdresgegevens: false
              rechtspersoonInOprichting: false
              samenwerkingsverband: false
            functionarissen:
              aansprakelijke: false
              bestuursfunctie: true
              functionarisBijzondereRechtstoestand: false
              gemachtigde: false
              overigeFunctionaris: false
              publiekRechtelijkeFunctionaris: false
            maOnderneming:
              algemeen: false
            vestigingen:
              gewijzigdevestigingen: []
          indicatieCorrectie: false
    SignaalGewijzigdeVestiging:
      summary: SignaalGewijzigdeVestiging
      description: Voorbeeld van SignaalGewijzigdeVestiging
      value:
        signaal:
          signaalType: SignaalGewijzigdeVestiging
          berichtId: 993b818c-e87e-4039-9f33-03177bb58df6
          registratieId: 188516b7:19317a92bd2:-3a88
          registratieTijdstip: 2024-11-10T20:00:04.602Z
          heeftBetrekkingOp:
            kvkNummer: "16059814"
            nonMailing: true
            totaalWerkzamePersonen: null
            heeftAlsEigenaar: null
            wordtUitgeoefendIn: []
          indicatieCorrectie: false
          heeftGewijzigdeGegevens: null
          heeftNieuweGegevens: null
          heeftGewijzigdeVestiging:
            vestigingsnummer: "000025243640"
            isHoofdvestiging: false
            isCommercieel: false
            gewijzigdeGegevens:
              naamgeving: false
              activiteiten: false
              adresgegevens: true
              gevolmachtigden: false
    SignaalNieuweInschrijving:
      summary: SignaalNieuweInschrijving
      description: Voorbeeld van SignaalNieuweInschrijving
      value:
        signaal:
          signaalType: SignaalNieuweInschrijving
          berichtId: f82cd56e-de27-4b09-9760-6a3722f063af
          registratieId: -4c4989e4:18f04f7a4cb:7cab
          registratieTijdstip: 2024-04-22T08:48:30.527Z
          heeftBetrekkingOp:
            kvkNummer: "95236376"
            nonMailing: true
            totaalWerkzamePersonen: 4
            heeftAlsEigenaar:
              natuurlijkPersoon: null
              rechtspersoon:
                persoonRechtsvorm: Besloten Vennootschap
                rsin: "874730107"
                bezoekadres:
                  postcode:
                    cijfercombinatie: "2321"
                    lettercombinatie: PV
                  afgeschermd: false
                activiteiten: []
            wordtUitgeoefendIn:
            - vestigingsnummer: "000071586547"
              bezoekadres:
                postcode:
                  cijfercombinatie: "2321"
                  lettercombinatie: PV
                afgeschermd: false
              activiteiten:
              - sbiCode: "93127"
                isHoofdactiviteit: true
              isHoofdvestiging: true
              totaalWerkzamePersonen: 4
          indicatieCorrectie: false
          heeftGewijzigdeGegevens: null
          heeftNieuweGegevens:
            startdatum: "20090423"
            aanleiding:
              code: OR
              omschrijving: Oprichten
            kvkNummer: "95236376"
    SignaalBeeindiging202501:
      summary: SignaalBeeindiging202501
      description: Voorbeeld van Beeindiging202501
      value:
        signaal:
          signaalType: SignaalBeeindiging_2025_01
          berichtId: 879f6757-9e28-49e8-af75-6c14a376a59c
          registratieId: -65d8948f:19468e72c2e:-3278
          registratieTijdstip: 2025-01-15T10:26:14.01Z
          heeftBetrekkingOp:
            kvkNummer: "99958317"
            nonMailing: false
            totaalWerkzamePersonen: 4
            heeftAlsEigenaar:
              natuurlijkPersoon: null
              rechtspersoon:
                persoonRechtsvorm: Vennootschap Onder Firma
                rsin: "877745808"
                bezoekadres:
                  postcode:
                    cijfercombinatie: "4143"
                    lettercombinatie: EJ
                  afgeschermd: false
                activiteiten: []
            wordtUitgeoefendIn:
            - vestigingsnummer: "000076175545"
              bezoekadres:
                postcode:
                  cijfercombinatie: "4143"
                  lettercombinatie: EJ
                afgeschermd: false
              activiteiten: []
              isHoofdvestiging: true
              totaalWerkzamePersonen: 4
          indicatieCorrectie: null
          startdatum: "20241216"
          aanleiding:
            code: ZZ
            omschrijving: TODO
    SignaalRechtsvormwijziging202501:
      summary: SignaalRechtsvormwijziging202501
      description: Voorbeeld van Rechtsvormwijziging202501
      value:
        signaal:
          signaalType: SignaalRechtsvormwijziging_2025_01
          berichtId: fd3638d8-794e-4634-90a5-cc07e928c3b4
          heeftBetrekkingOp:
            heeftAlsEigenaar:
              natuurlijkPersoon: null
              rechtspersoon:
                activiteiten: []
                bezoekadres:
                  afgeschermd: false
                  postcode:
                    cijfercombinatie: "2925"
                    lettercombinatie: AV
                persoonRechtsvorm: Besloten Vennootschap
                rsin: "855989452"
            kvkNummer: "65124006"
            nonMailing: true
            totaalWerkzamePersonen: 2
            wordtUitgeoefendIn:
            - activiteiten:
              - isHoofdactiviteit: true
                sbiCode: "7912"
              bezoekadres:
                afgeschermd: false
                postcode:
                  cijfercombinatie: "2925"
                  lettercombinatie: AV
              isHoofdvestiging: true
              totaalWerkzamePersonen: 2
              vestigingsnummer: "000011104473"
          persoonRechtsvormOud: Rechtspersoon in oprichting
          registratieId: 5eb1093e:1554eedd03d:43da
          registratieTijdstip: 2016-06-14T12:51:27.539Z
          startdatum: "20160614"
    SignaalVoortzettingEnOverdracht202501:
      summary: SignaalVoortzettingEnOverdracht202501
      description: Voorbeeld van VoortzettingEnOverdracht202501
      value:
        signaal:
          berichtId: 5a66dd4a-20d4-4674-af2e-24926d422750
          signaalType: SignaalVoortzettingEnOverdracht_2025_01
          heeftBetrekkingOp:
            heeftAlsEigenaar:
              natuurlijkPersoon:
                persoonRechtsvorm: Eenmanszaak
              rechtspersoon: null
            kvkNummer: "91162181"
            nonMailing: false
            totaalWerkzamePersonen: 1
            wordtUitgeoefendIn:
            - activiteiten:
              - isHoofdactiviteit: true
                sbiCode: "01241"
              bezoekadres:
                afgeschermd: false
                postcode:
                  cijfercombinatie: "7856"
                  lettercombinatie: QQ
              isHoofdvestiging: true
              totaalWerkzamePersonen: 1
              vestigingsnummer: "000067170129"
          indicatieCorrectie: false
          registratieId: 63601b86:1869d52cf24:-4098
          registratieTijdstip: 2023-03-01T13:19:16.683Z
          startdatum: "20230219"
          voortzettingEnOverdracht:
            betrokkenVestigingen:
              vestigingsnummers:
              - "000067170137"
            kvkNummer: "91162238"
            persoonRechtsvorm: Stichting
            rolBijVoortzettingOverdracht:
              code: OG
              omschrijving: Overgedragen aan
    SignaalAdreswijziging202501:
      summary: SignaalAdreswijziging202501
      description: Voorbeeld van SignaalAdreswijziging202501
      value:
        signaal:
          signaalType: SignaalAdreswijziging_2025_01
          berichtId: 909387b4-26bf-4dd7-8800-997d69f5d386
          registratieId: -6f248a18:1864ac2a5ea:13a2
          registratieTijdstip: 2023-02-13T12:45:21.314Z
          heeftBetrekkingOp:
            kvkNummer: "91028566"
            nonMailing: true
            totaalWerkzamePersonen: 3
            heeftAlsEigenaar:
              natuurlijkPersoon: null
              rechtspersoon:
                persoonRechtsvorm: Naamloze Vennootschap
                rsin: "872121367"
                bezoekadres:
                  postcode:
                    cijfercombinatie: "1733"
                    lettercombinatie: AA
                  afgeschermd: false
                activiteiten: []
            wordtUitgeoefendIn:
            - vestigingsnummer: "000067022391"
              bezoekadres:
                postcode:
                  cijfercombinatie: "1733"
                  lettercombinatie: AA
                afgeschermd: false
              activiteiten:
              - sbiCode: "01242"
                isHoofdactiviteit: true
              isHoofdvestiging: true
              totaalWerkzamePersonen: 3
          indicatieCorrectie: false
          startdatum: "20230213"
          adreswijzigings:
          - vestigingsnummer: "000067022391"
            betreft:
              code: "01"
              omschrijving: Bezoekadres
            aanleiding:
              code: "01"
              omschrijving: Verhuizing
    SignaalNaamgeving202501:
      summary: SignaalNaamgeving202501
      description: Voorbeeld van Naamgeving202501
      value:
        signaal:
          signaalType: SignaalNaamgeving_2025_01
          berichtId: 678920a4-845b-48c5-a795-04a5e375e3bc
          registratieId: -48b1e8e:197ad8024ce:147a
          registratieTijdstip: 2025-06-26T18:37:13.052Z
          heeftBetrekkingOp:
            kvkNummer: "42252832"
            nonMailing: true
            totaalWerkzamePersonen: 118
            heeftAlsEigenaar:
              natuurlijkPersoon: null
              rechtspersoon:
                persoonRechtsvorm: Besloten Vennootschap
                rsin: "879666614"
                bezoekadres:
                  postcode:
                    cijfercombinatie: "2585"
                    lettercombinatie: AP
                  afgeschermd: false
                activiteiten: []
            wordtUitgeoefendIn:
            - vestigingsnummer: "000078892937"
              bezoekadres:
                postcode:
                  cijfercombinatie: "2585"
                  lettercombinatie: AP
                afgeschermd: false
              activiteiten:
              - sbiCode: "01242"
                isHoofdactiviteit: true
              isHoofdvestiging: true
              totaalWerkzamePersonen: 50
            - vestigingsnummer: "000078892945"
              bezoekadres:
                postcode:
                  cijfercombinatie: "4175"
                  lettercombinatie: CG
                afgeschermd: false
              activiteiten:
              - sbiCode: "01242"
                isHoofdactiviteit: true
              isHoofdvestiging: false
              totaalWerkzamePersonen: 68
          indicatieCorrectie: false
          wijzigingNaam:
            statutaireNaam: false
            handelsNaam: true
          betrokkenVestigingen:
            vestigingsnummers:
            - "000078892937"
            - "000078892945"
    SignaalFusieSplitsing202501:
      summary: SignaalFusieSplitsing202501
      description: Voorbeeld van SignaalFusieSplitsing202501
      value:
        signaal:
          signaalType: SignaalFusieSplitsing_2025_01
          berichtId: 87f23055-36ef-4c29-a6df-eccd913d5086
          registratieId: -7790865c:15f7c1b0780:2779
          registratieTijdstip: 2023-02-13T12:45:21.314Z
          heeftBetrekkingOp:
            kvkNummer: "71236236"
            nonMailing: false
            totaalWerkzamePersonen: 25
            heeftAlsEigenaar:
              natuurlijkPersoon: null
              rechtspersoon:
                persoonRechtsvorm: Naamloze Vennootschap
                rsin: "859282041"
                bezoekadres:
                  postcode:
                    cijfercombinatie: "2911"
                    lettercombinatie: QQ
                  afgeschermd: false
                activiteiten: []
            wordtUitgeoefendIn:
            - vestigingsnummer: "000040834328"
              bezoekadres:
                postcode:
                  cijfercombinatie: "2911"
                  lettercombinatie: QQ
                afgeschermd: false
              activiteiten:
              - sbiCode: "01411"
                isHoofdactiviteit: true
              isHoofdvestiging: true
              totaalWerkzamePersonen: 23
            - vestigingsnummer: "000040834468"
              bezoekadres:
                postcode:
                  cijfercombinatie: "3161"
                  lettercombinatie: SF
                afgeschermd: false
              activiteiten:
              - sbiCode: "01301"
                isHoofdactiviteit: true
              isHoofdvestiging: false
              totaalWerkzamePersonen: 2
          indicatieCorrectie: false
          startdatum: "20230213"
          fusieSplitsing:
            type: FUSIE
            status: GEREALISEERD
            betrokkenOndernemingen:
              kvkNummers:
              - "71236333"
              - "71236236"
            startdatum: "20171102"
            rol: VERKRIJGEND
    SignaalActiviteitenWijziging202501:
      summary: SignaalActiviteitenWijziging202501
      description: Voorbeeld van SignaalActiviteitenWijziging202501
      value:
        signaal:
          signaalType: SignaalActiviteitenWijziging_2025_01
          berichtId: 1745f5ff-10cf-4461-b350-41db63419a90
          registratieId: 79fca002:1990b960915:-4020
          registratieTijdstip: 2023-02-13T12:45:21.314Z
          heeftBetrekkingOp:
            kvkNummer: "42372699"
            nonMailing: false
            totaalWerkzamePersonen: null
            heeftAlsEigenaar:
              natuurlijkPersoon: null
              rechtspersoon:
                persoonRechtsvorm: Stichting
                rsin: "880655586"
                bezoekadres:
                  postcode:
                    cijfercombinatie: "4797"
                    lettercombinatie: HL
                  afgeschermd: false
                activiteiten:
                - sbiCode: "01242"
                  isHoofdactiviteit: true
            wordtUitgeoefendIn: []
          indicatieCorrectie: false
          startdatum: "20250902"
          isUniekeSbiCodeWijziging: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: apikey
      in: header
