API Reference

Field Economics

Fertilization and irrigation cost-savings estimates from satellite-derived variable-rate zones.

get/field-economics/{field_id}/cost-savings

Get fertilization and irrigation cost-savings estimate for a field

Estimate the fertilization/irrigation input savings (%) from applying satellite- derived variable-rate zones instead of a single flat rate across the whole field.

Requires an Authorization: Bearer header.

Parameters

field_idstringpathrequired

Response 200

field_idstringrequired

captured_atstring<date-time>required

fertilizationCostSavingsEstimaterequired

irrigationCostSavingsEstimaterequired

GET /field-economics/{field_id}/cost-savings

curl -X GET "https://api.cropsense.africa/field-economics/8b6e1a2f-2d4c-4e9a-9b0f-1c7d3e5a6f42/cost-savings" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Example response · 200

{
  "field_id": "8b6e1a2f-2d4c-4e9a-9b0f-1c7d3e5a6f42",
  "captured_at": "2026-06-15T09:30:00Z",
  "fertilization": {
    "total_area_ha": 1.5,
    "grid_size_meters": 1,
    "flat_rate_units_ha": 1.5,
    "variable_rate_units_ha": 1.5,
    "savings_pct": 1.5,
    "zones": [
      {
        "classification": "classification",
        "area_ha": 1.5,
        "rate_multiplier": 1.5
      }
    ],
    "estimated_cost_savings": 1.5,
    "currency": "USD",
    "cost_basis": "cost_basis"
  },
  "irrigation": {
    "total_area_ha": 1.5,
    "grid_size_meters": 1,
    "flat_rate_units_ha": 1.5,
    "variable_rate_units_ha": 1.5,
    "savings_pct": 1.5,
    "zones": [
      {
        "classification": "classification",
        "area_ha": 1.5,
        "rate_multiplier": 1.5
      }
    ],
    "estimated_cost_savings": 1.5,
    "currency": "USD",
    "cost_basis": "cost_basis"
  }
}