UK Data AtlasAPI

Get terrain elevation

Sample bare-earth elevation at an EPSG:27700 point and receive the interpolation method, source version, hash, datum and uncertainty alongside the value.

get
/terrain/elevation/point

Good to know

  • outside_coverage and nodata are explicit successful results, not zeroes or guessed values.
  • A remote preview may be enabled without storing raster files locally.

Query parameters

  • xnumberrequired

    Easting in EPSG:27700 metres.

  • ynumberrequired

    Northing in EPSG:27700 metres.

  • interpolationstringoptional

    Interpolation method applied to the source raster.

    One ofbilinearnearest
    Defaultbilinear
  • versionstringoptional

    Exact source version; omitted selects the provider default.

Returns

TerrainPointEnvelope

Elevation value or explicit coverage/data absence.

  • apiVersionv1required
  • atlasReleasestringrequired

    The immutable /atlas-release releaseId for the artifacts that produced this response.

  • metaobjectrequired
    Show1 child field
    • nextCursorstring | nullrequired

      Opaque cursor for the next page, or null at the end.

  • dataTerrainPointrequired
    Show7 child fields
    • statusstringrequired
      One ofokoutside_coveragenodata
    • xnumberrequired
    • ynumberrequired
    • interpolationstringrequired
      One ofbilinearnearest
    • unitmetresrequired
    • valuenumber | nullrequired
    • sourceobjectrequired
      Show14 child fields
      • idstringrequired
      • versionstringrequired
      • provenancestringoptional
        One oflocalremote-preview
      • tileHashstringrequired
      • contentHashstringrequired
      • crsEPSG:27700required
      • horizontalDatumOSGB36required
      • horizontalTransformationOSTN15optional
      • verticalDatumODNrequired
      • verticalModelOSGM15optional
      • resolutionMetresnumberrequired
      • noDatanumber | nullrequired
      • uncertaintyobjectrequired
        Show2 child fields
        • metricstringrequired
          One ofrmsestated_accuracy
        • valueMetresnumberrequired
      • coverageobjectrequired
        Show3 child fields
        • kindbboxrequired
        • bboxnumber[]required
        • footprintHashstringrequired

When it goes wrong

  • 400A query parameter is malformed or its cursor is not valid for this result set.
  • 404No resource matches that identity.
  • 503The referenced build artifact has not been built yet.

Every error has the same shape. See Errors for how to handle them.

Technical notes

Show the precise behaviour

Returns a bare-earth elevation sampled in British National Grid metres. The answer identifies the exact source version and tile hash used. An outside-coverage or no-data point is a successful response with an explicit status; neither is converted into a plausible elevation. This endpoint requires a configured terrain provider and does not imply that the catalogue's planned products are published.