Open API for states and partners

Everything the app does is available as a documented, versioned API — free to call, and free to host yourself under the Apache-2.0 licence.

OpenAPI specification

Digital public good principles

Open source and open standards (Apache-2.0, OpenAPI 3.1, JSON Schema)
Open data inputs: NASA POWER, Open-Meteo, ISRIC SoilGrids, MODIS
Privacy by design: no personal data stored; locations rounded to ~10 km
Federation-ready: states can host their own instance and share model cards

Try it

curl -X POST https://<your-host>/api/v1/simulate \
  -H "Content-Type: application/json" \
  -d '{
    "place": { "name": "Malihabad", "state": "Uttar Pradesh", "lat": 26.92, "lon": 80.71 },
    "sowingDate": "2026-11-05",
    "cropId": "mustard",
    "water": "limited",
    "lang": "hi"
  }'

Endpoints

Places

get/api/v1/placesSearch villages, towns and districts in India
get/api/v1/places/reverseName the place at a GPS coordinate

Field intelligence

get/api/v1/contextWeather, soil and satellite context for a field

Crop model

post/api/v1/simulateSimulate one crop's season day by day until harvest
post/api/v1/recommendRank sowable crops for a field and explain the choice
get/api/v1/recommendations/{id}Fetch a saved recommendation (shareable link)

Crop health

post/api/v1/diagnoseDiagnose a crop problem from a photo
post/api/v1/soil-cardRead a Soil Health Card photo into structured values

Assistant

post/api/v1/chatAsk Kisan Mitra by text or voice
post/api/v1/speakSpeak a text aloud (WAV)

Model registry

get/api/v1/modelsList published crop models (national + state calibrations)
get/api/v1/models/{id}Get one crop model card

Schemes

get/api/v1/schemesList central farmer schemes
post/api/v1/schemes/eligibilityCheck scheme eligibility with explained rules

Markets

get/api/v1/pricesMSP and indicative prices used by the model

Network

get/api/v1/network/summaryAnonymised network activity and disease surveillance

Operations

get/api/healthLiveness and configuration check