Kamer van Koophandel (KVK)

Kamer van Koophandel (KVK) Zoeken API

The Zoeken API from Kamer van Koophandel (KVK) — 1 operation(s) for zoeken.

Documentation GitHub OpenAPI

Operations 1

GET /zoeken Voor een bedrijf zoeken naar basisinformatie #

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-zoeken-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

openapi: 3.2.0
info:
  title: Kvk Nl Zoeken API
  version: 2.1.0
  description: 'Operations tagged Zoeken across 2 of this provider''s published API definitions: api_zoeken_widget.yaml, kvk-nl-zoeken-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: /test/api/v2
  description: only for testing with Swagger widget
- url: https://api.kvk.nl/api/v2
  description: Production (developers.kvk.nl docs)
- url: https://api.kvk.nl/test/api/v2
  description: Test environment (fictitious data)
tags:
- name: Zoeken
paths:
  /zoeken:
    get:
      tags:
      - Zoeken
      summary: Voor een bedrijf zoeken naar basisinformatie
      description: Er wordt max. 1000 resultaten getoond.
      operationId: getResults
      parameters:
      - name: kvkNummer
        in: query
        description: Nederlands Kamer van Koophandel nummer dat bestaat uit 8 cijfers
        schema:
          pattern: ^[0-9]{8}$
          type: string
      - name: rsin
        in: query
        description: Rechtspersonen Samenwerkingsverbanden Informatie Nummer dat bestaat uit 9 cijfers
        schema:
          pattern: ^[0-9]{9}$
          type: string
      - name: vestigingsnummer
        in: query
        description: Vestigingsnummer dat bestaat uit 12 cijfers
        schema:
          pattern: ^[0-9]{12}$
          type: string
      - name: naam
        in: query
        description: De naam waaronder een vestiging of rechtspersoon handelt
        schema:
          type: string
      - name: straatnaam
        in: query
        schema:
          type: string
      - name: plaats
        in: query
        schema:
          type: string
      - name: postcode
        in: query
        description: Mag alleen in combinatie met huisnummer of postbusnummer gezocht worden
        schema:
          pattern: ^[0-9]{4}[a-z,A-Z]{2}$
          type: string
      - name: huisnummer
        in: query
        description: Mag alleen in combinatie met postcode gezocht worden
        schema:
          pattern: ^[0-9]{1,5}$
          type: integer
      - name: huisletter
        in: query
        description: Optioneel. Alleen in combinatie met huisnummer
        schema:
          pattern: ^[a-z,A-Z]{1}$
          type: string
      - name: postbusnummer
        in: query
        description: Mag alleen in combinatie met postcode gezocht worden
        schema:
          pattern: ^[0-9]{1,5}$
          type: integer
      - name: type
        in: query
        description: 'Filter op type: hoofdvestiging, nevenvestiging en/of rechtspersoon'
        schema:
          type: array
          items:
            type: string
            enum:
            - hoofdvestiging
            - nevenvestiging
            - rechtspersoon
      - name: inclusiefInactieveRegistraties
        in: query
        description: Inclusief inactieve registraties
        schema:
          type: boolean
      - name: pagina
        in: query
        description: Paginanummer, minimaal 1 en maximaal 1000
        schema:
          maximum: 1000
          type: integer
          default: 1
      - name: resultatenPerPagina
        in: query
        description: Kies het aantal resultaten per pagina, minimaal 1 en maximaal 100
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 10
      responses:
        '200':
          description: OK
          headers:
            api-version:
              $ref: '#/components/headers/api_version'
            warning:
              $ref: '#/components/headers/warning'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Resultaat'
            application/hal+json:
              schema:
                $ref: '#/components/schemas/Resultaat'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '406':
          $ref: '#/components/responses/NotAcceptable'
        '500':
          $ref: '#/components/responses/InternalServerError'
    servers:
    - url: /test/api/v2
      description: only for testing with Swagger widget
