curl 'https://www.wiseyield.co/api/v1/farms/11111111-2222-3333-4444-555555555555/fields' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
`https://www.wiseyield.co/api/v1/farms/${farmId}/fields`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: fields } = await res.json();
import os, requests
res = requests.get(
f'https://www.wiseyield.co/api/v1/farms/{farm_id}/fields',
headers={'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}"},
)
fields = res.json()['data']
{
"data": [
{
"id": "88888888-9999-aaaa-bbbb-cccccccccccc",
"farmId": "11111111-2222-3333-4444-555555555555",
"name": "North Field",
"area": "4.2",
"boundaries": { "type": "Polygon", "coordinates": [[[31.2,30.0],[31.3,30.0],[31.3,30.1],[31.2,30.1],[31.2,30.0]]] },
"soilType": "sandy loam",
"soilPh": "7.2",
"status": "active",
"currentCropId": "33333333-4444-5555-6666-777777777777",
"createdAt": "2024-03-15T08:00:00.000Z",
"updatedAt": "2026-05-10T14:30:00.000Z"
}
]
}
{ "error": "Not found", "code": "NOT_FOUND", "message": "Farm not found" }
Fields
List fields
List fields on a farm.
GET
/
api
/
v1
/
farms
/
{id}
/
fields
curl 'https://www.wiseyield.co/api/v1/farms/11111111-2222-3333-4444-555555555555/fields' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
`https://www.wiseyield.co/api/v1/farms/${farmId}/fields`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: fields } = await res.json();
import os, requests
res = requests.get(
f'https://www.wiseyield.co/api/v1/farms/{farm_id}/fields',
headers={'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}"},
)
fields = res.json()['data']
{
"data": [
{
"id": "88888888-9999-aaaa-bbbb-cccccccccccc",
"farmId": "11111111-2222-3333-4444-555555555555",
"name": "North Field",
"area": "4.2",
"boundaries": { "type": "Polygon", "coordinates": [[[31.2,30.0],[31.3,30.0],[31.3,30.1],[31.2,30.1],[31.2,30.0]]] },
"soilType": "sandy loam",
"soilPh": "7.2",
"status": "active",
"currentCropId": "33333333-4444-5555-6666-777777777777",
"createdAt": "2024-03-15T08:00:00.000Z",
"updatedAt": "2026-05-10T14:30:00.000Z"
}
]
}
{ "error": "Not found", "code": "NOT_FOUND", "message": "Farm not found" }
GET https://www.wiseyield.co/api/v1/farms/{id}/fields
Authentication
Requires a key with thefields:read scope. See Authentication.
Path parameters
Farm UUID. Must be a farm owned by the authenticated user.
Response
Array of field objects scoped to the farm. Soft-deleted fields are excluded.
Show Field
Show Field
UUID.
UUID of the parent farm.
Field name.
Free-text description.
Numeric string in the farm’s
areaUnit.GeoJSON
Polygon for the field perimeter.Free-text soil description.
pH as numeric string.
One of
active, fallow, preparing, planted.Active crop on this field (if any).
Free text, up to 5,000 characters.
Liters/hour per emitter (Blueprint §9.4).
Emitter count per plant.
Drip-line spacing in meters.
One of
drip, sprinkler, flood, pivot, manual, none — overrides farm default.ISO 8601.
ISO 8601.
curl 'https://www.wiseyield.co/api/v1/farms/11111111-2222-3333-4444-555555555555/fields' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
`https://www.wiseyield.co/api/v1/farms/${farmId}/fields`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: fields } = await res.json();
import os, requests
res = requests.get(
f'https://www.wiseyield.co/api/v1/farms/{farm_id}/fields',
headers={'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}"},
)
fields = res.json()['data']
{
"data": [
{
"id": "88888888-9999-aaaa-bbbb-cccccccccccc",
"farmId": "11111111-2222-3333-4444-555555555555",
"name": "North Field",
"area": "4.2",
"boundaries": { "type": "Polygon", "coordinates": [[[31.2,30.0],[31.3,30.0],[31.3,30.1],[31.2,30.1],[31.2,30.0]]] },
"soilType": "sandy loam",
"soilPh": "7.2",
"status": "active",
"currentCropId": "33333333-4444-5555-6666-777777777777",
"createdAt": "2024-03-15T08:00:00.000Z",
"updatedAt": "2026-05-10T14:30:00.000Z"
}
]
}
{ "error": "Not found", "code": "NOT_FOUND", "message": "Farm not found" }
Errors
| Status | When |
|---|---|
400 INVALID_ID | {id} is not a valid UUID |
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks fields:read scope |
404 NOT_FOUND | Farm doesn’t exist, is soft-deleted, or belongs to another user |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |
⌘I