Basisprofiel

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/kvk-nl/json-schema/kvk-nl-basisprofiel-schema.json",
  "title": "Basisprofiel",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/kvk-nl-basisprofiel-openapi.yml#/components/schemas/Basisprofiel",
  "type": "object",
  "properties": {
    "kvkNummer": {
      "type": "string",
      "description": "Nederlands Kamer van Koophandel nummer: bestaat uit 8 cijfers"
    },
    "indNonMailing": {
      "type": "string",
      "description": "Hiermee geeft de onderneming aan geen ongevraagde reclame per post of verkoop aan de deur te willen ontvangen"
    },
    "naam": {
      "type": "string",
      "description": "Naam onder Maatschappelijke Activiteit"
    },
    "formeleRegistratiedatum": {
      "type": "string",
      "description": "Registratiedatum onderneming in HR"
    },
    "materieleRegistratie": {
      "$ref": "#/$defs/MaterieleRegistratie"
    },
    "totaalWerkzamePersonen": {
      "type": "integer",
      "description": "Totaal aantal werkzame personen",
      "format": "int32"
    },
    "statutaireNaam": {
      "type": "string",
      "description": "De naam van de onderneming wanneer er statuten geregistreerd zijn."
    },
    "handelsnamen": {
      "type": "array",
      "description": "Alle namen waaronder een onderneming of vestiging handelt (op volgorde van registreren)",
      "items": {
        "$ref": "#/$defs/Handelsnaam"
      }
    },
    "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"
    },
    "_embedded": {
      "$ref": "#/$defs/EmbeddedContainer"
    }
  },
  "$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"
        }
      }
    },
    "Eigenaar": {
      "type": "object",
      "properties": {
        "rsin": {
          "type": "string",
          "description": "Rechtspersonen Samenwerkingsverbanden Informatie Nummer"
        },
        "rechtsvorm": {
          "type": "string"
        },
        "uitgebreideRechtsvorm": {
          "type": "string"
        },
        "datumUitschrijving": {
          "type": "string",
          "description": "De datum dat de Niet Natuurlijk Persoon is uitgeschreven."
        },
        "adressen": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Adres"
          }
        },
        "websites": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "links": {
          "$ref": "#/$defs/Links"
        }
      }
    },
    "EmbeddedContainer": {
      "type": "object",
      "properties": {
        "hoofdvestiging": {
          "$ref": "#/$defs/Vestiging"
        },
        "eigenaar": {
          "$ref": "#/$defs/Eigenaar"
        }
      }
    },
    "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"
    },
    "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"
        }
      }
    }
  }
}