Skip to main content
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"
{
  "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"
    }
  ]
}

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

Authentication

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

Path parameters

id
string
required
Farm UUID. Must be a farm owned by the authenticated user.

Response

data
array
Array of field objects scoped to the farm. Soft-deleted fields are excluded.
curl 'https://www.wiseyield.co/api/v1/farms/11111111-2222-3333-4444-555555555555/fields' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY"
{
  "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"
    }
  ]
}

Errors

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