Bagpanden

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/amsterdam-nl/json-schema/amsterdam-nl-bagpanden-schema.json",
  "title": "Bagpanden",
  "description": "Een PAND is de kleinste bij de totstandkoming functioneel en bouwkundig-constructief zelfstandige eenheid die direct en duurzaam met de aarde is verbonden en betreedbaar en afsluitbaar is.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amsterdam-nl-bag-openapi.yml#/components/schemas/Bagpanden",
  "type": "object",
  "properties": {
    "_links": {
      "allOf": [
        {
          "$ref": "#/$defs/BagdefaultPandenLinks"
        }
      ],
      "title": " links"
    },
    "identificatie": {
      "type": "string",
      "title": "Pand ID",
      "description": "Unieke identificatie van een pand"
    },
    "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 registratiedatum",
      "description": "De datum waarop de toestand van het object is geregistreerd"
    },
    "geconstateerd": {
      "type": [
        "boolean",
        "null"
      ],
      "title": "Pand geconstateerd indicatie",
      "description": "Dit geeft aan dat een PAND in de registratie is opgenomen als gevolg van een feitelijke constatering en niet op basis van een regulier brondocument (J/N)"
    },
    "geometrie": {
      "$ref": "#/$defs/Geometry"
    },
    "oorspronkelijkBouwjaar": {
      "type": [
        "integer",
        "null"
      ],
      "maximum": 9223372036854775807,
      "minimum": -9223372036854775808,
      "format": "int64",
      "title": "Pand oorspronkelijk bouwjaar",
      "description": "De aanduiding van het jaar waarin een pand oorspronkelijk als bouwkundig gereed is of wordt opgeleverd"
    },
    "statusCode": {
      "type": [
        "integer",
        "null"
      ],
      "maximum": 9223372036854775807,
      "minimum": -9223372036854775808,
      "format": "int64",
      "title": "Pand status code",
      "description": "De levenscyclus van een PAND waarin het betreffende pand zich bevindt. Code"
    },
    "statusOmschrijving": {
      "type": [
        "string",
        "null"
      ],
      "title": "Pand status omschrijving",
      "description": "De fase van de levenscyclus van een PAND waarin het betreffende pand zich bevindt. Omschrijving"
    },
    "beginGeldigheid": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "title": "Pand geldigheid begindatum",
      "description": "De ingangsdatum van de geldigheid van een bepaalde combinatie van gegevens over een PAND"
    },
    "eindGeldigheid": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "title": "Pand geldigheid einddatum",
      "description": "De einddatum van de geldigheid van een bepaalde combinatie van gegevens over een PAND"
    },
    "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"
    },
    "naam": {
      "type": [
        "string",
        "null"
      ],
      "title": "Pand naam",
      "description": "Naamgeving van een pand (bv. naam van metrostation of bijzonder gebouw)"
    },
    "liggingCode": {
      "type": [
        "integer",
        "null"
      ],
      "maximum": 9223372036854775807,
      "minimum": -9223372036854775808,
      "format": "int64",
      "title": "Pand ligging code",
      "description": "Dit is een vervallen kenmerk en wordt niet geactualiseerd"
    },
    "liggingOmschrijving": {
      "type": [
        "string",
        "null"
      ],
      "title": "Pand ligging omschrijving",
      "description": "Situering pand met verblijfsobjec. Omschrijving"
    },
    "typeWoonobject": {
      "type": [
        "string",
        "null"
      ],
      "title": "Woonobject type",
      "description": "Eén woning, Meerdere woningen"
    },
    "ligtInBouwblokId": {
      "type": [
        "string",
        "null"
      ],
      "title": "Pand ligt in bouwblok",
      "description": "Het bouwblok waarin het pand ligt",
      "readOnly": true,
      "deprecated": true
    },
    "ligtInBuurtId": {
      "type": [
        "string",
        "null"
      ],
      "title": "Pand ligt in buurt",
      "description": "De buurt waarin het pand ligt",
      "readOnly": true,
      "deprecated": true
    },
    "aantalBouwlagen": {
      "type": [
        "integer",
        "null"
      ],
      "maximum": 9223372036854775807,
      "minimum": -9223372036854775808,
      "format": "int64",
      "title": "Bouwlagen pand aantal",
      "description": "Aantal bouwlagen van een pand"
    },
    "hoogsteBouwlaag": {
      "type": [
        "integer",
        "null"
      ],
      "maximum": 9223372036854775807,
      "minimum": -9223372036854775808,
      "format": "int64",
      "title": "Pand hoogste bouwlaag",
      "description": "Hoogste bouwlaag van een pand"
    },
    "laagsteBouwlaag": {
      "type": [
        "integer",
        "null"
      ],
      "maximum": 9223372036854775807,
      "minimum": -9223372036854775808,
      "format": "int64",
      "title": "Pand laagste bouwlaag",
      "description": "Laagste bouwlaag van een pand"
    },
    "heeftDossierId": {
      "type": [
        "string",
        "null"
      ],
      "title": "Pand heeft dossier",
      "description": "Het dossier op basis waarvan het object is toegevoegd aan de registratie",
      "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",
    "heeftDossierId",
    "identificatie",
    "ligtInBouwblokId",
    "ligtInBuurtId",
    "volgnummer"
  ],
  "$defs": {
    "BagPandenLink": {
      "type": "object",
      "description": "The identifier of the relationship to panden.",
      "properties": {
        "href": {
          "type": "string",
          "format": "uri",
          "readOnly": true
        },
        "title": {
          "type": "string"
        },
        "identificatie": {
          "type": "string",
          "title": "Pand ID",
          "description": "Unieke identificatie van een pand"
        },
        "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"
      ]
    },
    "BagdefaultPandenLinks": {
      "type": "object",
      "description": "The contents of the `panden._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/BagPandenLink"
        },
        "bevatVerblijfsobjecten": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/BagVerblijfsobjectenLink"
          }
        },
        "ligtInBouwblok": {
          "$ref": "#/$defs/GebiedenBouwblokkenLink"
        },
        "ligtInBuurt": {
          "$ref": "#/$defs/GebiedenBuurtenLink"
        },
        "heeftDossier": {
          "$ref": "#/$defs/BagdossiersLink"
        },
        "heeftOnderzoeken": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/BagpandenHeeftOnderzoeken_M2M"
          }
        }
      },
      "required": [
        "bevatVerblijfsobjecten",
        "heeftDossier",
        "heeftOnderzoeken",
        "ligtInBouwblok",
        "ligtInBuurt",
        "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"
      ]
    },
    "BagpandenHeeftOnderzoeken_M2M": {
      "type": "object",
      "description": "The M2M table for `Panden.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"
      ]
    },
    "GebiedenBouwblokkenLink": {
      "type": "object",
      "description": "The identifier of the relationship to bouwblokken.",
      "properties": {
        "href": {
          "type": "string",
          "format": "uri",
          "readOnly": true
        },
        "title": {
          "type": "string"
        },
        "identificatie": {
          "type": "string",
          "title": "Object ID",
          "description": "Uniek identificerend kenmerk voor het object dat onveranderlijk is zolang het object bestaat"
        },
        "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"
      ]
    },
    "GebiedenBuurtenLink": {
      "type": "object",
      "description": "The identifier of the relationship to buurten.",
      "properties": {
        "href": {
          "type": "string",
          "format": "uri",
          "readOnly": true
        },
        "title": {
          "type": "string"
        },
        "identificatie": {
          "type": "string",
          "title": "Object ID",
          "description": "Uniek identificerend kenmerk voor het object dat onveranderlijk is zolang het object bestaat"
        },
        "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"
      ]
    },
    "Geometry": {
      "type": "object",
      "description": "GeoJSON geometry",
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "Point",
            "LineString",
            "Polygon",
            "MultiPoint",
            "MultiLineString",
            "MultiPolygon"
          ],
          "description": "the geometry type"
        },
        "coordinates": {
          "type": "array",
          "minItems": 2,
          "description": "Based on the geometry type, a point or collection of points.",
          "items": {
            "type": "number"
          }
        }
      }
    }
  }
}