Kamer van Koophandel (KVK)

Kamer van Koophandel (KVK) Abonnement API

The Abonnement API from Kamer van Koophandel (KVK) — 2 operation(s) for abonnement.

GitHub OpenAPI

Operations 2

GET /v1/abonnementen List abonnementen #
GET /v1/abonnementen/{abonnementId} List signals by abonnement id #

Documentation

📖
Documentation
https://developers.kvk.nl/documentation/zoeken-api
📖
Documentation
https://developers.kvk.nl/documentation/basisprofiel-api
📖
Documentation
https://developers.kvk.nl/documentation/vestigingsprofiel-api
📖
Documentation
https://developers.kvk.nl/documentation/naamgeving-api
📖
Documentation
https://developers.kvk.nl/documentation/mutatieservice-api

Specifications

⚙
OpenAPI
https://artifacts.apis.io/kvk-nl/openapi/kvk-nl-abonnement-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/kvk-nl/json-schema/kvk-nl-paged-signalen-hal-type-schema.json
📊
JSONSchema
https://artifacts.apis.io/kvk-nl/json-schema/kvk-nl-abonnementen-hal-response-type-schema.json
📊
JSONSchema
https://artifacts.apis.io/kvk-nl/json-schema/kvk-nl-abonnementen-response-type-schema.json
📊
JSONSchema
https://artifacts.apis.io/kvk-nl/json-schema/kvk-nl-paged-signalen-type-schema.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/kvk-nl/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/kvk-nl:kvk-nl-abonnement-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

kvk-nl-abonnement-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Kvk Nl Abonnement API
  version: 1.0.8
  description: 'Operations tagged Abonnement across 2 of this provider''s published API definitions: api_kms_widget.yaml, kvk-nl-mutatieservice-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: /test/api
  description: Test API
- url: https://api.kvk.nl/api
  description: Production (developers.kvk.nl docs)
- url: https://api.kvk.nl/test/api
  description: Test environment (fictitious data)
tags:
- name: Abonnement
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/AbonnementenHalResponseType'
            application/json:
              schema:
                $ref: '#/components/schemas/AbonnementenResponseType'
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
              examples:
                BadRequestExample:
                  summary: Ongeldige verzoek parameters
                  value:
                    type: string
                    title: Ongeldige verzoek parameters
                    status: 400
                    detail: De parameter 'aantal' moet tussen 10 en 500 liggen.
                    instance: /v1/abonnementen
        '401':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
              examples:
                UnauthorizedExample:
                  summary: Ongeautoriseerde toegang
                  value:
                    type: string
                    title: Ongeautoriseerde toegang
                    status: 401
                    detail: De API key ontbreekt of is ongeldig..
                    instance: /v1/abonnementen
        '403':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
      summary: List abonnementen
      x-summary-source: derived
    servers:
    - url: /test/api
      description: Test API
  /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
          description: Het datum en tijdformaat moet voldoen aan RFC3339 op basis van ISO8601.
          format: date-time
      - name: tot
        in: query
        description: de tot datum-tijd
        required: false
        style: form
        explode: true
        schema:
          type: string
          description: Het datum en tijdformaat moet voldoen aan RFC3339 op basis van ISO8601.
          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/PagedSignalenHalType'
            application/json:
              schema:
                $ref: '#/components/schemas/PagedSignalenType'
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
              examples:
                BadRequestExample:
                  summary: Ongeldige verzoek parameters
                  value:
                    type: string
                    title: Ongeldige verzoek parameters
                    status: 400
                    detail: De parameter 'aantal' moet tussen 10 en 500 liggen.
                    instance: /v1/abonnementen
        '401':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
              examples:
                UnauthorizedExample:
                  summary: Ongeautoriseerde toegang
                  value:
                    type: string
                    title: Ongeautoriseerde toegang
                    status: 401
                    detail: De API key ontbreekt of is ongeldig..
                    instance: /v1/abonnementen
        '403':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
      summary: List signals by abonnement id
      x-summary-source: derived
    servers:
    - url: /test/api
      description: Test API
