GET /addresses
Search for UK addresses by text query or return the nearest address to a given coordinate.
Base URL: https://api.geocerta.io
Sandbox URL: https://api-staging.geocerta.io
Authentication required. Include your API key in the
api-keyheader. See Authentication.
Endpoint
GET /addressesQuery Parameters
| Field | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Address text to search for. Min 3, max 200 characters. Alternatively, pass an Easting/Northing coordinate pair (e.g. 530000 180000 or 530000,180000) to find the nearest address to that point. |
Response
200 OK — returns an array of matching address results.
Response Fields
| Field | Type | Description |
|---|---|---|
address | string | Full address string. |
uprn | string | undefined | Unique Property Reference Number, if available. |
x | number | Easting (British National Grid). |
y | number | Northing (British National Grid). |
lat | number | Latitude (WGS84). |
lng | number | Longitude (WGS84). |
postcode | string | undefined | Postcode, if available. |
Returns an empty array [] when no results are found.
Errors
| Status | Message | Cause |
|---|---|---|
400 | Bad Request | address is missing, under 3, or over 200 characters |
401 | Unauthorized | Missing or invalid API key |
Example
curl "https://api.geocerta.io/addresses?address=10+Downing+Street+London" \
-H "api-key: YOUR_API_KEY"Coordinate lookup:
curl "https://api.geocerta.io/addresses?address=530000,180000" \
-H "api-key: YOUR_API_KEY"