POST /datasets/local-authorities

Returns the local authority area(s) that intersect a given site geometry.

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/local-authorities

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`. Typically a `POLYGON` but `MULTIPOLYGON` and `POINT` are also accepted. Use `POST /geometry/data` to convert a WGS84 GeoJSON geometry into a ready-to-submit BNG WKT string.

Response

200 OK — returns an array of matching local authority rows. Empty array [] when the site does not intersect any local authority area.

Response Fields

Field	Type	Description
`name`	string	Name of the local authority whose area intersects the site.
`id`	string	Stable identifier for the local authority area.

A site at an authority boundary may return more than one row.

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/local-authorities \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_API_KEY" \
  -d '{
    "wkt": "POLYGON((529968 179968, 530033 179968, 530033 180033, 529968 180033, 529968 179968))"
  }'