components:
  schemas:
    PagedSignalenHalType:
      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
    AbonnementenDetailResponseType:
      required:
      - klantId
      type: object
      properties:
        klantId:
          type: string
    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
      - SignaalInsolventie_2025_01
      - SignaalFunctionarisWijziging_2025_01
    HateoasLinks:
      required:
      - links
      type: object
      properties:
        links:
          maxItems: 10
          minItems: 1
          type: array
          description: Een array van HATEOAS links.
          items:
            $ref: '#/components/schemas/HateoasLink'
    PaginationInfo:
      required:
      - aantal
      - pagina
      - totaal
      - totaalPaginas
      type: object
      properties:
        pagina:
          type: integer
        aantal:
          type: integer
        totaal:
          type: number
        totaalPaginas:
          type: integer
    AbonnementDetail:
      required:
      - actief
      - contract
      - id
      - startDatum
      type: object
      properties:
        id:
          type: string
        contract:
          $ref: '#/components/schemas/ContractInfo'
        startDatum:
          type: string
          description: Het datum en tijdformaat moet voldoen aan RFC3339 op basis van ISO8601.
          format: date-time
        eindDatum:
          type: string
          description: Het datum en tijdformaat moet voldoen aan RFC3339 op basis van ISO8601.
          format: date-time
        actief:
          type: boolean
    ContractInfo:
      required:
      - id
      type: object
      properties:
        id:
          type: string
    AbonnementHal:
      allOf:
      - $ref: '#/components/schemas/AbonnementDetail'
      - $ref: '#/components/schemas/HateoasLinks'
    Abonnement:
      allOf:
      - $ref: '#/components/schemas/AbonnementDetail'
    SignaalInfoHal:
      allOf:
      - $ref: '#/components/schemas/SignaalInfo'
      - $ref: '#/components/schemas/HateoasLinks'
    HateoasLink:
      title: Link Description
      required:
      - href
      - rel
      type: object
      properties:
        href:
          type: string
          description: De volledige doel-URL. Om de bijbehorende aanroep te maken, combineert u de methode met deze [URI-sjabloon-geformatteerde](https://tools.ietf.org/html/rfc6570) link. Voor de voorbewerking voegt u de tekens `$`, `(` en `)` toe. De `href` is het belangrijkste HATEOAS-onderdeel dat een voltooide aanroep koppelt aan een volgende aanroep.
        rel:
          type: string
          description: Het [linkrelatietype](https://tools.ietf.org/html/rfc5988#section-4), dat dient als een ID voor een link die de semantiek van de link ondubbelzinnig beschrijft. Zie [Linkrelaties](https://www.iana.org/assignments/link-relations/link-relations.xhtml).
        method:
          type: string
          description: De HTTP-methode die nodig is om de betreffende oproep te doen.
          enum:
          - GET
          - POST
          - PUT
          - DELETE
          - HEAD
          - CONNECT
          - OPTIONS
          - PATCH
    AbonnementenResponseType:
      allOf:
      - $ref: '#/components/schemas/AbonnementenDetailResponseType'
      - required:
        - abonnementen
        type: object
        properties:
          abonnementen:
            type: array
            items:
              $ref: '#/components/schemas/Abonnement'
    AbonnementenHalResponseType:
      allOf:
      - $ref: '#/components/schemas/AbonnementenDetailResponseType'
      - required:
        - abonnementen
        type: object
        properties:
          abonnementen:
            type: array
            items:
              $ref: '#/components/schemas/AbonnementHal'
    SignaalInfo:
      required:
      - id
      - kvknummer
      - timestamp
      type: object
      properties:
        id:
          type: string
        timestamp:
          type: string
          description: Het datum en tijdformaat moet voldoen aan RFC3339 op basis van ISO8601.
          format: date-time
        kvknummer:
          type: string
          default: ''
        signaalType:
          $ref: '#/components/schemas/SignaalType'
        vestigingsnummer:
          type: string
    PagedSignalenType:
      allOf:
      - required:
        - signalen
        type: object
        properties:
          signalen:
            type: array
            items:
              $ref: '#/components/schemas/SignaalInfo'
      - $ref: '#/components/schemas/PaginationInfo'
    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
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: apikey
      in: header
x-refined-from:
- api_kms_widget.yaml
- kvk-nl-mutatieservice-openapi.yml