Skip to main content
GET
/
api
/
v1
/
farms
/
{id}
/
fields
/
{fieldId}
/
blocks
curl 'https://www.wiseyield.co/api/v1/farms/11111111.../fields/88888888.../blocks?status=mature' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY"

{
  "data": [
    {
      "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "cropId": "33333333-4444-5555-6666-777777777777",
      "fieldId": "88888888-9999-aaaa-bbbb-cccccccccccc",
      "name": "North block — Medjool",
      "plantCount": 60,
      "spacingX": "10",
      "spacingY": "10",
      "plantDensity": "100",
      "area": "0.6",
      "status": "mature",
      "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
See Land hierarchy for when to use blocks vs field-level only.

​
Authentication

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

​
Path parameters

​
id
string
required
Farm UUID.
​
fieldId
string
required
Field UUID.

​
Query parameters

​
status
string
Filter by block status: planned, planted, established, mature, declined, harvested, removed.
​
cropId
string
Filter to blocks of a specific crop (UUID).

​
Response

​
data
array
Array of block objects. Soft-deleted blocks are excluded.
curl 'https://www.wiseyield.co/api/v1/farms/11111111.../fields/88888888.../blocks?status=mature' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY"

{
  "data": [
    {
      "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "cropId": "33333333-4444-5555-6666-777777777777",
      "fieldId": "88888888-9999-aaaa-bbbb-cccccccccccc",
      "name": "North block — Medjool",
      "plantCount": 60,
      "spacingX": "10",
      "spacingY": "10",
      "plantDensity": "100",
      "area": "0.6",
      "status": "mature",
      "createdAt": "2024-03-15T08:00:00.000Z",
      "updatedAt": "2026-05-10T14:30:00.000Z"
    }
  ]
}

​
Errors

StatusWhen
400 INVALID_ID{id} or {fieldId} is not a valid UUID
400 VALIDATION_ERRORInvalid query parameter value
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks fields:read scope
404 NOT_FOUNDFarm or field doesn’t exist or belongs to another user
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error