BAG API

get

Returns data from the Basic Registration of Addresses and Buildings (BAG) after entering the postal code and house number.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

postalCodestringRequired

Postal code

Example: 1251NJ

houseNumberintegerRequired

House number

Example: 22

houseLetterstringOptional

House letter

houseNumberExtstringOptional

House number extension

Responses

200

BagDataResponse

application/json

idstring · nullableOptionalExample: string

statusstringRequiredExample: success

400

HTTP 400

application/json

401

HTTP 401

application/json

403

HTTP 403

application/json

404

HTTP 404

application/json

500

HTTP 500

application/json

get/bag-data

GET /v1/bag-data?postalCode=1251NJ&houseNumber=22 HTTP/1.1
Host: api.matrixian.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "string",
  "params": {
    "postalCode": "1251NJ",
    "houseNumber": 22,
    "houseLetter": null,
    "houseNumberExt": null
  },
  "data": {
    "building": {
      "beginDate": "2018-12-06T00:00:00+00:00",
      "buildYear": 1955,
      "documentDate": "2018-12-06T00:00:00+00:00",
      "documentNumber": "2018-0887",
      "id": "0417100000005928",
      "mutationDate": null,
      "noted": false,
      "status": "Pand in gebruik"
    },
    "numberDesignation": {
      "beginDate": "1954-12-24T00:00:00+00:00",
      "documentDate": "1954-12-24T00:00:00+00:00",
      "documentNumber": "L3286",
      "houseLetter": null,
      "houseNumber": 22,
      "houseNumberExtension": null,
      "id": "0417200000001419",
      "mutationDate": null,
      "noted": false,
      "objectType": "Verblijfsobject",
      "postcode": "1251NJ",
      "relatedPublicSpace": "0417300000000061",
      "status": "Naamgeving uitgegeven"
    },
    "object": {
      "beginDate": "2018-12-06T00:00:00+00:00",
      "documentDate": "2018-12-06T00:00:00+00:00",
      "documentNumber": "2018-0887",
      "id": "0417010001001419",
      "location": {
        "x": 144882.297,
        "y": 473885.719
      },
      "mutationDate": null,
      "noted": false,
      "relatedBuilding": "0417100000005928",
      "relatedMainAddress": "0417200000001419",
      "status": "Verblijfsobject in gebruik",
      "usePurpose": "woonfunctie",
      "useSurface": 131
    },
    "place": {
      "beginDate": "2009-03-25T00:00:00+00:00",
      "documentDate": "2009-03-25T00:00:00+00:00",
      "documentNumber": "200911",
      "id": "2890",
      "mutationDate": null,
      "name": "Laren",
      "noted": false,
      "status": "Woonplaats aangewezen"
    },
    "publicSpace": {
      "beginDate": "2010-09-28T00:00:00+00:00",
      "documentDate": "2010-09-28T00:00:00+00:00",
      "documentNumber": "-2.07.155.2",
      "id": "0417300000000061",
      "mutationDate": null,
      "name": "Graafland",
      "noted": false,
      "relatedPlace": "2890",
      "status": "Naamgeving uitgegeven"
    },
    "sourceHolder": {
      "id": "0417",
      "name": "Laren (NH.)"
    }
  },
  "error": {},
  "meta": {},
  "status": "success"
}