Developer Preview

Public API for UKCS data discovery.

The API provides lightweight access to catalogue metadata, named feature search, and area-of-interest searches across open UKCS datasets.

OpenAPI JSON llms.txt

Base URL

https://api.ukcsdataatlas.com

The documentation and OpenAPI file are hosted on the public website. API calls are served by the API subdomain.

Endpoints

Catalogue	`GET /api/catalogue` Dataset/provider catalogue, attribution links, and source recency metadata.
Feature search	`GET /api/search-features?q=Galleon` Search named map features and return centres and extents.
Search summary	`GET /api/search-features/summary` Counts of searchable features and source layers.
Point AOI search	`GET /api/search-open-datasets?lat=53.5&lon=1.8&radius_m=25000` Search datasets around a point and radius.
Geometry AOI search	`POST /api/search-open-datasets` Search datasets using a GeoJSON point, line, polygon, or multipolygon geometry.
Recency	`GET /api/dataset-recency` Current source and tile-cache recency metadata.
Attribution	`GET /api/source-attributions` Provider attribution, licence, and source-link metadata.
Metocean capabilities	`GET /api/metocean/capabilities` Available modelled metocean providers and products.

Example

Search open datasets within 25 km of a point:

curl "https://api.ukcsdataatlas.com/api/search-open-datasets?lat=53.512523&lon=1.830577&radius_m=25000"

Search using a GeoJSON AOI:

curl -X POST "https://api.ukcsdataatlas.com/api/search-open-datasets" \
  -H "content-type: application/json" \
  -d '{"geometry":{"type":"Point","coordinates":[1.830577,53.512523]},"radius_m":25000}'

Scope

This public API is for discovery and screening. It does not expose account data, saved AOIs, subscriptions, internal health checks, private model-cache files, or account-gated exports.

Source datasets remain subject to original provider licences and attribution requirements. Results should be checked against authoritative source systems before operational, legal, or statutory use.