Valider chaque champ d'une adresse belge

Sachez quel champ est faux, et pas seulement que l'adresse l'est : chaque champ revient valide ou non, avec son orthographe officielle.

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

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

Quand l'utiliser

Un formulaire qui signale le champ fautif au lieu de refuser toute l'adresse.
Un couple code postal et commune à faire concorder avant de taper la suite.
Corriger une colonne d'un fichier sans toucher aux autres.

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/components" \
  -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

{
  "all_valid": true,
  "warnings":  [],
  "fields": {
    "postcode":     { "valid": true, "canonical": "1000" },
    "street_fr":    { "valid": true, "canonical": "Rue de la Loi" },
    "house_number": { "valid": true, "canonical": "16" },
    "box_number":   { "valid": null }
  }
}

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 d'adresse

Cette adresse existe-t-elle ? Oui ou non, un score de confiance et la version 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 d'adresse

Géocodage inverse

Testez-le sur vos propres clients