Location by ID
Retrieve a single location by its stable ID.
Returns the full location resource (metadata and links to metric endpoints). Geometry is opt-in โ see Query parameters below. Returns 404 Not Found if the location does not exist or is not accessible to your organization.
โถRequest
โถMethod & Path
GET /locations/:id
โถPath parameters
- id (uuid, required) โ The location ID (the
location_idsurfaced on ingestion results).
โถQuery parameters
- include_geometries (
true/false, defaultfalse) โ whentrue, thegeoattribute is included in the JSON response. Omitted by default. A GeoJSONAcceptformat (application/geo+json) always returns geometry regardless of this flag. See Query Parameters โ Geometry. - include (
assessment/deforestation, comma-separated) โ attaches opt-in related payloads underrelationships.deforestationadds the cached EUDR compliance roll-up (facilities and sheds only; plot rows omit it). See List Locations โ Includes for the block shape.
โถResponse
- 200 โ Location resource.
- 404 โ Location not found or not accessible. See Error Codes.
The data shape is the same as a single item from the list endpoint. See List Locations for the full attribute table.
โถRelated assessments (include=assessment)
include=assessment)Pass ?include=assessment to attach this location's full assessment aggregate
under relationships.assessment โ confidence, hazard, infrastructure,
deforestation screen, and (with assessments:read) the EUDR-scope legality /
country-risk / EUDR-profile partitions. The base response stays gated on
locations:read; the three EUDR-scope partitions additionally require
assessments:read. See
Assessments on Ingestion Responses
and the Assessments API.
Required scope:
locations:read