POST /datasets/sites

Returns one NGD site that intersects a given site geometry, or null when nothing intersects.

Base URL: https://api.geocerta.io

Sandbox URL: https://api-staging.geocerta.io

Authentication required. Include your API key in the api-key header. See Authentication.

Endpoint

POST /datasets/sites

Content-Type: application/json

Request Body

Field	Type	Required	Description
`wkt`	string	Yes	The site geometry as a WKT string in British National Grid (EPSG:27700), with coordinates as `easting northing`. Prefer `POINT` to avoid intersecting neighbouring property boundaries; `POLYGON` is also accepted.

Getting property boundaries from address lookup

You can get the property boundary for a single result from GET /addresses or GET /addresses/paf by sending wkt: POINT(result.x result.y).

For example, given:

call /datasets/sites with:

Response

200 OK — returns a single matching NGD site, or null when no site intersects.

Returns null when no site intersects

Response Fields

Field	Type	Description
`id`	string	Stable identifier for the site.
`type`	string	Classification of the site (e.g. `Private Residence`).
`wkt`	string	Site geometry as WKT in British National Grid (EPSG:27700), `easting northing`.
`geometry`	GeoJSON `Polygon \| MultiPolygon`	Site geometry as GeoJSON in WGS84 (EPSG:4326), `[longitude, latitude]`.

If multiple sites intersect, only one is returned. To narrow the result to a specific property, prefer a POINT input over a POLYGON.

Errors

Status	Message	Cause
`400`	Bad Request	Body is missing or has an empty `wkt`.
`401`	Unauthorized	Missing or invalid API key.

Example

curl -X POST https://api.geocerta.io/datasets/sites \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_API_KEY" \
  -d '{
    "wkt": "POLYGON((529968 179968, 530033 179968, 530033 180033, 529968 180033, 529968 179968))"
  }'