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