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_id surfaced on ingestion results).

Query parameters

  • include_geometries (true / false, default false) โ€” when true, the geo attribute is included in the JSON response. Omitted by default. A GeoJSON Accept format (application/geo+json) always returns geometry regardless of this flag. See Query Parameters โ†’ Geometry.
  • include (assessment / deforestation, comma-separated) โ€” attaches opt-in related payloads under relationships. deforestation adds 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.

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