Farm Data
Ground‑truth about a farmer's land, crops, and production history — the core signal for agtechs and insurers. Includes GPS boundaries, crop calendar, soil/irrigation, NDVI satellite vegetation data, risk score, and harvest/yield history.
| Section key | Fee (NGN) | Available to |
|---|---|---|
farms |
40 | insurer, agtech |
Request
curl -X POST https://api.riwe.io/v1/rupa/lookup \
-H "X-API-KEY: rk_live_YOUR_SECRET" \
-H "Content-Type: application/json" \
-d '{ "rupa_id": "rp-7lif9u", "sections": ["farms"] }'
Response
farms is an array — a farmer may have multiple registered farms.
"farms": [
{
"farm_id": 238,
"name": "Home plot",
"state": "Benue",
"city": "Gboko",
"latitude": 7.7331,
"longitude": 8.5219,
"boundary_coordinates": [[7.7331, 8.5219], [7.7335, 8.5222], "..."],
"area_hectares": 2.5,
"ownership_type": "owned",
"primary_crop": "Rice",
"secondary_crops": ["Maize"],
"planting_date": "2026-05-01",
"expected_harvest_date": "2026-09-15",
"soil_type": "loam",
"irrigation_access": false,
"ndvi": {
"data": { "latest": 0.62, "series": [] },
"updated_at": "2026-06-30T00:00:00+00:00"
},
"climate_exposure": { "drought_risk": "medium" },
"risk_score": 41,
"prior_crop_loss_history": [],
"harvest_intakes": [
{ "recorded_at": "2026-01-20", "commodity": "Rice", "quantity": 1800, "unit": "kg", "total_value": 540000 }
],
"yields": [
{ "harvest_date": "2025-10-02", "quantity": 1650, "unit": "kg", "quality_rating": "A" }
]
}
]
Fields
| Field | Description |
|---|---|
farm_id, name |
Farm identifier and label |
state, city |
Location |
latitude, longitude |
Centre point of the farm |
boundary_coordinates |
GPS polygon of the plot (array of [lat, lng]) |
area_hectares |
Plot size |
ownership_type |
e.g. owned, leased, communal |
primary_crop, secondary_crops |
What's grown |
planting_date, expected_harvest_date |
Crop calendar |
soil_type, irrigation_access |
Agronomic attributes |
ndvi |
Satellite vegetation index — data (latest + series) and updated_at |
climate_exposure |
Climate/weather risk exposure signals |
risk_score |
Riwe's composite farm risk score |
prior_crop_loss_history |
Recorded past losses |
harvest_intakes |
Recent recorded harvest intakes (up to 10): commodity, quantity, unit, value |
yields |
Recent yields (up to 10): date, quantity, unit, quality rating |
Typical uses
- Agtech — verify a farmer's plot and crop before offering inputs or advisory; track productivity over seasons.
- Insurer — assess a plot for parametric/area‑yield cover using boundaries, NDVI, soil, and loss history (pair with Insurance & Underwriting).