curl 'https://www.wiseyield.co/api/v1/farms/11111111.../fields/88888888.../blocks?status=mature' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
`https://www.wiseyield.co/api/v1/farms/${farmId}/fields/${fieldId}/blocks?status=mature`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: blocks } = await res.json();
import os, requests
res = requests.get(
f'https://www.wiseyield.co/api/v1/farms/{farm_id}/fields/{field_id}/blocks',
params={'status': 'mature'},
headers={'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}"},
)
blocks = res.json()['data']
{
"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"
}
]
}
Blocks
List blocks
List blocks on a field. Blocks are variety/management cohorts inside a field.
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"
const res = await fetch(
`https://www.wiseyield.co/api/v1/farms/${farmId}/fields/${fieldId}/blocks?status=mature`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: blocks } = await res.json();
import os, requests
res = requests.get(
f'https://www.wiseyield.co/api/v1/farms/{farm_id}/fields/{field_id}/blocks',
params={'status': 'mature'},
headers={'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}"},
)
blocks = res.json()['data']
{
"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"
}
]
}
GET https://www.wiseyield.co/api/v1/farms/{id}/fields/{fieldId}/blocks
Authentication
Requires a key with thefields:read scope. See Authentication.
Path parameters
string
required
Farm UUID.
string
required
Field UUID.
Query parameters
string
Filter by block status:
planned, planted, established, mature, declined, harvested, removed.string
Filter to blocks of a specific crop (UUID).
Response
array
Array of block objects. Soft-deleted blocks are excluded.
Show Block
Show Block
string
UUID.
string
UUID of the parent crop.
string
UUID of the parent field.
string | null
UUID linking to admin variety record (pulls spacing/density defaults).
string
Block name (e.g. “North block — Siwi”).
string | null
Free text.
string | null
ISO 8601.
integer | null
Total plant count in the block.
string | null
Row spacing in meters (numeric string).
string | null
Plant spacing in meters (numeric string).
string | null
Plants per hectare (numeric string).
string | null
Block area (numeric string).
object | null
GeoJSON
Polygon or Point.object | null
Grid metadata (
{ pattern, rowCount, columnCount, rowOrientation, originLatLng }).string
One of
planned, planted, established, mature, declined, harvested, removed.string | null
Free text.
string
ISO 8601.
string
ISO 8601.
curl 'https://www.wiseyield.co/api/v1/farms/11111111.../fields/88888888.../blocks?status=mature' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
`https://www.wiseyield.co/api/v1/farms/${farmId}/fields/${fieldId}/blocks?status=mature`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: blocks } = await res.json();
import os, requests
res = requests.get(
f'https://www.wiseyield.co/api/v1/farms/{farm_id}/fields/{field_id}/blocks',
params={'status': 'mature'},
headers={'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}"},
)
blocks = res.json()['data']
{
"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
| Status | When |
|---|---|
400 INVALID_ID | {id} or {fieldId} is not a valid UUID |
400 VALIDATION_ERROR | Invalid query parameter value |
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks fields:read scope |
404 NOT_FOUND | Farm or field doesn’t exist or belongs to another user |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |