With the Districts & neighborhoods API you can easily find out which district and neighborhood an address is located in within the Netherlands.

Examples of districts:

• Jordaan
• Buikslotermeer
• Grachtengordel-Zuid
• Zuidas

Examples of neighborhoods:

• Langestraat e.o.
• Bezuidenhout-West
• Grachtengordel-West
• Museumkwartier

This information is ideal for applications that require geographic segmentation, analysis or audience-targeted services. It makes it possible to group homes, businesses or other locations at district and neighborhood level.

District and neighborhood: what's the difference?

In the Netherlands a municipality is divided into districts, and each district is in turn divided into neighborhoods. The neighborhood is therefore the most detailed level. This classification comes from the CBS (Centraal Bureau voor de Statistiek). With our API you can request both levels for any address.

How it works

The Districts & neighborhoods API is our standard Postcode API, with two extra attributes: district and neighborhood. By passing these attributes, you get the district and neighborhood name of the given address alongside the regular data such as street, city, municipality and province.

This means you don't have to learn or integrate a separate API - you use the same familiar Postcode API, but simply request attributes[]=district and/or attributes[]=neighborhood.

• Real estate platforms - categorize homes by district or neighborhood to make search results clearer
• Marketing and analysis - segment audiences by district or neighborhood for targeted campaigns
• Municipal planning - analyze district and neighborhood data for policy, reporting or urban development
• Logistics & delivery services - plan more efficient routes by adding district and neighborhood information to addresses

API request

GET https://api.nederlandpostcode.nl/v1/address?postcode=1015CN&number=10&addition=A&attributes[]=district&attributes[]=neighborhood

{
    "data": [
        {
            "postcode": "1015CN",
            "number": 10,
            "addition": "A",
            "street": "Keizersgracht",
            "city": "Amsterdam",
            "municipality": "Amsterdam",
            "province": "Noord-Holland",
            "country": "Nederland",
            "details": {
                "district": {
                    "official": "Grachtengordel-Zuid",
                    "name": "Grachtengordel-Zuid"
                },
                "neighborhood": "Langestraat e.o."
            }
        }
    ]
}

About half of all districts in the Netherlands have the prefix "Wijk" in their official name followed by a number. In the API response, both the official name and the shortened name are available for the district.

"details": {
    "district": {
        "official": "Wijk 26 Bezuidenhout",
        "name": "Bezuidenhout"
    },
    "neighborhood": "Bezuidenhout-West"
}

In addition, you can also request the coordinates of the address by passing attributes[]=coordinates in your API request.

Additional information

• The district attribute gives the district of the address. The official value gives the official district name, the name value gives the shortened district name (without the "Wijk" prefix and number).
• The neighborhood attribute gives the name of the neighborhood the address is located in.
• If an address has no district or neighborhood, the value can be null. This applies to a very limited number of addresses in the Netherlands.
• The Districts & neighborhoods API is available in all subscriptions.

You can find more information about requesting the neighborhood on the Neighborhoods API page, or check the full API documentation.