Postcode API

Address lookup by BAG number designation ID

Get the unique Dutch address connected to a BAG Number Designation ID ("Nummeraanduiding").

URL template

The REST API requires GET requests. Parameters are added to the REST resource URL, and each parameter must be URL-encoded:

https://api.postcode.eu/nl/v1/addresses/bag/number-designation/{bagNumberDesignationId}

Example REST request

Retrieving /nl/v1/addresses/bag/number-designation/0392200000029398 with the proper authentication would use the following HTTP Request:

GET /nl/v1/addresses/bag/number-designation/0392200000029398 HTTP/1.1
Host: api.postcode.eu
Authorization: Basic 2eTpkU******…

Example response

The lookup is successful so we receive a 200 OK status in the headers:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

And a JSON response in the body:

{
	"street": "Julianastraat",
	"streetNen": "Julianastraat",
	"houseNumber": 30,
	"houseNumberAddition": "",
	"postcode": "2012ES",
	"city": "Haarlem",
	"cityShort": "Haarlem",
	"municipality": "Haarlem",
	"municipalityShort": "Haarlem",
	"province": "Noord-Holland",
	"rdX": 103242,
	"rdY": 487716,
	"latitude": 52.37487801,
	"longitude": 4.62714526,
	"bagNumberDesignationId": "0392200000029398",
	"bagAddressableObjectId": "0392010000029398",
	"addressType": "building",
	"purposes": [
		"office"
	],
	"surfaceArea": 643,
	"houseNumberAdditions": [
		""
	]
}

Parameters

bagNumberDesignationId: string

BAG Number Designation ID ("Nummeraanduiding") to search for.

Returns

street: string

Street name in accordance with the BAG Registry (Dutch: BAG - Basisregistratie Adressen en Gebouwen). In capital and lowercase letters, including punctuation marks and accents. This field is at most 80 characters in length. Filled with "Postbus" in case it is a range of PO boxes.

streetNen: string

Street name in NEN-5825 notation, which has a lower maximum length. In capital and lowercase letters, including punctuation marks and accents. This field is at most 24 characters in length. Filled with "Postbus" in case it is a range of PO boxes.

houseNumber: int

House number of a perceel. In case of a Postbus match the house number will always be 0. Range: 0-99999

houseNumberAddition: string or null

Addition of the house number to uniquely define a location. These additions are officially recognized by the municipality. This field is at most 6 characters in length and null if addition not found (see houseNumberAdditions result field).

postcode: string

Four digit neighborhood code (first part of a postcode). Range: 1000-9999 plus two character letter combination (second part of a postcode). Range: "AA"-"ZZ"

city: string

Official city name in accordance with the BAG Registry (Dutch: BAG - Basisregistratie Adressen en Gebouwen). In capital and lowercase letters, including punctuation marks and accents. This field is at most 80 characters in length.

cityShort: string

City name, shortened to fit a lower maximum length. In capital and lowercase letters, including punctuation marks and accents. This field is at most 24 characters in length.

municipality: string

Municipality name in accordance with the BAG Registry (Dutch: BAG - Basisregistratie Adressen en Gebouwen). In capital and lowercase letters, including punctuation marks and accents. This field is at most 80 characters in length. Examples: "Baarle-Nassau", "'s-Gravenhage", "Haarlemmerliede en Spaarnwoude".

municipalityShort: string

Municipality name, shortened to fit a lower maximum length. In capital and lowercase letters, including punctuation marks and accents. This field is at most 24 characters in length. Examples: "Baarle-Nassau", "'s-Gravenhage", "Haarlemmerliede c.a.".

province: string

Official name of the province, correctly cased and with dashes where applicable.

rdX: int or null

X coordinate according to Dutch Coordinate system "(EPSG) 28992 Amersfoort / RD New" (Dutch: Rijksdriehoeksmeting). Values range from 0 to 300000 meters. Null for PO Boxes.

rdY: int or null

Y coordinate according to Dutch Coordinate system "(EPSG) 28992 Amersfoort / RD New" (Dutch: Rijksdriehoeksmeting). Values range from 300000 to 620000 meters. Null for PO Boxes.

latitude: double or null

Latitude of address. Null for PO Boxes.

longitude: double or null

Longitude of address. Null for PO Boxes.

bagNumberDesignationId: string or null

Unique identifier for address designation. (Dutch: nummeraanduiding id)

bagAddressableObjectId: string or null

Unique identifier for addressable object designation (Dutch: adresseerbaar object id). If null no active object is currently registered.

addressType: string

Type of this address. See reference for possible values.

purposes: string[] or null

List of all purposes (Dutch: gebruiksdoelen). Null or an array of text values. See reference for possible values.

surfaceArea: int or null

Surface in square meters. Null for PO Boxes.

houseNumberAdditions: string[]

List of all house number additions having the postcode and houseNumber which was input.

References