Skip to main content
GET
/
api
/
v1
/
farms
/
{id}
/
health-score
curl 'https://www.wiseyield.co/api/v1/farms/11111111-2222-3333-4444-555555555555/health-score' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY"
{
  "data": {
    "overallScore": 123,
    "overallLabel": "<string>",
    "categories": [
      {
        "name": "<string>",
        "score": 123,
        "label": "<string>",
        "signals": [
          {}
        ]
      }
    ],
    "computedAt": "<string>"
  }
}

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}/health-score
Computes a composite farm health score (0–100) and per-category breakdowns covering crops, financials, tasks, and alerts over the last 30 and 90 day windows.

Authentication

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

Path parameters

id
string
required
Farm UUID.

Response

data
object
curl 'https://www.wiseyield.co/api/v1/farms/11111111-2222-3333-4444-555555555555/health-score' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY"

Errors

StatusWhen
400 INVALID_ID{id} is not a valid UUID
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks analytics: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