Plot by ID

Retrieve a single plot by its ID.

Returns the full plot resource (links to its metric endpoints). Geometry is opt-in โ€” see Query parameters below.

Request

Method & Path

GET /locations/plots/:id

Path parameters

  • id (uuid, required) โ€” Plot ID. Equal to the location_id surfaced on ingestion results for plots created via ingestion.

Query parameters

  • include_geometries (true / false, default false) โ€” when true, the geo attribute (the plot polygon) is included in the JSON response. Omitted by default โ€” and plot polygons are large, so this matters most here. A GeoJSON Accept format (application/geo+json) always returns geometry regardless of this flag. See Query Parameters โ†’ Geometry.

Query parameters

  • include_geometries (true / false, default false) โ€” when true, the geo attribute (the plot polygon) is included in the JSON response. Omitted by default โ€” and plot polygons are large, so this matters most here. A GeoJSON Accept format (application/geo+json) always returns geometry regardless of this flag. See Query Parameters โ†’ Geometry.

Response

  • 200 โ€” Plot resource.
  • 404 โ€” Plot not found or not accessible. See Error Codes.

Pass ?include=assessment to attach this plot's full assessment aggregate under relationships.assessment in one fetch. The base response stays gated on locations:read; the EUDR-scope legality / country-risk / EUDR-profile partitions additionally require assessments:read. See Assessments on Ingestion Responses and the Assessments API.

Required scope: locations:read