Vestiging

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/kvk-nl/json-schema/kvk-nl-vestiging-schema.json",
  "title": "Vestiging",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/kvk-nl-basisprofiel-openapi.yml#/components/schemas/Vestiging",
  "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"
    },
    "rsin": {
      "type": "string",
      "description": "Rechtspersonen Samenwerkingsverbanden Informatie Nummer (dit outputveld wordt niet vermeld in de EmbeddedCointainer van hoofdvestiging)."
    },
    "indNonMailing": {
      "type": "string",
      "description": "Hiermee geeft de onderneming aan geen ongevraagde reclame per post of verkoop aan de deur te willen ontvangen"
    },
    "formeleRegistratiedatum": {
      "type": "string",
      "description": "Registratiedatum onderneming in HR"
    },
    "materieleRegistratie": {
      "$ref": "#/$defs/MaterieleRegistratie"
    },
    "statutaireNaam": {
      "type": "string",
      "description": "De naam van de vestiging wanneer er statuten geregistreerd zijn."
    },
    "eersteHandelsnaam": {
      "type": "string",
      "description": "De naam waaronder een onderneming of vestiging handelt"
    },
    "indHoofdvestiging": {
      "type": "string",
      "description": "Hoofdvestiging (Ja/Nee)"
    },
    "indCommercieleVestiging": {
      "type": "string",
      "description": "Commerciele vestiging  (Ja/Nee)"
    },
    "voltijdWerkzamePersonen": {
      "type": "integer",
      "description": "Aantal voltijd werkzame personen"
    },
    "totaalWerkzamePersonen": {
      "type": "integer",
      "description": "Totaal aantal werkzame personen"
    },
    "deeltijdWerkzamePersonen": {
      "type": "integer",
      "description": "Aantal deeltijd werkzame personen"
    },
    "handelsnamen": {
      "type": "array",
      "description": "Alle namen waaronder een vestiging handelt (op volgorde van registreren). Dit outputveld wordt niet vermeld in de EmbeddedCointainer van hoofdvestiging.",
      "items": {
        "$ref": "#/$defs/Handelsnaam"
      }
    },
    "adressen": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Adres"
      }
    },
    "websites": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sbiActiviteiten": {
      "type": "array",
      "description": "Code beschrijving van SBI activiteiten conform SBI 2008 (Standard Industrial Classification). Er wordt geen maximering toegepast in de resultaten. Zie ook KVK.nl/sbi",
      "items": {
        "$ref": "#/$defs/SBIActiviteit"
      }
    },
    "links": {
      "$ref": "#/$defs/Links"
    }
  },
  "$defs": {
    "Adres": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "description": "Correspondentieadres en/of bezoekadres"
        },
        "indAfgeschermd": {
          "type": "string",
          "description": "Indicatie of het adres is afgeschermd"
        },
        "volledigAdres": {
          "type": "string"
        },
        "straatnaam": {
          "type": "string"
        },
        "huisnummer": {
          "type": "integer",
          "format": "int32"
        },
        "huisletter": {
          "type": "string"
        },
        "huisnummerToevoeging": {
          "type": "string"
        },
        "toevoegingAdres": {
          "type": "string"
        },
        "postcode": {
          "type": "string"
        },
        "postbusnummer": {
          "type": "integer",
          "format": "int32"
        },
        "plaats": {
          "type": "string"
        },
        "straatHuisnummer": {
          "type": "string"
        },
        "postcodeWoonplaats": {
          "type": "string"
        },
        "regio": {
          "type": "string"
        },
        "land": {
          "type": "string"
        },
        "geoData": {
          "$ref": "#/$defs/GeoData"
        }
      }
    },
    "GeoData": {
      "type": "object",
      "properties": {
        "addresseerbaarObjectId": {
          "type": "string",
          "description": "Unieke BAG id"
        },
        "nummerAanduidingId": {
          "type": "string",
          "description": "Unieke BAG nummeraanduiding id"
        },
        "gpsLatitude": {
          "type": "number",
          "description": "Lengtegraad",
          "format": "double"
        },
        "gpsLongitude": {
          "type": "number",
          "description": "Breedtegraad",
          "format": "double"
        },
        "rijksdriehoekX": {
          "type": "number",
          "description": "Rijksdriehoek X-coördinaat",
          "format": "double"
        },
        "rijksdriehoekY": {
          "type": "number",
          "description": "Rijksdriehoek Y-coördinaat",
          "format": "double"
        },
        "rijksdriehoekZ": {
          "type": "number",
          "description": "Rijksdriehoek Z-coördinaat",
          "format": "double"
        }
      },
      "description": "Basisregistratie Adressen en Gebouwen gegevens uit het kadaster"
    },
    "Handelsnaam": {
      "type": "object",
      "properties": {
        "naam": {
          "type": "string"
        },
        "volgorde": {
          "type": "integer",
          "format": "int32"
        }
      },
      "description": "Alle namen waaronder een vestiging handelt (op volgorde van registreren). Dit outputveld wordt niet vermeld in de EmbeddedCointainer van hoofdvestiging."
    },
    "Links": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rel": {
            "type": "string"
          },
          "href": {
            "type": "string",
            "format": "uri"
          }
        }
      }
    },
    "MaterieleRegistratie": {
      "type": "object",
      "properties": {
        "datumAanvang": {
          "type": "string",
          "description": "Startdatum onderneming"
        },
        "datumEinde": {
          "type": "string",
          "description": "Einddatum onderneming"
        }
      }
    },
    "SBIActiviteit": {
      "type": "object",
      "properties": {
        "sbiCode": {
          "type": "string"
        },
        "sbiOmschrijving": {
          "type": "string"
        },
        "indHoofdactiviteit": {
          "type": "string"
        }
      },
      "description": "Code beschrijving van SBI activiteiten conform SBI 2008 (Standard Industrial Classification). Er wordt geen maximering toegepast in de resultaten. Zie ook KVK.nl/sbi"
    }
  }
}