Naamgeving

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/kvk-nl/json-schema/kvk-nl-naamgeving-schema.json",
  "title": "Naamgeving",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/kvk-nl-naamgeving-openapi.yml#/components/schemas/Naamgeving",
  "type": "object",
  "required": [
    "kvkNummer"
  ],
  "properties": {
    "kvkNummer": {
      "description": "Nederlands Kamer van Koophandel nummer",
      "type": "string"
    },
    "rsin": {
      "description": "RSIN (Rechtspersonen en Samenwerkingsverbanden Informatienummer)\n\nHet RSIN kan voorloopnullen bevatten\n",
      "type": "string",
      "pattern": "^[0-9]{9}$"
    },
    "statutaireNaam": {
      "description": "De naam van de rechtspersoon die opgenomen is in de oprichtingsakte",
      "type": "string"
    },
    "naam": {
      "description": "Naam of eerste handelsnaam van de inschrijving",
      "type": "string"
    },
    "ookGenoemd": {
      "description": "Een andere naam waaronder de vereniging, stichtingen en vereniging van eigenaars ook bekend is",
      "type": "string"
    },
    "startdatum": {
      "$ref": "#/$defs/Datum"
    },
    "einddatum": {
      "$ref": "#/$defs/Datum"
    },
    "vestigingen": {
      "description": "Lijst van vestigingen",
      "type": "array",
      "items": {
        "$ref": "#/$defs/Vestiging"
      }
    },
    "links": {
      "description": "URI naar API Basisprofiel voor het huidige kvknummer",
      "type": "object",
      "required": [
        "self",
        "basisprofiel"
      ],
      "properties": {
        "self": {
          "$ref": "#/$defs/Link"
        },
        "basisprofiel": {
          "$ref": "#/$defs/Link"
        }
      }
    }
  },
  "$defs": {
    "CommercieleVestiging": {
      "description": "Alle namen waaronder een vestiging handelt (op volgorde van registratie)",
      "type": "object",
      "required": [
        "vestigingsnummer"
      ],
      "properties": {
        "vestigingsnummer": {
          "description": "Uniek nummer dat bestaat uit 12 cijfers",
          "type": "string",
          "pattern": "^[0-9]{12}$"
        },
        "eersteHandelsnaam": {
          "description": "De eerste handelsnaam van de Vestiging",
          "type": "string"
        },
        "handelsnamen": {
          "description": "Alle namen waaronder een onderneming of vestiging handelt",
          "type": "array",
          "items": {
            "$ref": "#/$defs/Handelsnaam"
          }
        },
        "links": {
          "description": "URI naar API Vestigingsprofiel voor het huidige vestigingsnummer",
          "type": "object",
          "required": [
            "vestigingsprofiel"
          ],
          "properties": {
            "vestigingsprofiel": {
              "$ref": "#/$defs/Link"
            }
          }
        }
      }
    },
    "Datum": {
      "description": "In het handelsregister hebben we voor verschillende dossiers niet de exacte datums kunnen vastleggen.\nWe volgen hier de Handels Register datum vastlegging voor.\nHierdoor kan bij een onbekend deel van een datum nullen bevatten.\nBij een volledig bekende datum is het formaat YYYYMMDD ( Jaar maand dag),\nwaarbij alleen cijfers zijn toegestaan, inclusief de 0 voor onbekende delen van de datum.\n\n__Mogelijke formaten van waarden__\n\n| Type            | Formaat   |\n| --------------- | --------- |\n| Volledige datum | 20150622  |\n| Dag onbekend    | 20150600  |\n| Maand onbekend  | 20150012  |\n| Datum onbekend  | 00000000  |\n",
      "type": "string"
    },
    "Handelsnaam": {
      "description": "Een handelsnaam is een naam waaronder een vestiging van een onderneming handelt.",
      "type": "object",
      "properties": {
        "naam": {
          "description": "De handelsnaam van de vestiging",
          "type": "string"
        },
        "volgorde": {
          "description": "Het volgorde nummer van een handelsnaam",
          "type": "integer"
        }
      }
    },
    "Link": {
      "required": [
        "href"
      ],
      "type": "object",
      "properties": {
        "rel": {
          "type": "string"
        },
        "href": {
          "type": "string"
        },
        "title": {
          "type": "string",
          "description": "Omschrijving van de link"
        }
      }
    },
    "NietCommercieleVestiging": {
      "description": "De naam waaronder een niet commerciele vestiging bekend is",
      "type": "object",
      "required": [
        "vestigingsnummer"
      ],
      "properties": {
        "vestigingsnummer": {
          "description": "Uniek nummer dat bestaat uit 12 cijfers",
          "type": "string",
          "pattern": "^[0-9]{12}$"
        },
        "naam": {
          "description": "De naam van de Vestiging",
          "type": "string"
        },
        "ookGenoemd": {
          "description": "Een andere naam waaronder de vereniging, stichtingen en vereniging van eigenaars ook bekend is",
          "type": "string"
        },
        "links": {
          "description": "URI naar API Vestigingsprofiel voor het huidige vestigingsnummer",
          "type": "object",
          "required": [
            "vestigingsprofiel"
          ],
          "properties": {
            "vestigingsprofiel": {
              "$ref": "#/$defs/Link"
            }
          }
        }
      }
    },
    "Vestiging": {
      "oneOf": [
        {
          "$ref": "#/$defs/CommercieleVestiging"
        },
        {
          "$ref": "#/$defs/NietCommercieleVestiging"
        }
      ]
    }
  }
}