List 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 }
}

GET

api

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 }
}

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.

Show Crop

string

UUID.

farmId

string

UUID of the parent farm.

fieldId

string

UUID of the field this crop is planted on. Required per the Operations Attachment Principle.

cropType

string

Free-text crop name (e.g. "wheat", "date palm").

variety

string | null

Free-text variety (e.g. "Medjool").

adminCropId

string | null

UUID linking to the admin Crop Library (preferred over free-text).

adminCropVarietyId

string | null

UUID linking to the admin variety record.

plantedArea

string

Numeric string in the farm’s areaUnit.

plantingDate

string | null

ISO 8601.

expectedHarvestDate

string | null

ISO 8601.

actualHarvestDate

string | null

ISO 8601. Auto-set when status transitions to harvested.

season

string | null

One of winter, summer, autumn, spring, year_round.

seasonYear

integer | null

e.g. 2026.

expectedYield

string | null

Numeric string (tons).

actualYield

string | null

Numeric string (tons).

estimatedCost

string | null

Numeric string in the farm’s currency.

actualCost

string | null

Numeric string in the farm’s currency.

estimatedRevenue

string | null

Numeric string in the farm’s currency.

actualRevenue

string | null

Numeric string in the farm’s currency.

status

string

One of planned, planted, growing, harvested, failed.

notes

string | null

Free text, up to 5,000 characters.

createdAt

string

ISO 8601.

updatedAt

string

ISO 8601.

pagination

object

Show Pagination

page

integer

Echoes the requested page.

limit

integer

Page size applied.

total

integer

Total active records matching the query.

totalPages

integer

Math.ceil(total / limit).

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

Status	When
`401`	Missing, malformed, expired, or revoked API key
`403`	Key lacks `crops:read` scope
`429`	Rate limit reached
`5xx`	Server error

Farms (v1)Create crop

Overview

Versioned API (v1)

Crops

Fields

Blocks

Plants

Tasks

Recurring Tasks

Task Templates

Crop Library

Analytics

Market Intelligence

API Keys

Public Endpoints

Authentication

Query parameters

Response

Errors

Overview

Versioned API (v1)

Crops

Fields

Blocks

Plants

Tasks

Recurring Tasks

Task Templates

Crop Library

Analytics

Market Intelligence

API Keys

Public Endpoints

Documentation Index

​Authentication

​Query parameters

​Response

​Errors

Authentication

Query parameters

Response

Errors