API REFERENCE
API Documentation
Core routing and technical specifications for the Adresmurf parsing engine. Authentication via
X-API-Key header is required for all endpoints.
NLP Resolver
Resolves unstructured or malformed Dutch address strings into validated components, absolute coordinates, and BAG registry IDs.
POST
https://api.adresmurf.nl/rawstring
Request Example
curl -X POST "https://api.adresmurf.nl/rawstring" \
-H "Content-Type: application/json" \
-H "X-API-Key: <YOUR_API_KEY>" \
-d '{
"address": "Oosterhamrikk 10521, 9713KC Goneingen"
}'Parameters
| Field | Type | Description |
|---|---|---|
address |
string | The unstructured address text to be parsed. Required. |
Response Example (200 OK)
{
"addr": "Oosterhamrikkade 105-21, 9713KC Groningen",
"pos": "53.22977143 6.57752391",
"city": "Groningen",
"postcode": "9713KC",
"opr_name": "Oosterhamrikkade",
"huisnr": 105,
"huisletter": null,
"huisletter_addition": "21",
"building_id": "0014100022190488",
"num_id": "0014200022201246"
}Structured Lookup
Retrieves exact BAG registry data (street, city, coordinates) using a deterministic structured postcode and house number.
POST
https://api.adresmurf.nl/bag/address/resolve
Request Example
{
"postcode": "1017GX",
"huisnr": 281,
"toevoeging": "A"
}Parameters
| Field | Type | Description |
|---|---|---|
postcode |
string | Standard Dutch Postcode (e.g., "1017GX"). Required. |
huisnr |
integer | Numeric house number. Required. |
toevoeging |
string | House letter or addition (e.g., "A", "bis"). Optional. |
Response Example (200 OK)
{
"found": true,
"data": {
"opr_name": "Keizersgracht",
"wpl_name": "Amsterdam",
"pos": "POINT(121234.123 486123.456)",
"addr": "Keizersgracht 281A, 1017GX Amsterdam"
}
}