Nederlandse geocoding API — adres naar coördinaten via PDOK Locatieserver. Forward geocoding van straatnaam, postcode of plaatsnaam naar WGS84 lat/lon.

GET /v1/geo/geocode

Converts a Dutch address, postcode, street, or place name into WGS84 coordinates using the PDOK Locatieserver (CC-0 open data, Kadaster).

Request parameters

Parameter	Type	Required	Default	Description
`q`	string	✓	—	Free-text search query, e.g. `Damrak 1 Amsterdam`
`rows`	integer		`5`	Maximum number of results to return (1–10)

Example request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.omnizoek.nl/v1/geo/geocode?q=Damrak+1+Amsterdam"

Example response

{
  "query": "Damrak 1 Amsterdam",
  "results": [
    {
      "display_name": "Damrak 1, Amsterdam",
      "type": "adres",
      "lat": 52.3756,
      "lon": 4.8951,
      "postcode": "1012LG",
      "city": "Amsterdam",
      "municipality": "Amsterdam",
      "province": "Noord-Holland",
      "street": "Damrak",
      "house_number": "1",
      "bag_id": "0363200000397642",
      "score": 18.92
    }
  ]
}

Response fields

Field	Type	Description
`query`	string	The original search query
`results`	array	Ordered list of matching locations, best match first

Result item fields

Field	Type	Description
`display_name`	string	Full formatted address or place name
`type`	string	PDOK result type: `adres`, `postcode`, `woonplaats`, `gemeente`, `weg`, etc.
`lat`	number \| null	Latitude (WGS84)
`lon`	number \| null	Longitude (WGS84)
`postcode`	string \| null	Postcode, e.g. `1012LG`
`city`	string \| null	City / woonplaats
`municipality`	string \| null	Municipality / gemeente
`province`	string \| null	Province / provincie
`street`	string \| null	Street name
`house_number`	string \| null	House number
`bag_id`	string \| null	BAG object ID (nummeraanduidingId or verblijfsobjectId)
`score`	number \| null	PDOK relevance score

Error responses

Status	Cause
`404`	No results found for the given query
`503`	PDOK Locatieserver unavailable

Caching

Results are cached for 24 hours per unique query.

Geocoding (PDOK)