Skip to main content
POST
/
lookup
/
postcode
/lookup/postcode
curl --request POST \
  --url https://api.geocoders.io/lookup/postcode \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "postcode": "3014AJ",
  "number": "1"
}
'
{
  "suburb_id": "d24c1500-3e37-461e-98f6-ef54713928e4",
  "building_id": "2bc27c19-bc93-4526-b096-c2a8203c1386",
  "number": "1",
  "suffix": "A",
  "streetname": "West-Kruiskade",
  "postcode": "3014AJ",
  "city": "Rotterdam",
  "longitude": 4.470474881149264,
  "latitude": 51.92091314785285
}

Documentation Index

Fetch the complete documentation index at: https://docs.geocoders.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Api-Key
string
header
required

Body

application/json

Postcode to convert to address

​
postcode
string
required
​
number
string
required

Response

200 - application/json

Lookup Postcode response

​
suburb_id
string<uuid>
​
building_id
string<uuid> | null
​
number
string | null
​
suffix
string | null
​
streetname
string
​
postcode
string | null
​
city
string | null
​
latitude
number<float>
​
longitude
number<float>