Bagnummeraanduidingen

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/amsterdam-nl/json-schema/amsterdam-nl-bagnummeraanduidingen-schema.json",
  "title": "Bagnummeraanduidingen",
  "description": "Een NUMMERAANDUIDING, in de volksmond ook wel adres genoemd, is een door het bevoegde gemeentelijke orgaan als zodanig toegekende aanduiding van een verblijfsobject, standplaats of ligplaats",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amsterdam-nl-bag-openapi.yml#/components/schemas/Bagnummeraanduidingen",
  "type": "object",
  "properties": {
    "_links": {
      "allOf": [
        {
          "$ref": "#/$defs/BagdefaultNummeraanduidingenLinks"
        }
      ],
      "title": " links"
    },
    "identificatie": {
      "type": "string",
      "title": "Nummeraanduiding ID",
      "description": "De unieke aanduiding van een nummeraanduiding"
    },
    "volgnummer": {
      "type": "integer",
      "maximum": 9223372036854775807,
      "minimum": -9223372036854775808,
      "format": "int64",
      "title": "Object volgnummer",
      "description": "Uniek volgnummer van de toestand van het object"
    },
    "plusvolgnummer": {
      "type": [
        "integer",
        "null"
      ],
      "maximum": 9223372036854775807,
      "minimum": -9223372036854775808,
      "format": "int64",
      "title": "Object plus volgnummer",
      "description": "Uniek BAG-plus volgnummer van de toestand van het object"
    },
    "registratiedatum": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "title": "Object registratie datum",
      "description": "De datum waarop de toestand van het object is geregistreerd"
    },
    "huisnummer": {
      "type": [
        "integer",
        "null"
      ],
      "maximum": 9223372036854775807,
      "minimum": -9223372036854775808,
      "format": "int64",
      "description": "Een door het bevoegde gemeentelijke orgaan ten aanzien van een adresseerbaar object toegekende nummering"
    },
    "geconstateerd": {
      "type": [
        "boolean",
        "null"
      ],
      "title": "Nummeraanduiding geconstateerd indicatie",
      "description": "Een aanduiding waarmee kan worden aangegeven dat een nummeraanduiding in de registratie is opgenomen als gevolg van een feitelijke constatering, zonder dat er op het moment van opname sprake was van een regulier brondocument voor deze opname"
    },
    "huisletter": {
      "type": [
        "string",
        "null"
      ],
      "description": "Een door het bevoegde gemeentelijke orgaan ten aanzien van een adresseerbaar object toegekende toevoeging aan een huisnummer in de vorm van een alfanumeriek teken"
    },
    "huisnummertoevoeging": {
      "type": [
        "string",
        "null"
      ],
      "title": "Huisnummer toevoeging",
      "description": "Een door het bevoegde gemeentelijke orgaan ten aanzien van een adresseerbaar object toegekende nadere toevoeging aan een huisnummer of een combinatie van huisnummer en huisletter"
    },
    "postcode": {
      "type": [
        "string",
        "null"
      ],
      "description": "De door PostNL vastgestelde code bestaande uit 4 cijfers en 2 letters (1234AB)"
    },
    "ligtInWoonplaatsId": {
      "type": [
        "string",
        "null"
      ],
      "title": "Adresseerbaar object ligt in woonplaats",
      "description": "De woonplaats (landelijke identificatie) waarin de nummeraanduiding ligt",
      "readOnly": true,
      "deprecated": true
    },
    "beginGeldigheid": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "title": "Nummeraanduiding geldigheid begindatum",
      "description": "De ingangsdatum van de geldigheid van een bepaalde combinatie van gegevens over een NUMMERAANDUIDING"
    },
    "eindGeldigheid": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "title": "Nummeraanduiding geldigheid einddatum",
      "description": "De einddatum van de geldigheid van een bepaalde combinatie van gegevens over een NUMMERAANDUIDING"
    },
    "ligtAanOpenbareruimteId": {
      "type": [
        "string",
        "null"
      ],
      "title": "Adresseerbaar object ligt aan openbare ruimte",
      "description": "De openbare ruimte (landelijke identificatie) waaraan het betreffende adresseerbare object ligt",
      "readOnly": true,
      "deprecated": true
    },
    "typeAdresseerbaarObjectCode": {
      "type": [
        "integer",
        "null"
      ],
      "maximum": 9223372036854775807,
      "minimum": -9223372036854775808,
      "format": "int64",
      "title": "Nummeraanduiding adresseerbaar object type code",
      "description": "Het type adresseerbaar object waaraan een nummeraanduiding is toegekend. code"
    },
    "typeAdresseerbaarObjectOmschrijving": {
      "type": [
        "string",
        "null"
      ],
      "title": "Nummeraanduiding adresseerbaar object type omschrijving",
      "description": "Het type adresseerbaar object waaraan een nummeraanduiding is toegekend. Omschrijving"
    },
    "documentdatum": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "title": "Brondocument datum",
      "description": "De datum waarop het brondocument is vastgesteld"
    },
    "documentnummer": {
      "type": [
        "string",
        "null"
      ],
      "title": "Brondocument nummer",
      "description": "Het unieke nummer van het brondocument"
    },
    "statusCode": {
      "type": [
        "integer",
        "null"
      ],
      "maximum": 9223372036854775807,
      "minimum": -9223372036854775808,
      "format": "int64",
      "title": "Nummeraanduiding status code",
      "description": "De levenscyclus van een NUMMERAANDUIDING waarin de betreffende ligplaats zich bevindt. Code"
    },
    "statusOmschrijving": {
      "type": [
        "string",
        "null"
      ],
      "title": "Nummeraanduiding status omschrijving",
      "description": "De levenscyclus van een NUMMERAANDUIDING waarin de betreffende ligplaats zich bevindt. Omschrijving)"
    },
    "typeAdres": {
      "type": [
        "string",
        "null"
      ],
      "title": "Adres type",
      "description": "Hiermee wordt aangegeven of het een relatie betreft vanuit een hoofdadres. Anders is er sprake van een nevenadres (Hoofdadres, Nevenadres)"
    },
    "adresseertVerblijfsobjectId": {
      "type": [
        "string",
        "null"
      ],
      "title": "Nummeraanduiding adresseert verblijfsobject",
      "description": "Het verblijfsobject (landelijke identificatie) dat door de nummeraanduiding wordt aangeduid",
      "readOnly": true,
      "deprecated": true
    },
    "adresseertLigplaatsId": {
      "type": [
        "string",
        "null"
      ],
      "title": "Nummeraanduiding adresseert ligplaats",
      "description": "De ligplaats (landelijke identificatie) die door de nummeraanduiding wordt aangeduid",
      "readOnly": true,
      "deprecated": true
    },
    "adresseertStandplaatsId": {
      "type": [
        "string",
        "null"
      ],
      "title": "Nummeraanduiding adresseert standplaats",
      "description": "De standplaats (landelijke identificatie) die door de nummeraanduiding wordt aangeduid",
      "readOnly": true,
      "deprecated": true
    },
    "heeftDossierId": {
      "type": [
        "string",
        "null"
      ],
      "title": "Nummeraanduiding heeft dossier",
      "description": "De brondocument(en) op basis waarvan de nummeraanduiding is toegevoegd aan de registratie. Afgeleid van hetlandelijke BAG-kenmerk 'Documentnummer'",
      "readOnly": true,
      "deprecated": true
    },
    "bagprocesCode": {
      "type": [
        "integer",
        "null"
      ],
      "maximum": 9223372036854775807,
      "minimum": -9223372036854775808,
      "format": "int64",
      "title": "BAG proces code",
      "description": "Functionele handeling die ten grondslag ligt aan de gebeurtenis. code"
    },
    "bagprocesOmschrijving": {
      "type": [
        "string",
        "null"
      ],
      "title": "BAG proces omschrijving",
      "description": "Functionele handeling die ten grondslag ligt aan de gebeurtenis. omschrijving"
    },
    "datumActueelTot": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "title": "Actueel tot datum",
      "description": "Einddatum van de cyclus, eventueel in combinatie met het kenmerk Status"
    }
  },
  "required": [
    "_links",
    "adresseertLigplaatsId",
    "adresseertStandplaatsId",
    "adresseertVerblijfsobjectId",
    "heeftDossierId",
    "identificatie",
    "ligtAanOpenbareruimteId",
    "ligtInWoonplaatsId",
    "volgnummer"
  ],
  "$defs": {
    "BagLigplaatsenLink": {
      "type": "object",
      "description": "The identifier of the relationship to ligplaatsen.",
      "properties": {
        "href": {
          "type": "string",
          "format": "uri",
          "readOnly": true
        },
        "title": {
          "type": "string"
        },
        "identificatie": {
          "type": "string",
          "title": "Ligplaats ID",
          "description": "Unieke identificatie van een ligplaats"
        },
        "volgnummer": {
          "type": "integer",
          "maximum": 9223372036854775807,
          "minimum": -9223372036854775808,
          "format": "int64",
          "title": "Object volgnummer",
          "description": "Uniek volgnummer van de toestand van het object"
        }
      },
      "required": [
        "href",
        "identificatie",
        "title",
        "volgnummer"
      ]
    },
    "BagNummeraanduidingenLink": {
      "type": "object",
      "description": "The identifier of the relationship to nummeraanduidingen.",
      "properties": {
        "href": {
          "type": "string",
          "format": "uri",
          "readOnly": true
        },
        "title": {
          "type": "string"
        },
        "identificatie": {
          "type": "string",
          "title": "Nummeraanduiding ID",
          "description": "De unieke aanduiding van een nummeraanduiding"
        },
        "volgnummer": {
          "type": "integer",
          "maximum": 9223372036854775807,
          "minimum": -9223372036854775808,
          "format": "int64",
          "title": "Object volgnummer",
          "description": "Uniek volgnummer van de toestand van het object"
        }
      },
      "required": [
        "href",
        "identificatie",
        "title",
        "volgnummer"
      ]
    },
    "BagOpenbareruimtesLink": {
      "type": "object",
      "description": "The identifier of the relationship to openbareruimtes.",
      "properties": {
        "href": {
          "type": "string",
          "format": "uri",
          "readOnly": true
        },
        "title": {
          "type": "string"
        },
        "identificatie": {
          "type": "string",
          "title": "Openbare ruimte ID",
          "description": "Unieke identificatie van een openbare ruimte"
        },
        "volgnummer": {
          "type": "integer",
          "maximum": 9223372036854775807,
          "minimum": -9223372036854775808,
          "format": "int64",
          "title": "Object volgnummer",
          "description": "Uniek volgnummer van de toestand van het object"
        }
      },
      "required": [
        "href",
        "identificatie",
        "title",
        "volgnummer"
      ]
    },
    "BagStandplaatsenLink": {
      "type": "object",
      "description": "The identifier of the relationship to standplaatsen.",
      "properties": {
        "href": {
          "type": "string",
          "format": "uri",
          "readOnly": true
        },
        "title": {
          "type": "string"
        },
        "identificatie": {
          "type": "string",
          "title": "Standplaats ID",
          "description": "Unieke identificatie van een standplaats"
        },
        "volgnummer": {
          "type": "integer",
          "maximum": 9223372036854775807,
          "minimum": -9223372036854775808,
          "format": "int64",
          "title": "Object volgnummer",
          "description": "Uniek volgnummer van de toestand van het object"
        }
      },
      "required": [
        "href",
        "identificatie",
        "title",
        "volgnummer"
      ]
    },
    "BagVerblijfsobjectenLink": {
      "type": "object",
      "description": "The identifier of the relationship to verblijfsobjecten.",
      "properties": {
        "href": {
          "type": "string",
          "format": "uri",
          "readOnly": true
        },
        "title": {
          "type": "string"
        },
        "identificatie": {
          "type": "string",
          "title": "Object ID",
          "description": "De unieke aanduiding van een verblijfsobject"
        },
        "volgnummer": {
          "type": "integer",
          "maximum": 9223372036854775807,
          "minimum": -9223372036854775808,
          "format": "int64",
          "title": "Object volgnummer",
          "description": "Uniek volgnummer van de toestand van het object"
        }
      },
      "required": [
        "href",
        "identificatie",
        "title",
        "volgnummer"
      ]
    },
    "BagWoonplaatsenLink": {
      "type": "object",
      "description": "The identifier of the relationship to woonplaatsen.",
      "properties": {
        "href": {
          "type": "string",
          "format": "uri",
          "readOnly": true
        },
        "title": {
          "type": "string"
        },
        "identificatie": {
          "type": "string",
          "title": "Woonplaats ID",
          "description": "Unieke aanduiding van een woonplaats"
        },
        "volgnummer": {
          "type": "integer",
          "maximum": 9223372036854775807,
          "minimum": -9223372036854775808,
          "format": "int64",
          "title": "Object volgnummer",
          "description": "Uniek volgnummer van de toestand van het object"
        }
      },
      "required": [
        "href",
        "identificatie",
        "title",
        "volgnummer"
      ]
    },
    "BagdefaultNummeraanduidingenLinks": {
      "type": "object",
      "description": "The contents of the `nummeraanduidingen._links` field. It contains all relationships with objects.",
      "properties": {
        "schema": {
          "type": "string",
          "format": "uri",
          "description": "The schema field is exposed with every record",
          "readOnly": true
        },
        "self": {
          "$ref": "#/$defs/BagNummeraanduidingenLink"
        },
        "ligtInWoonplaats": {
          "$ref": "#/$defs/BagWoonplaatsenLink"
        },
        "ligtAanOpenbareruimte": {
          "$ref": "#/$defs/BagOpenbareruimtesLink"
        },
        "adresseertVerblijfsobject": {
          "$ref": "#/$defs/BagVerblijfsobjectenLink"
        },
        "adresseertLigplaats": {
          "$ref": "#/$defs/BagLigplaatsenLink"
        },
        "adresseertStandplaats": {
          "$ref": "#/$defs/BagStandplaatsenLink"
        },
        "heeftDossier": {
          "$ref": "#/$defs/BagdossiersLink"
        },
        "heeftOnderzoeken": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/BagnummeraanduidingenHeeftOnderzoeken_M2M"
          }
        }
      },
      "required": [
        "adresseertLigplaats",
        "adresseertStandplaats",
        "adresseertVerblijfsobject",
        "heeftDossier",
        "heeftOnderzoeken",
        "ligtAanOpenbareruimte",
        "ligtInWoonplaats",
        "schema",
        "self"
      ]
    },
    "BagdossiersLink": {
      "type": "object",
      "description": "The identifier of the relationship to dossiers.",
      "properties": {
        "href": {
          "type": "string",
          "format": "uri",
          "readOnly": true
        },
        "title": {
          "type": "string"
        },
        "dossier": {
          "type": "string",
          "title": "Dossier ID",
          "description": "Verwijzing vanuit de overige objectklassen"
        }
      },
      "required": [
        "dossier",
        "href",
        "title"
      ]
    },
    "BagnummeraanduidingenHeeftOnderzoeken_M2M": {
      "type": "object",
      "description": "The M2M table for `Nummeraanduidingen.heeftOnderzoeken` that links to `Onderzoeken`",
      "properties": {
        "href": {
          "type": "string",
          "format": "uri",
          "readOnly": true
        },
        "title": {
          "type": "string",
          "readOnly": true
        },
        "identificatie": {
          "type": [
            "string",
            "null"
          ]
        },
        "volgnummer": {
          "type": [
            "integer",
            "null"
          ],
          "maximum": 9223372036854775807,
          "minimum": -9223372036854775808,
          "format": "int64"
        },
        "beginGeldigheid": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "eindGeldigheid": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        }
      },
      "required": [
        "href",
        "title"
      ]
    }
  }
}