Belgian address and company API for your product
Autocomplete and validate addresses on the official BOSA reference, look companies up in the BCE/KBO and return their full dossier, from one REST API with a Python SDK.
Try it live
Search any Belgian address or company below. No account needed.
No results found.
Live demo: results are fetched directly from the API.
A complete, developer-first API
Address Autocomplete
Instant full-text search across millions of Belgian addresses. Street, house number, municipality and postcode.
Company Search
Search Belgian companies by name. Returns enterprise numbers, NACE codes, and VAT status.
Route Calculation
Point-to-point routing for any two coordinates in Belgium. Returns distance in km and travel duration.
Bidirectional Lookup
Search an address, get the companies registered there. Search a company, get its address. Both directions in one call.
Nearest address
Reverse geocoding: return the closest Belgian address for any GPS coordinate, with exact distance in metres.
Address normalisation
Convert a free-text address into the canonical BOSA structure. Perfect for cleaning up forms and legacy databases.
Address validation
Check whether an address exists with a confidence score, or validate each field independently and get canonical values back.
Batch calls
Bundle up to 100 items into a single call to normalize, validate or geocode in bulk, one address credit per item.
Integrate in minutes
A single HTTP call is all it takes. Add your API key to the header and start querying millions of Belgian addresses and companies instantly.
- API key or Bearer JWT authentication
- Mixed address + company results in one call
- Filter by result type: address or company
- Rate-limit headers on every response
curl "https://addrly.be/api/v1/autocomplete/?q=rue+de+la+loi&limit=5" -H "X-API-Key: YOUR_API_KEY" { "results": [ { "result_type": "address", "label": "Rue de la Loi 16, 1000 Bruxelles", "lat": 50.8467, "lon": 4.3499 } ], "count": 1 }
Everything to get started
API documentation
Every endpoint, its parameters, its price in credits and its error codes.
Python SDK
The addrly-api package: typed responses, meters on every call, bulk helpers and a spending cap.
Postman and Bruno collections
Every public endpoint with ready-made tests, to run in the app, on the command line or in CI.
For AI assistants
An llms.txt file that describes the API to your coding assistant.
Frequently asked questions
How is usage counted?
Address calls use address credits and company calls use company credits. Every response carries the remaining allowance in its headers, and a free status call returns both meters.
Can I call the API from the browser?
We recommend server-side calls only, to keep your key secret. For autocomplete in a form, proxy the requests through your own backend.
Is there a free tier?
Yes. The free plan includes 1,000 address requests and 20 company dossiers every month, without a card.
Read next
Credit management
Check a Belgian customer before granting payment terms
Read moreAccountants and fiduciaries
Keep every client file current without checking the registers
Read moreCompliance and legal
Verify a Belgian company and follow what it publishes
Read moreProcurement
Qualify a Belgian supplier and follow it for the whole contract
Read moreTry it on your own customers
The free plan gives you 20 complete company dossiers every month, no card required. Move to a paid plan when you need more, and cancel whenever you like.
A question first? Contact us