VestigingList

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/kvk-nl/json-schema/kvk-nl-vestiging-list-schema.json",
  "title": "VestigingList",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/kvk-nl-basisprofiel-openapi.yml#/components/schemas/VestigingList",
  "type": "object",
  "properties": {
    "kvkNummer": {
      "type": "string",
      "description": "Nederlands Kamer van Koophandel nummer: bestaat uit 8 cijfers"
    },
    "aantalCommercieleVestigingen": {
      "type": "integer",
      "format": "int64"
    },
    "aantalNietCommercieleVestigingen": {
      "type": "integer",
      "format": "int64"
    },
    "totaalAantalVestigingen": {
      "type": "integer",
      "format": "int64"
    },
    "vestigingen": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/VestigingBasis"
      }
    },
    "links": {
      "$ref": "#/$defs/Links"
    }
  },
  "$defs": {
    "Links": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rel": {
            "type": "string"
          },
          "href": {
            "type": "string",
            "format": "uri"
          }
        }
      }
    },
    "VestigingBasis": {
      "type": "object",
      "properties": {
        "vestigingsnummer": {
          "type": "string",
          "description": "Vestigingsnummer: uniek nummer dat bestaat uit 12 cijfers"
        },
        "kvkNummer": {
          "type": "string",
          "description": "Nederlands Kamer van Koophandel nummer: bestaat uit 8 cijfers"
        },
        "eersteHandelsnaam": {
          "type": "string",
          "description": "De naam waaronder een onderneming of vestiging handelt"
        },
        "indHoofdvestiging": {
          "type": "string",
          "description": "Hoofdvestiging (Ja/Nee)"
        },
        "indAdresAfgeschermd": {
          "type": "string",
          "description": "Indicatie of het adres is afgeschermd"
        },
        "indCommercieleVestiging": {
          "type": "string",
          "description": "Commerciele vestiging  (Ja/Nee)"
        },
        "volledigAdres": {
          "type": "string"
        },
        "links": {
          "$ref": "#/$defs/Links"
        }
      }
    }
  }
}