Valider une adresse belge complète

Envoyez les champs que votre formulaire contient déjà et apprenez si l'adresse existe, avec quelle confiance, et à quoi ressemble sa version officielle.

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

Obtenir une clé API gratuite Référence complète et champs de réponse

Quand l'utiliser

Vérifier une adresse avant l'envoi d'une commande ou la signature d'un contrat.
Repérer les fiches d'une base qui ne correspondent plus à une adresse réelle.
Remplacer une adresse tapée par son orthographe officielle et ses coordonnées.

Coût: 1 requête par appel
Authentification: En-tête X-API-Key
Couverture: Toutes les adresses officielles de Belgique

Corps JSON

Paramètre	Type	Description
`street_fr` facultatif	`string`	Le nom de la rue en français.
`street_nl` facultatif	`string`	Le nom de la rue en néerlandais. Envoyez l'une des deux langues, ou les deux.
`house_number` facultatif	`string`	Le numéro de maison, avec son suffixe éventuel (12A, 12 bis).
`box_number` facultatif	`string`	Le numéro de boîte, sans le préfixe bte ou bus.
`postcode` facultatif	`string`	Le code postal belge à quatre chiffres.
`municipality_fr` facultatif	`string`	La commune ou la localité postale en français.
`municipality_nl` facultatif	`string`	La commune ou la localité postale en néerlandais.

Requête

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"}'

Réponse

{
  "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": []
}

Les autres endpoints adresse

Autocomplétion

Des suggestions pendant la saisie, dès les premiers caractères d'une rue, d'un numéro ou d'un code postal.

Lire la référence

Normalisation

Une ligne de texte libre en entrée, l'adresse officielle structurée et un score en sortie.

Lire la référence

Validation par champ

Champ par champ : quelle partie de l'adresse est fausse, et son orthographe officielle.

Lire la référence

Géocodage inverse

Des coordonnées GPS en entrée, les adresses officielles les plus proches et leur distance en sortie.

Lire la référence

Retour à la présentation de l'API adresse

Quand l'utiliser

Corps JSON

Les autres endpoints adresse

Autocomplétion

Normalisation

Validation par champ

Géocodage inverse

Testez-le sur vos propres clients