Streets and house number ranges lookup by postcode

Get all streets and house number ranges for the provided postcode.

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/postcode-ranges/postcode/{postcode}

Example REST request

Retrieving /nl/v1/postcode-ranges/postcode/2011VM with the proper authentication would use the following HTTP Request:

GET /nl/v1/postcode-ranges/postcode/2011VM 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": "Prins Hendrikstraat",
		"streetNen": "Prins Hendrikstraat",
		"startHouseNumber": "1",
		"endHouseNumber": "3",
		"houseNumberType": "odd",
		"city": "Haarlem",
		"cityShort": "Haarlem",
		"cityId": "2907",
		"municipality": "Haarlem",
		"municipalityShort": "Haarlem",
		"municipalityId": "0392",
		"province": "Noord-Holland"
	},
	{
		"street": "Prins Hendrikstraat",
		"streetNen": "Prins Hendrikstraat",
		"startHouseNumber": "2",
		"endHouseNumber": "2",
		"houseNumberType": "even",
		"city": "Haarlem",
		"cityShort": "Haarlem",
		"cityId": "2907",
		"municipality": "Haarlem",
		"municipalityShort": "Haarlem",
		"municipalityId": "0392",
		"province": "Noord-Holland"
	},
	{
		"street": "Wilhelminastraat",
		"streetNen": "Wilhelminastraat",
		"startHouseNumber": "10",
		"endHouseNumber": "30",
		"houseNumberType": "even",
		"city": "Haarlem",
		"cityShort": "Haarlem",
		"cityId": "2907",
		"municipality": "Haarlem",
		"municipalityShort": "Haarlem",
		"municipalityId": "0392",
		"province": "Noord-Holland"
	}
]

Parameters

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"

Returns

Array of structs

Postcode range data

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.
startHouseNumber: int: First house number or first PO box number of the range.
endHouseNumber: int: Last house number or last PO box number of the range.
houseNumberType: string: The type of house numbers in the range: odd or even
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.
cityId: string: Unique identifier for the city (Dutch: "woonplaatscode") as defined by the BAG Registry (Dutch: BAG - Basisregistratie Adressen en Gebouwen). Range "0000"-"9999"
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.".
municipalityId: string: Unique identifier for the municipality (Dutch: "gemeentecode") as defined by the National Office for Identity Data (Dutch: Rijksdienst voor Indentiteitsgegevens (RvIG)). Range "0000"-"9999"
province: string: Official name of the province, correctly cased and with dashes where applicable.