curl 'https://www.wiseyield.co/api/v1/crops/33333333-4444-5555-6666-777777777777' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
`https://www.wiseyield.co/api/v1/crops/${cropId}`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: crop } = await res.json();
import os, requests
res = requests.get(
f'https://www.wiseyield.co/api/v1/crops/{crop_id}',
headers={'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}"},
)
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",
"status": "growing",
"createdAt": "2024-03-15T08:00:00.000Z",
"updatedAt": "2026-05-10T14:30:00.000Z"
}
}
{
"error": "Invalid ID",
"code": "INVALID_ID",
"message": "Crop ID must be a valid UUID"
}
{
"error": "Not found",
"code": "NOT_FOUND",
"message": "Crop not found"
}
Crops
Get crop
Retrieve a single crop by its UUID.
GET
/
api
/
v1
/
crops
/
{id}
curl 'https://www.wiseyield.co/api/v1/crops/33333333-4444-5555-6666-777777777777' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
`https://www.wiseyield.co/api/v1/crops/${cropId}`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: crop } = await res.json();
import os, requests
res = requests.get(
f'https://www.wiseyield.co/api/v1/crops/{crop_id}',
headers={'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}"},
)
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",
"status": "growing",
"createdAt": "2024-03-15T08:00:00.000Z",
"updatedAt": "2026-05-10T14:30:00.000Z"
}
}
{
"error": "Invalid ID",
"code": "INVALID_ID",
"message": "Crop ID must be a valid UUID"
}
{
"error": "Not found",
"code": "NOT_FOUND",
"message": "Crop not found"
}
GET https://www.wiseyield.co/api/v1/crops/{id}
Authentication
Requires a key with thecrops:read scope.
Path parameters
string
required
Crop UUID.
Response
Returns the crop wrapped underdata. See List crops for the full field reference.
curl 'https://www.wiseyield.co/api/v1/crops/33333333-4444-5555-6666-777777777777' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
`https://www.wiseyield.co/api/v1/crops/${cropId}`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: crop } = await res.json();
import os, requests
res = requests.get(
f'https://www.wiseyield.co/api/v1/crops/{crop_id}',
headers={'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}"},
)
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",
"status": "growing",
"createdAt": "2024-03-15T08:00:00.000Z",
"updatedAt": "2026-05-10T14:30:00.000Z"
}
}
{
"error": "Invalid ID",
"code": "INVALID_ID",
"message": "Crop ID must be a valid UUID"
}
{
"error": "Not found",
"code": "NOT_FOUND",
"message": "Crop 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 crops:read scope |
404 NOT_FOUND | Crop doesn’t exist, is soft-deleted, or belongs to a farm the user doesn’t own |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |