Postcode API

Address details for Belgium

This page describes only country specific information for the address details response. See get address details documentation for an overview of the address details request and response in general.

Belgium has three official languages: french, german and dutch.

In Belgium an address has no house number addition but can have a "bis number" and/or a "box number".

Belgian address "details" property example

{
    "language": "fr-BE",
    "address": {
        "country": "Belgium",
        "locality": "Bruxelles",
        "street": "Grand-Place",
        "postcode": "1000",
        "building": "2 bte 3",
        "buildingNumber": 2,
        "buildingNumberAddition": "bte 3"
    },
    "mailLines": [
        "Grand-Place 2 bte 3",
        "1000 Bruxelles"
    ],
    "location": null,
    "country": {
        "name": "Belgium",
        "iso3Code": "BEL"
    },
    "details": {
        "belRegion": {
            "nisCode": 4000,
            "primaryName": "Bruxelles",
            "nlName": "Brussel",
            "frName": "Bruxelles",
            "deName": "Brüssel"
        },
        "belProvince": null,
        "belDistrict": {
            "nisCode": 21000,
            "primaryName": "Bruxelles-Capitale",
            "nlName": "Brussel-Hoofdstad",
            "frName": "Bruxelles-Capitale",
            "deName": "Brüssel-Hauptstadt"
        },
        "belMunicipality": {
            "nisCode": 21004,
            "primaryName": "Bruxelles",
            "nlName": "Brussel",
            "frName": "Bruxelles",
            "deName": "Brüssel",
            "officialLanguages": [
                "nl",
                "fr"
            ]
        },
        "belStreet": {
            "primaryName": "Grand-Place",
            "nlName": "Grote Markt",
            "frName": "Grand-Place",
            "deName": null
        },
        "belBuilding": {
            "number": 2,
            "bisNumber": null,
            "boxNumber": "3",
            "validated": true
        }
    }
}

Response property "details" for country code "BEL"

belRegion: struct

Belgian region details.

Hide child parameters
nisCode: int

The NIS code for the administrative region.

primaryName: string

The name in address language.

nlName: string

The dutch language name.

frName: string

The french language name

deName: string

The german language name.

belProvince: struct or null

Belgian province details, if available.

Hide child parameters
nisCode: int

The NIS code for the administrative region.

primaryName: string

The name in address language.

nlName: string

The dutch language name.

frName: string

The french language name

deName: string

The german language name.

belDistrict: struct

Belgian administrative district details.

Hide child parameters
nisCode: int

The NIS code for the administrative region.

primaryName: string

The name in address language.

nlName: string

The dutch language name.

frName: string

The french language name

deName: string

The german language name.

belMunicipality: struct

Belgian municipality details.

Hide child parameters
nisCode: int

The NIS code for the administrative region.

primaryName: string

The name in address language.

nlName: string

The dutch language name.

frName: string

The french language name

deName: string

The german language name.

officialLanguages: string[]

The official languages used in the municipality.

belStreet: struct

Belgian street details.

Hide child parameters
primaryName: string

The name for the street in address language.

nlName: string or null

The dutch language name for the street. If available, null otherwise.

frName: string or null

The french language name for the street. If available, null otherwise.

deName: string or null

The german language name for the street. If available, null otherwise.

belBuilding: struct

Belgian building details.

Hide child parameters
number: int

The number for the building.

bisNumber: string or null

The bis number for the building if available, null otherwise.

boxNumber: string or null

The box number for the building if available, null otherwise.

validated: boolean

Indication whether the building could be validated. When true it means the house number, bisNumber and boxNumber combination exists.