Farms (v1)

curl 'https://www.wiseyield.co/api/v1/farms?page=1&limit=20&status=active&sort=name&order=asc' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY"

const res = await fetch(
  'https://www.wiseyield.co/api/v1/farms?page=1&limit=20&status=active&sort=name&order=asc',
  { headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data, pagination } = await res.json();
console.log(`Got ${data.length} of ${pagination.total} farms`);

import os, requests

res = requests.get(
    'https://www.wiseyield.co/api/v1/farms',
    params={'page': 1, 'limit': 20, 'status': 'active', 'sort': 'name', 'order': 'asc'},
    headers={'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}"},
)
body = res.json()
print(f"Got {len(body['data'])} of {body['pagination']['total']} farms")

{
  "data": [
    {
      "id": "11111111-2222-3333-4444-555555555555",
      "name": "Green Valley Farm",
      "farmType": "commercial",
      "primaryUse": "crops",
      "city": "Cairo",
      "country": "Egypt",
      "totalArea": "250",
      "areaUnit": "hectare",
      "soilType": "sandy loam",
      "irrigationSystem": "drip",
      "status": "active",
      "createdAt": "2026-04-12T10:00:00.000Z",
      "updatedAt": "2026-05-14T14:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  }
}

{
  "error": "Unauthorized",
  "message": "Invalid or revoked API key",
  "code": "INVALID_API_KEY"
}

{
  "error": "Forbidden",
  "message": "Insufficient permissions. Required scope: farms:read",
  "code": "INSUFFICIENT_SCOPE",
  "details": {
    "requiredScope": "farms:read",
    "availableScopes": ["crops:read"]
  }
}

{
  "error": "Rate limit exceeded",
  "code": "RATE_LIMIT_EXCEEDED"
}

curl -X POST https://www.wiseyield.co/api/v1/farms \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maple Ridge Farm",
    "city": "Portland",
    "country": "United States",
    "totalArea": 180,
    "areaUnit": "acre",
    "farmType": "organic",
    "primaryUse": "crops",
    "soilType": "loam",
    "irrigationSystem": "drip",
    "latitude": 45.5152,
    "longitude": -122.6784,
    "status": "active"
  }'

const res = await fetch('https://www.wiseyield.co/api/v1/farms', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Maple Ridge Farm',
    city: 'Portland',
    country: 'United States',
    totalArea: 180,
    areaUnit: 'acre',
    farmType: 'organic',
    primaryUse: 'crops',
    soilType: 'loam',
    irrigationSystem: 'drip',
    latitude: 45.5152,
    longitude: -122.6784,
    status: 'active',
  }),
});

const { data: farm } = await res.json();
console.log('Created farm:', farm.id);

import os, requests

res = requests.post(
    'https://www.wiseyield.co/api/v1/farms',
    headers={
        'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}",
        'Content-Type': 'application/json',
    },
    json={
        'name': 'Maple Ridge Farm',
        'city': 'Portland',
        'country': 'United States',
        'totalArea': 180,
        'areaUnit': 'acre',
        'farmType': 'organic',
        'primaryUse': 'crops',
        'soilType': 'loam',
        'irrigationSystem': 'drip',
        'latitude': 45.5152,
        'longitude': -122.6784,
        'status': 'active',
    },
)
farm = res.json()['data']
print('Created farm:', farm['id'])

{
  "data": {
    "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "ownerId": "user_...",
    "name": "Maple Ridge Farm",
    "farmType": "organic",
    "primaryUse": "crops",
    "city": "Portland",
    "country": "United States",
    "totalArea": "180",
    "areaUnit": "acre",
    "soilType": "loam",
    "irrigationSystem": "drip",
    "latitude": "45.5152",
    "longitude": "-122.6784",
    "status": "active",
    "createdAt": "2026-05-17T14:23:01.000Z",
    "updatedAt": "2026-05-17T14:23:01.000Z"
  }
}

{
  "error": "Validation failed",
  "details": {
    "totalArea": ["Total area must be greater than 0"],
    "country": ["Country is required"]
  }
}

{
  "error": "Conflict",
  "message": "A farm with this name already exists"
}