Skip to main content

​
Overview

For the Netherlands, Streetline returns addresses using Dutch-specific address components derived from BAG (Basisregistratie Adressen en Gebouwen). All Dutch addresses use the same response schema as other countries. Country-specific semantics are expressed through component types prefixed with NLD_.

​
Address components

Dutch addresses are represented as a list of typed components. Each component describes the semantic role of a value within the address. The following component types may appear for country=NLD:
Component typeRequiredDescriptionFormat
NLD_PUBLIC_SPACEYesStreet or public space name^\S{1,80}$
NLD_HOUSE_NUMBERYesHouse number^[1-9][0-9]{0,4}$
NLD_HOUSE_LETTERNoHouse letter (e.g. A)^[A-Za-z]$
NLD_HOUSE_NUMBER_ADDITIONNoHouse number addition (e.g. 1, II, -ZW)^[0-9A-Za-z]{1,4}$
NLD_POSTAL_CODEYesDutch postal code^[1-9][0-9]{3}[A-Z]{2}$
NLD_LOCALITYYesCity or village name^\S{1,80}$
NLD_MUNICIPALITYYesMunicipality^\S{1,80}$
NLD_PROVINCEYesProvince^\S{1,80}$
NLD_COUNTRYYesCountry name (Nederland)^[A-Za-z]{9}$
If a component is marked as Required, it will always be present in the response. Optional components may be omitted entirely when not applicable. Clients should treat the component list as order-independent and rely on the type field when extracting values.

​
Example response

{
  "hits": [
    {
      "components": [
        {
          "type": "NLD_PUBLIC_SPACE",
          "value": "Hoofdstraat"
        },
        {
          "type": "NLD_HOUSE_NUMBER",
          "value": 2
        },
        {
          "type": "NLD_HOUSE_LETTER",
          "value": "A"
        },
        {
          "type": "NLD_POSTAL_CODE",
          "value": "7311 KA"
        },
        {
          "type": "NLD_LOCALITY",
          "value": "Apeldoorn"
        },
        {
          "type": "NLD_MUNICIPALITY",
          "value": "Apeldoorn"
        },
        {
          "type": "NLD_PROVINCE",
          "value": "Gelderland"
        },
        {
          "type": "NLD_COUNTRY",
          "value": "Nederland"
        }
      ],
      "country": "NLD",
      "lines": [
        "Hoofdstraat 2A",
        "7311 KA Apeldoorn",
        "Nederland"
      ],
      "location": {
        "latitude": 52.209884,
        "longitude": 5.967036
      }
    },
    {
      "components": [
        {
          "type": "NLD_PUBLIC_SPACE",
          "value": "Hoofdstraat"
        },
        {
          "type": "NLD_HOUSE_NUMBER",
          "value": 7
        },
        {
          "type": "NLD_POSTAL_CODE",
          "value": "5706 AJ"
        },
        {
          "type": "NLD_LOCALITY",
          "value": "Helmond"
        },
        {
          "type": "NLD_MUNICIPALITY",
          "value": "Helmond"
        },
        {
          "type": "NLD_PROVINCE",
          "value": "Noord-Brabant"
        },
        {
          "type": "NLD_COUNTRY",
          "value": "Nederland"
        }
      ],
      "country": "NLD",
      "lines": [
        "Hoofdstraat 7",
        "5706 AJ Helmond",
        "Nederland"
      ],
      "location": {
        "latitude": 51.460438,
        "longitude": 5.631037
      }
    },
    {
      "components": [
        {
          "type": "NLD_PUBLIC_SPACE",
          "value": "Hoofdstraat"
        },
        {
          "type": "NLD_HOUSE_NUMBER",
          "value": 1
        },
        {
          "type": "NLD_POSTAL_CODE",
          "value": "6372 CN"
        },
        {
          "type": "NLD_LOCALITY",
          "value": "Landgraaf"
        },
        {
          "type": "NLD_MUNICIPALITY",
          "value": "Landgraaf"
        },
        {
          "type": "NLD_PROVINCE",
          "value": "Limburg"
        },
        {
          "type": "NLD_COUNTRY",
          "value": "Nederland"
        }
      ],
      "country": "NLD",
      "lines": [
        "Hoofdstraat 1",
        "6372 CN Landgraaf",
        "Nederland"
      ],
      "location": {
        "latitude": 50.895412,
        "longitude": 6.015682
      }
    },
    {
      "components": [
        {
          "type": "NLD_PUBLIC_SPACE",
          "value": "Hoofdstraat"
        },
        {
          "type": "NLD_HOUSE_NUMBER",
          "value": 1
        },
        {
          "type": "NLD_POSTAL_CODE",
          "value": "7811 EA"
        },
        {
          "type": "NLD_LOCALITY",
          "value": "Emmen"
        },
        {
          "type": "NLD_MUNICIPALITY",
          "value": "Emmen"
        },
        {
          "type": "NLD_PROVINCE",
          "value": "Drenthe"
        },
        {
          "type": "NLD_COUNTRY",
          "value": "Nederland"
        }
      ],
      "country": "NLD",
      "lines": [
        "Hoofdstraat 1",
        "7811 EA Emmen",
        "Nederland"
      ],
      "location": {
        "latitude": 52.783572,
        "longitude": 6.89627
      }
    },
    {
      "components": [
        {
          "type": "NLD_PUBLIC_SPACE",
          "value": "Hoofdstraat"
        },
        {
          "type": "NLD_HOUSE_NUMBER",
          "value": 1
        },
        {
          "type": "NLD_POSTAL_CODE",
          "value": "7902 EA"
        },
        {
          "type": "NLD_LOCALITY",
          "value": "Hoogeveen"
        },
        {
          "type": "NLD_MUNICIPALITY",
          "value": "Hoogeveen"
        },
        {
          "type": "NLD_PROVINCE",
          "value": "Drenthe"
        },
        {
          "type": "NLD_COUNTRY",
          "value": "Nederland"
        }
      ],
      "country": "NLD",
      "lines": [
        "Hoofdstraat 1",
        "7902 EA Hoogeveen",
        "Nederland"
      ],
      "location": {
        "latitude": 52.728929,
        "longitude": 6.477778
      }
    }
  ],
  "limit": 5
}

​
Formatting

In addition to structured components, each address includes formatted address lines intended for direct display. Streetline formats Dutch addresses using consistent, human-readable rules:
  • House number and house letter are concatenated (1A, 1a)
  • House number additions are always prefixed with a hyphen (1-1, 1A-101, 1A-ZW)
  • Postal codes are formatted as 1234 AB
  • Casing follows BAG registration data

​
Rendering

The API provides both structured components and preformatted address lines. For most use cases, we recommend rendering addresses using the lines field rather than reconstructing strings manually.

​
Search results (single-line)

For autocomplete dropdowns or search result lists, render a compact single-line address. Recommended format: 
{lines[0]}, {NLD_LOCALITY}
Example:
Hoofdstraat 2A, Apeldoorn
This keeps results short, readable, and easy to scan while still clearly identifying the location.

​
Full address display (multi-line)

When displaying a selected address (for example in a checkout form or confirmation screen), use the provided address lines directly. Recommended format: 
lines[0]
lines[1]
Example:
Hoofdstraat 2A
7311 KA Apeldoorn
In contexts where the country must be shown (for example international shipping or exports), append the country line: 
lines[0]
lines[1]
lines[2]
Example:
Hoofdstraat 2A
7311 KA Apeldoorn
Nederland
Using the preformatted lines ensures addresses follow local conventions and remain consistent with how end users expect to see them.