POST /datasets/radon

Returns every radon dataset row that intersects a given geometry, or an empty array 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/radon

Content-Type: application/json

Request Body

Field Type Required Description
wkt string Yes The query geometry as a WKT string in British National Grid (EPSG:27700), with coordinates as easting northing. POINT and POLYGON are both accepted; every row whose geometry intersects the input is returned.

Response

200 OK — returns an array of intersecting radon rows, or [] when nothing intersects.

Response Fields

Field Type Description
class number Radon classification band for the area.
nominal_pct_band string | null Nominal percentage band of homes estimated above the action level.
actual_pct_band string | null Actual percentage band of homes estimated above the action level.
id string | null Stable identifier for the row.
geometry GeoJSON Polygon | MultiPolygon Area geometry as GeoJSON in WGS84 (EPSG:4326), [longitude, latitude].

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