Validate a complete Belgian address

Send the fields your form already holds and learn whether the address exists, how confident the match is and what the official version of it looks like.

Endpoint
POST https://addrly.be/api/v1/validate/address

Get a free API key Full reference and response fields

When to use it

Checking an address before an order ships or a contract is signed.
Flagging the records of a database that no longer match a real address.
Replacing a typed address with its official spelling and coordinates.

Cost: 1 request per call
Authentication: X-API-Key header
Coverage: Every official address in Belgium

JSON body

Parameter	Type	Description
`street_fr` optional	`string`	The street name in French.
`street_nl` optional	`string`	The street name in Dutch. Send either language, or both.
`house_number` optional	`string`	The house number, with its suffix if any (12A, 12 bis).
`box_number` optional	`string`	The box number, without the bte or bus prefix.
`postcode` optional	`string`	The four-digit Belgian postcode.
`municipality_fr` optional	`string`	The municipality or postal locality in French.
`municipality_nl` optional	`string`	The municipality or postal locality in Dutch.

Request

curl -X POST "https://addrly.be/api/v1/validate/address" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"street_fr": "Rue de la Loi", "house_number": "16", "postcode": "1000"}'

Response

{
  "valid":      true,
  "confidence": 1.0,
  "canonical": {
    "street_fr":       "Rue de la Loi",
    "street_nl":       "Wetstraat",
    "house_number":    "16",
    "postcode":        "1000",
    "municipality_fr": "Bruxelles",
    "municipality_nl": "Brussel",
    "lat":             50.8467,
    "lon":             4.3499
  },
  "suggestions": []
}