Elk veld van een Belgisch adres valideren

Weet welk veld fout is, niet alleen dat het adres fout is: elk veld komt terug als geldig of niet, met de officiële schrijfwijze.

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

Gratis API-sleutel aanvragen Volledige referentie en antwoordvelden

Wanneer gebruiken

Een formulier dat het foute veld aanduidt in plaats van het hele adres te weigeren.
Een postcode en gemeente die moeten overeenkomen voor de rest getypt wordt.
Eén kolom van een bestand corrigeren zonder de andere aan te raken.

Kostprijs: 1 aanvraag per oproep
Authenticatie: X-API-Key-header
Dekking: Elk officieel adres in België

JSON-body

Parameter	Type	Beschrijving
`street_fr` optioneel	`string`	De straatnaam in het Frans.
`street_nl` optioneel	`string`	De straatnaam in het Nederlands. Stuur een van beide talen, of beide.
`house_number` optioneel	`string`	Het huisnummer, met eventueel achtervoegsel (12A, 12 bis).
`box_number` optioneel	`string`	Het busnummer, zonder het voorvoegsel bus of bte.
`postcode` optioneel	`string`	De Belgische postcode van vier cijfers.
`municipality_fr` optioneel	`string`	De gemeente of postale woonplaats in het Frans.
`municipality_nl` optioneel	`string`	De gemeente of postale woonplaats in het Nederlands.

Aanvraag

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

Antwoord

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