API om Belgische adressen automatisch aan te vullen

Stuur wat de gebruiker tot nu toe typte en ontvang de overeenkomende officiële adressen, in beide talen, met coördinaten en de bedrijven die er gevestigd zijn.

Endpoint
GET https://addrly.be/api/v1/autocomplete

Gratis API-sleutel aanvragen Volledige referentie en antwoordvelden

Wanneer gebruiken

Een adresveld in een bestel-, inschrijvings- of leveringsformulier.
Een zoekveld dat een straat, een postcode of een gemeente aanvaardt.
Een formulier dat het adres opgesplitst moet bewaren in straat, nummer, bus en postcode.

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

Queryparameters

Parameter	Type	Beschrijving
`q` verplicht	`string`	De tekst die tot nu toe getypt is: een straat, een nummer, een postcode of een gemeente, in het Nederlands of het Frans.
`limit` optioneel	`integer`	Hoeveel suggesties terugkomen. Van 1 tot 50 Standaard: 10
`type` optioneel	`address \| company`	address geeft alleen adressen, company alleen bedrijven. Zonder deze parameter beide.
`include_archived` optioneel	`boolean`	Geeft ook bedrijven terug die uit de KBO geschrapt zijn. Heeft geen effect op adressen. Standaard: false

Aanvraag

curl "https://addrly.be/api/v1/autocomplete?q=rue+de+la+loi+16&type=address&limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

Antwoord

{
  "results": [
    {
      "result_type":     "address",
      "label":           "Rue de la Loi 16, 1000 Bruxelles",
      "street_fr":       "Rue de la Loi",
      "street_nl":       "Wetstraat",
      "house_number":    "16",
      "box_number":      null,
      "postcode":        "1000",
      "municipality_fr": "Bruxelles",
      "municipality_nl": "Brussel",
      "region":          "Bruxelles-Capitale",
      "lat":             50.8467,
      "lon":             4.3499
    }
  ],
  "count": 1
}