curl 'https://www.wiseyield.co/api/v1/farms/11111111.../fields/88888888.../blocks/aaaaaaaa...' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
`https://www.wiseyield.co/api/v1/farms/${farmId}/fields/${fieldId}/blocks/${blockId}`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: block } = await res.json();
{
"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",
"status": "mature",
"createdAt": "2024-03-15T08:00:00.000Z",
"updatedAt": "2026-05-10T14:30:00.000Z"
}
}
Blocks
Get block
Retrieve a single block by its UUID.
GET
/
api
/
v1
/
farms
/
{id}
/
fields
/
{fieldId}
/
blocks
/
{blockId}
curl 'https://www.wiseyield.co/api/v1/farms/11111111.../fields/88888888.../blocks/aaaaaaaa...' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
`https://www.wiseyield.co/api/v1/farms/${farmId}/fields/${fieldId}/blocks/${blockId}`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: block } = await res.json();
{
"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",
"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/{blockId}
Authentication
Requires a key with thefields:read scope.
Path parameters
string
required
Farm UUID.
string
required
Field UUID.
string
required
Block UUID.
Response
Returns the block wrapped underdata. See List blocks for the full field reference.
To also retrieve per-plant detail, use List plants in block.
curl 'https://www.wiseyield.co/api/v1/farms/11111111.../fields/88888888.../blocks/aaaaaaaa...' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
`https://www.wiseyield.co/api/v1/farms/${farmId}/fields/${fieldId}/blocks/${blockId}`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: block } = await res.json();
{
"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",
"status": "mature",
"createdAt": "2024-03-15T08:00:00.000Z",
"updatedAt": "2026-05-10T14:30:00.000Z"
}
}
Errors
| Status | When |
|---|---|
400 INVALID_ID | Any path UUID is malformed |
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks fields:read scope |
404 NOT_FOUND | Farm, field, or block doesn’t exist or belongs to another user |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |