Kaax
HomeSign In
Referencia

Lots

The georeferenced parcels an analysis or a queue runs on. This is where a queue's lot id comes from.

GET/api/v2/lots

The account's lots, with their area, centroid and bounding box.

Parámetros

namestringoptional

Partial, case-insensitive match.

withGeometrybooleanoptional

`true` keeps only lots with a measured area — the ones a queue can run.

pageintegeroptionaldefault 1

Page number, starting at 1.

limitintegeroptionaldefault 20 · max 100

Results per page.

Response

json
{
  "total": 2,
  "page": 1,
  "limit": 50,
  "data": [
    {
      "id": "6a7a8c177a894f021d22249e",
      "name": "Banano Álamos",
      "areaHa": 6.279,
      "centroid": { "lat": 14.31, "lng": -91.02 },
      "bbox": [-91.05, 14.28, -90.99, 14.34],
      "runnable": true,
      "createdAt": "2026-05-14T18:22:34.159Z"
    }
  ]
}

A tener en cuenta

  • `runnable: false` means the lot has no geometry, so a queue skips it — it cannot be matched to a raster.
  • Not to be confused with `/api/v2/fields`, which returns image sets. Their ids are NOT interchangeable.