components:
  responses:
    NotFound:
      description: Er zijn geen resultaten gevonden aan de hand van de opgegeven parameter(s)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
        application/hal+json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: Niet geautoriseerd voor deze operatie
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
        application/hal+json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Geen of onjuiste apikey aangeleverd
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
        application/hal+json:
          schema:
            $ref: '#/components/schemas/Error'
    NotAcceptable:
      description: Opgegeven Accept header wordt niet ondersteund
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
        application/hal+json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalServerError:
      description: Er is een interne fout opgetreden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
        application/hal+json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: Een opgegeven parameter is niet valide
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
        application/hal+json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    BinnenlandsAdres:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/AdresType'
        straatnaam:
          type: string
        huisnummer:
          type: integer
          format: int32
        huisletter:
          type: string
        postbusnummer:
          type: integer
          description: Postbusnummer wordt alleen getoond indien het een postadres betreft
          format: int32
        postcode:
          type: string
        plaats:
          type: string
    ResultaatItem:
      type: object
      properties:
        kvkNummer:
          type: string
          description: Nederlands Kamer van Koophandel nummer dat bestaat uit 8 cijfers
        rsin:
          type: string
          description: Rechtspersonen Samenwerkingsverbanden Informatie Nummer dat bestaat uit 9 cijfers
        vestigingsnummer:
          type: string
          description: Vestigingsnummer dat bestaat uit 12 cijfers
        naam:
          type: string
          description: De naam waaronder een vestiging of rechtspersoon handelt
        adres:
          $ref: '#/components/schemas/Adres'
        type:
          type: string
          description: hoofdvestiging/nevenvestiging/rechtspersoon
        actief:
          type: string
          description: Indicatie of inschrijving actief is
        vervallenNaam:
          type: string
          description: Bevat de vervallen naam waaronder een vestiging of rechtspersoon heeft gehandeld
        links:
          $ref: '#/components/schemas/Links'
    Fout:
      type: object
      properties:
        code:
          type: string
          description: Foutcode
        omschrijving:
          type: string
          description: Omschrijving van de foutmelding
    BuitenlandsAdres:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/AdresType'
        straatHuisnummer:
          type: string
          description: Het straat/huisnummer is een combinatie van de straat en huisnummer
          example: 53 Rue de Tilsitt
        postcodeWoonplaats:
          type: string
          description: De postcode/woonplaats is de combinatie van een eventuele postcode en woonplaats
          example: X-13501 Parijs
        land:
          type: string
          description: De naam van het land waar het adres bevindt
          example: Frankrijk
    Links:
      type: array
      items:
        type: object
        properties:
          rel:
            type: string
          href:
            type: string
            format: uri
    Error:
      type: object
      properties:
        fout:
          type: array
          items:
            $ref: '#/components/schemas/Fout'
    Adres:
      type: object
      properties:
        binnenlandsAdres:
          $ref: '#/components/schemas/BinnenlandsAdres'
        buitenlandsAdres:
          $ref: '#/components/schemas/BuitenlandsAdres'
      description: Binnenlands of buitenlands adres
    Resultaat:
      type: object
      properties:
        pagina:
          type: integer
          description: Geeft aan op welke pagina je bent. Start vanaf pagina 1
          format: int32
        resultatenPerPagina:
          type: integer
          description: Geeft het aantal zoek resultaten per pagina weer
          format: int32
        totaal:
          type: integer
          description: Totaal aantal zoekresultaten gevonden. De API Zoeken toont max. 1000 resultaten.
          format: int32
        vorige:
          type: string
          description: Link naar de vorige pagina indien beschikbaar
        volgende:
          type: string
          description: Link naar de volgende pagina indien beschikbaar
        resultaten:
          type: array
          items:
            $ref: '#/components/schemas/ResultaatItem'
        links:
          $ref: '#/components/schemas/Links'
    AdresType:
      type: string
      description: Bezoekadres of postadres
      enum:
      - bezoekadres
      - postadres
  headers:
    warning:
      schema:
        type: string
        description: 'zie RFC 7234. In het geval een major versie wordt uitgefaseerd,

          gebruiken we warn-code 299 ("Miscellaneous Persistent Warning") en het API

          end-point (inclusief versienummer) als de warn-agent van de warning, gevolgd

          door de warn-text met de human-readable waarschuwing'
        example: '299 https://api.kvk.nl/api/v2/zoeken "Deze versie van de API is verouderd

          en zal uit dienst worden genomen op 2025-02-01. Raadpleeg voor meer informatie

          hier de documentatie: https://developers.kvk.nl/nl/apis/zoeken".

          '
    api_version:
      schema:
        type: string
        description: Geeft een specifieke API-versie aan in de context van een specifieke aanroep.
        example: 1.0.0
x-refined-from:
- api_zoeken_widget.yaml
- kvk-nl-zoeken-openapi.yml