Skip to main content
GET
/
api
/
v1
/
farms
/
{id}
/
fields
/
{fieldId}
/
blocks
/
{blockId}
/
plants
curl 'https://www.wiseyield.co/api/v1/farms/11111111.../fields/88888888.../blocks/aaaaaaaa.../plants' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY"
{
  "data": [
    {
      "id": "ffffffff-1111-2222-3333-444444444444",
      "blockId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "label": "Row 1, Tree 4",
      "tagId": "QR-MDJ-0247",
      "position": { "lat": 30.0444, "lng": 31.2357 },
      "plantedAt": "2024-03-15T00:00:00.000Z",
      "status": "alive",
      "createdAt": "2024-03-15T08:00:00.000Z",
      "updatedAt": "2026-05-10T14:30:00.000Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.wiseyield.co/llms.txt

Use this file to discover all available pages before exploring further.

GET https://www.wiseyield.co/api/v1/farms/{id}/fields/{fieldId}/blocks/{blockId}/plants
See Land hierarchy for when per-plant tracking is worthwhile. Most blocks won’t have plant records — populate them only when per-asset operations (pollination tracking, disease quarantine, GAP audit) matter.

Authentication

Requires a key with the fields:read scope. See Authentication.

Path parameters

id
string
required
Farm UUID.
fieldId
string
required
Field UUID.
blockId
string
required
Block UUID.

Response

data
array
Array of plant objects under the block. Soft-deleted plants are excluded.
curl 'https://www.wiseyield.co/api/v1/farms/11111111.../fields/88888888.../blocks/aaaaaaaa.../plants' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY"
{
  "data": [
    {
      "id": "ffffffff-1111-2222-3333-444444444444",
      "blockId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "label": "Row 1, Tree 4",
      "tagId": "QR-MDJ-0247",
      "position": { "lat": 30.0444, "lng": 31.2357 },
      "plantedAt": "2024-03-15T00:00:00.000Z",
      "status": "alive",
      "createdAt": "2024-03-15T08:00:00.000Z",
      "updatedAt": "2026-05-10T14:30:00.000Z"
    }
  ]
}

Errors

StatusWhen
400 INVALID_IDAny path UUID is malformed
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks fields:read scope
404 NOT_FOUNDFarm, field, or block doesn’t exist or belongs to another user
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error