Virtual Agronomist API

An API that puts agronomic advice behind every farmer in your network

Bring tailored nutrient recommendations into the service your farmers already use

Virtual Agronomist's new API gives your organization a straightforward way to offer practical, tailored nutrient advice through the tools and relationships you already have. Your team stays in control of the farmer experience; we provide the agronomic intelligence behind it: nutrient plans today, with more advisory tools available on request.

More relevant advice

Give farmers recommendations calibrated to their crop, location and field information rather than a one-size-fits-all message.

Your service, enhanced

Bring expert guidance into your own app, platform or extension workflow while keeping your brand and farmer relationships at the centre.

A clear route to launch

Start with the crops and farmer journey that matter to you, then let your technical team connect to the API.

Ready to bring Virtual Agronomist to your platform?

Organisations already building on Virtual Agronomist

How it works

Choose the farmer experience

Decide where the advice will appear: in your digital product, through an adviser, or as part of an existing farmer programme.

Gather a few field details

Your existing platform collects the information about the crop and field, such as its location, soil status, and stage in the season.

Return a tailored plan

Virtual Agronomist processes those details and sends back a nutrient plan for you to present in a useful, farmer-friendly way.

For your technical team

The implementation details, including access and the interactive API reference, are ready when your developers are ready to explore them.

View technical docs Register for access

Technical details for implementation teams

The sections below are for the people building the integration. They explain how to create access, request a nutrient plan and work with the API.

Create a username and password on our API registration page. You will use those credentials to obtain a JWT access token from the API.

The Virtual Agronomist API enables your technical team to bring tailored nutrient recommendations into your own software, workflows or farmer-facing tools.

Today the public API exposes four core capabilities:

Endpoint	Method	Purpose
`/virtual-agronomist/v1/login`	`POST`	Exchange your email and password for a JWT bearer token
`/virtual-agronomist/v1/crops`	`GET`	List supported crops and their slugs
`/virtual-agronomist/v1/crops/{crop_slug}/tools`	`GET`	List supported tools for a crop
`/virtual-agronomist/v1/crops/{crop_slug}/nutrient-plan`	`POST`	Generate a nutrient plan for a specific crop

The interactive documentation is available here: api.isda-africa.com/virtual-agronomist/v1/docs

/docs, /openapi.json and /login are public. All crop and nutrient plan endpoints require a bearer token in the Authorization header.

curl -X POST "https://api.isda-africa.com/virtual-agronomist/v1/login" \
  -H "accept: application/json" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=YOUR_EMAIL&password=YOUR_PASSWORD"

The returned token should then be sent as:

Authorization: Bearer <token>

Tokens expire after 1 hour, so call /login again when you need a fresh token.

Each nutrient plan request includes:

a crop-specific input object,
at least one of coordinates, polygon, or soil_properties,
optional fertilisers,
optional max_basal_products from 1 to 3.

The API validates the request against the crop-specific schema shown in the interactive docs. Lowland rice requests also require the input.Rainfed_or_Irrigated field so the correct network can be selected.

Example request

curl -X POST "https://api.isda-africa.com/virtual-agronomist/v1/crops/maize/nutrient-plan" \
  -H "accept: application/json" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "coordinates": {
      "latitude": 6.9487309,
      "longitude": -0.4300185
    },
    "input": {
      "Yield_Now_User": 3
    },
    "fertilisers": [
      {
        "name": "Ammonium sulphate +24S",
        "n": 21,
        "p": 0,
        "k": 0,
        "price": 0.59,
        "category": "AMMONIUM_SULPHATE"
      },
      {
        "name": "NPK +5S +0.7Zn +0.5B",
        "n": 11,
        "p": 22,
        "k": 21,
        "price": 0.77,
        "category": "NPK_AN_BASED"
      },
      {
        "name": "Urea",
        "n": 46,
        "p": 0,
        "k": 0,
        "price": 0.98,
        "category": "NPK_UREA_BASED"
      }
    ],
    "max_basal_products": 3
  }'

Refer to the interactive docs for the exact schema definitions and response models.

If you want to generate a client or inspect the raw schema directly, use:

https://api.isda-africa.com/virtual-agronomist/v1/openapi.json

Explore Virtual Agronomist

Learn more about the product and the most common implementation questions.

Product overview FAQ