Create crop - WiseYield

curl -X POST https://www.wiseyield.co/api/v1/crops \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "farmId": "11111111-2222-3333-4444-555555555555",
    "fieldId": "88888888-9999-aaaa-bbbb-cccccccccccc",
    "cropType": "date palm",
    "variety": "Medjool",
    "plantedArea": 4.2,
    "plantingDate": "2024-03-15T00:00:00.000Z",
    "season": "spring",
    "seasonYear": 2024,
    "status": "growing"
  }'

const res = await fetch('https://www.wiseyield.co/api/v1/crops', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    farmId: '11111111-2222-3333-4444-555555555555',
    fieldId: '88888888-9999-aaaa-bbbb-cccccccccccc',
    cropType: 'date palm',
    variety: 'Medjool',
    plantedArea: 4.2,
    status: 'growing',
  }),
});
const { data: crop } = await res.json();

import os, requests

res = requests.post(
    'https://www.wiseyield.co/api/v1/crops',
    headers={
        'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}",
        'Content-Type': 'application/json',
    },
    json={
        'farmId': '11111111-2222-3333-4444-555555555555',
        'fieldId': '88888888-9999-aaaa-bbbb-cccccccccccc',
        'cropType': 'date palm',
        'variety': 'Medjool',
        'plantedArea': 4.2,
        'status': 'growing',
    },
)
crop = res.json()['data']

{
  "data": {
    "id": "33333333-4444-5555-6666-777777777777",
    "farmId": "11111111-2222-3333-4444-555555555555",
    "fieldId": "88888888-9999-aaaa-bbbb-cccccccccccc",
    "cropType": "date palm",
    "variety": "Medjool",
    "plantedArea": "4.2",
    "plantingDate": "2024-03-15T00:00:00.000Z",
    "season": "spring",
    "seasonYear": 2024,
    "status": "growing",
    "createdAt": "2026-05-17T16:00:00.000Z",
    "updatedAt": "2026-05-17T16:00:00.000Z"
  }
}

{
  "error": "Validation failed",
  "code": "VALIDATION_ERROR",
  "details": {
    "plantedArea": ["Planted area must be a positive number"],
    "fieldId": ["Valid field ID required"]
  }
}

{
  "error": "Validation failed",
  "code": "VALIDATION_ERROR",
  "message": "Field not found on this farm"
}

{
  "error": "Not found",
  "code": "NOT_FOUND",
  "message": "Farm not found or access denied"
}

POST

api

crops

curl -X POST https://www.wiseyield.co/api/v1/crops \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "farmId": "11111111-2222-3333-4444-555555555555",
    "fieldId": "88888888-9999-aaaa-bbbb-cccccccccccc",
    "cropType": "date palm",
    "variety": "Medjool",
    "plantedArea": 4.2,
    "plantingDate": "2024-03-15T00:00:00.000Z",
    "season": "spring",
    "seasonYear": 2024,
    "status": "growing"
  }'

const res = await fetch('https://www.wiseyield.co/api/v1/crops', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    farmId: '11111111-2222-3333-4444-555555555555',
    fieldId: '88888888-9999-aaaa-bbbb-cccccccccccc',
    cropType: 'date palm',
    variety: 'Medjool',
    plantedArea: 4.2,
    status: 'growing',
  }),
});
const { data: crop } = await res.json();

import os, requests

res = requests.post(
    'https://www.wiseyield.co/api/v1/crops',
    headers={
        'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}",
        'Content-Type': 'application/json',
    },
    json={
        'farmId': '11111111-2222-3333-4444-555555555555',
        'fieldId': '88888888-9999-aaaa-bbbb-cccccccccccc',
        'cropType': 'date palm',
        'variety': 'Medjool',
        'plantedArea': 4.2,
        'status': 'growing',
    },
)
crop = res.json()['data']

{
  "data": {
    "id": "33333333-4444-5555-6666-777777777777",
    "farmId": "11111111-2222-3333-4444-555555555555",
    "fieldId": "88888888-9999-aaaa-bbbb-cccccccccccc",
    "cropType": "date palm",
    "variety": "Medjool",
    "plantedArea": "4.2",
    "plantingDate": "2024-03-15T00:00:00.000Z",
    "season": "spring",
    "seasonYear": 2024,
    "status": "growing",
    "createdAt": "2026-05-17T16:00:00.000Z",
    "updatedAt": "2026-05-17T16:00:00.000Z"
  }
}

