Normalize a Belgian address from free text

Send an address as one line, in any order and with the usual abbreviations, and get the official street, number, box, postcode and municipality back, with a score.

Endpoint
POST https://addrly.be/api/v1/normalize

Get a free API key Full reference and response fields

When to use it

Cleaning an existing customer or supplier file before an import.
Reading addresses from emails, PDFs or a spreadsheet column.
Deciding automatically between accept, review and reject from the score.

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

JSON body

Parameter	Type	Description
`address` required	`string`	The address as one line of free text, in any order, abbreviations included (av., chée, bte, bxl).

Request

curl -X POST "https://addrly.be/api/v1/normalize" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address": "rue de la loi 16, 1000 brux"}'

Response

{
  "input":            "rue de la loi 16, 1000 brux",
  "found":            true,
  "match_similarity": 1.0,
  "match_details": {
    "street_similarity":  1.0,
    "house_number_match": true,
    "postcode_match":     true
  },
  "normalized": {
    "street_fr":       "Rue de la Loi",
    "street_nl":       "Wetstraat",
    "house_number":    "16",
    "box_number":      null,
    "postcode":        "1000",
    "municipality_fr": "Bruxelles",
    "municipality_nl": "Brussel",
    "lat":             50.8467,
    "lon":             4.3499
  }
}