Skip to main content
GET
/
api
/
v1
/
crops
curl 'https://www.wiseyield.co/api/v1/crops?status=growing&limit=50' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY"
{
  "data": [
    {
      "id": "33333333-4444-5555-6666-777777777777",
      "farmId": "11111111-2222-3333-4444-555555555555",
      "fieldId": "88888888-9999-aaaa-bbbb-cccccccccccc",
      "cropType": "date palm",
      "variety": "Medjool",
      "adminCropId": null,
      "adminCropVarietyId": null,
      "plantedArea": "4.2",
      "plantingDate": "2024-03-15T00:00:00.000Z",
      "expectedHarvestDate": "2026-10-01T00:00:00.000Z",
      "actualHarvestDate": null,
      "season": "spring",
      "seasonYear": 2024,
      "expectedYield": "180",
      "actualYield": null,
      "estimatedCost": "12000",
      "actualCost": "10500",
      "estimatedRevenue": "45000",
      "actualRevenue": null,
      "status": "growing",
      "notes": "Drip-irrigated, fall NPK pending",
      "createdAt": "2024-03-15T08:00:00.000Z",
      "updatedAt": "2026-05-10T14:30:00.000Z"
    }
  ],
  "pagination": { "page": 1, "limit": 50, "total": 1, "totalPages": 1 }
}

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/crops

Authentication

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

Query parameters

page
integer
default:"1"
Page number (≥ 1).
limit
integer
default:"20"
Results per page (1–100; values above 100 are clamped to 100).
status
string
Filter by status: planned, planted, growing, harvested, failed.
farmId
string
Filter to crops on a specific farm (UUID).
fieldId
string
Filter to crops on a specific field (UUID).
sort
string
default:"createdAt"
Sort field: createdAt, cropType, plantedArea, plantingDate.
order
string
default:"desc"
Sort direction: asc, desc.

Response

data
array
Array of crop objects.
pagination
object
curl 'https://www.wiseyield.co/api/v1/crops?status=growing&limit=50' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY"
{
  "data": [
    {
      "id": "33333333-4444-5555-6666-777777777777",
      "farmId": "11111111-2222-3333-4444-555555555555",
      "fieldId": "88888888-9999-aaaa-bbbb-cccccccccccc",
      "cropType": "date palm",
      "variety": "Medjool",
      "adminCropId": null,
      "adminCropVarietyId": null,
      "plantedArea": "4.2",
      "plantingDate": "2024-03-15T00:00:00.000Z",
      "expectedHarvestDate": "2026-10-01T00:00:00.000Z",
      "actualHarvestDate": null,
      "season": "spring",
      "seasonYear": 2024,
      "expectedYield": "180",
      "actualYield": null,
      "estimatedCost": "12000",
      "actualCost": "10500",
      "estimatedRevenue": "45000",
      "actualRevenue": null,
      "status": "growing",
      "notes": "Drip-irrigated, fall NPK pending",
      "createdAt": "2024-03-15T08:00:00.000Z",
      "updatedAt": "2026-05-10T14:30:00.000Z"
    }
  ],
  "pagination": { "page": 1, "limit": 50, "total": 1, "totalPages": 1 }
}

Errors

StatusWhen
401Missing, malformed, expired, or revoked API key
403Key lacks crops:read scope
429Rate limit reached
5xxServer error