{
  "error": "Validation failed",
  "code": "VALIDATION_ERROR",
  "details": {
    "plantedArea": ["Planted area must be a positive number"],
    "fieldId": ["Valid field ID required"]
  }
}

{
  "error": "Validation failed",
  "code": "VALIDATION_ERROR",
  "message": "Field not found on this farm"
}

{
  "error": "Not found",
  "code": "NOT_FOUND",
  "message": "Farm not found or access denied"
}

POST https://www.wiseyield.co/api/v1/crops

Authentication

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

Request body

farmId

string

required

UUID of the parent farm. Must be owned by the authenticated user.

fieldId

string

required

UUID of the field. Must belong to farmId. Required per the Operations Attachment Principle.

cropType

string

required

1–200 characters. Free-text crop name (e.g. "wheat", "date palm").

plantedArea

number | string

required

Positive number in the farm’s areaUnit. Accepts string or number.

variety

string

Up to 200 characters. Free-text variety.

adminCropId

string

UUID linking to the admin Crop Library. Prefer this over cropType when the crop is in the catalog.

adminCropVarietyId

string

UUID linking to the admin variety record.

plantingDate

string

ISO 8601 datetime.

expectedHarvestDate

string

ISO 8601 datetime.

season

string

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

seasonYear

integer

2000–2100.

expectedYield

number | string

Tons.

estimatedCost

number | string

In the farm’s currency.

estimatedRevenue

number | string

In the farm’s currency.

status

string

default:"planned"

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

notes

string

Up to 5,000 characters.

Response

Returns the created crop wrapped under data. See List crops for the full field reference.

curl -X POST https://www.wiseyield.co/api/v1/crops \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "farmId": "11111111-2222-3333-4444-555555555555",
    "fieldId": "88888888-9999-aaaa-bbbb-cccccccccccc",
    "cropType": "date palm",
    "variety": "Medjool",
    "plantedArea": 4.2,
    "plantingDate": "2024-03-15T00:00:00.000Z",
    "season": "spring",
    "seasonYear": 2024,
    "status": "growing"
  }'

const res = await fetch('https://www.wiseyield.co/api/v1/crops', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    farmId: '11111111-2222-3333-4444-555555555555',
    fieldId: '88888888-9999-aaaa-bbbb-cccccccccccc',
    cropType: 'date palm',
    variety: 'Medjool',
    plantedArea: 4.2,
    status: 'growing',
  }),
});
const { data: crop } = await res.json();

import os, requests

res = requests.post(
    'https://www.wiseyield.co/api/v1/crops',
    headers={
        'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}",
        'Content-Type': 'application/json',
    },
    json={
        'farmId': '11111111-2222-3333-4444-555555555555',
        'fieldId': '88888888-9999-aaaa-bbbb-cccccccccccc',
        'cropType': 'date palm',
        'variety': 'Medjool',
        'plantedArea': 4.2,
        'status': 'growing',
    },
)
crop = res.json()['data']

{
  "data": {
    "id": "33333333-4444-5555-6666-777777777777",
    "farmId": "11111111-2222-3333-4444-555555555555",
    "fieldId": "88888888-9999-aaaa-bbbb-cccccccccccc",
    "cropType": "date palm",
    "variety": "Medjool",
    "plantedArea": "4.2",
    "plantingDate": "2024-03-15T00:00:00.000Z",
    "season": "spring",
    "seasonYear": 2024,
    "status": "growing",
    "createdAt": "2026-05-17T16:00:00.000Z",
    "updatedAt": "2026-05-17T16:00:00.000Z"
  }
}

{
  "error": "Validation failed",
  "code": "VALIDATION_ERROR",
  "details": {
    "plantedArea": ["Planted area must be a positive number"],
    "fieldId": ["Valid field ID required"]
  }
}

{
  "error": "Validation failed",
  "code": "VALIDATION_ERROR",
  "message": "Field not found on this farm"
}

{
  "error": "Not found",
  "code": "NOT_FOUND",
  "message": "Farm not found or access denied"
}

Errors

Status	When
`400 VALIDATION_ERROR`	Schema validation failed (`details` carries per-field messages), OR `fieldId` doesn’t belong to `farmId`
`401`	Missing, malformed, expired, or revoked API key
`403 INSUFFICIENT_SCOPE`	Key lacks `crops:write` scope
`404 NOT_FOUND`	`farmId` not owned by the authenticated user (or soft-deleted)
`429 RATE_LIMIT_EXCEEDED`	Per-user rate limit reached
`5xx`	Server error

List crops Get crop

​Authentication

​Request body

​Response

​Errors

Authentication

Request body

Response

Errors