Endpoints

Soil API

The full soil profile for a single point in Nepal, plus the recommended fertilizer dose per crop and variety for that soil rating.

GET /soil/api/soildata

Try it

Query parameters

lat number query required

Decimal latitude in EPSG:4326, between 26.3 and 30.5. A coordinate outside Nepal returns 404. Example 28.5737.

lon number query required

Decimal longitude in EPSG:4326, between 80.0 and 88.2. Example 80.8068.

mode string query optional

Response format: json (default) or xml.

Response fields

coord object

The requested lat / lon echoed back (rounded to 3 dp) plus elevation in metres.

ph string

Soil pH at this point, with its rating in brackets, "7.69 (Low Alkaline)".

<property>_rating string

The rating on its own, for the seven classified properties (ph, organic_matter, total_nitrogen, potassium, p2o5, boron, zinc). Parse this rather than the bracketed text.

<property>_color string

A display hint used by the NARC map: red for High / Very High, #777 otherwise. Presentation only; ignore it if you are not rendering our UI.

organic_matter, total_nitrogen, sand, clay, slit string

Soil composition, percent by mass. Values carry their unit suffix.

boron, zinc string

Micronutrient concentration in ppm.

p2o5, potassium string

Macronutrients in kg/ha.

parentsoil string

Parent soil group, from the 1:100k national soil survey.

province, district, palika string

Administrative location for the point.

fertilizerData.<crop>.<variety> object

Recommended MOP, DAP and split urea doses plus organic manure, zinc and boron for the soil rating at this location. MOP, DAP and urea are kg per kattha; organic manure is t/ha, zinc and boron kg/ha. NA where a nutrient does not apply to the crop.

Try it

Pick a point in Nepal and call the live endpoint with your API key. The call counts against your key's allowance.

Latitude Longitude

API key

Sent as X-API-Key for this request only. How to get one.

Request

curl -G https://soil.narc.gov.np/soil/api/soildata \
  -H "X-API-Key: $NARC_API_KEY" \
  -d lat=28.5737 \
  -d lon=80.8068

// Server side (Node 18+): never ship a key to the browser.
const base = 'https://soil.narc.gov.np/soil/api/soildata';

const res = await fetch(`${base}?lat=28.5737&lon=80.8068`, {
  headers: { 'X-API-Key': process.env.NARC_API_KEY },
});
const data = await res.json();

console.log(data.ph);

import os
import requests

res = requests.get(
    "https://soil.narc.gov.np/soil/api/soildata",
    params={"lat": 28.5737, "lon": 80.8068},
    headers={"X-API-Key": os.environ["NARC_API_KEY"]},
    timeout=10,
)
res.raise_for_status()

print(res.json()["ph"])

Response

{
  "coord": {
    "lon": 80.807,
    "lat": 28.574,
    "elevation": 1.72
  },
  "ph": "7.69 (Low Alkaline)",
  "ph_rating": "Low Alkaline",
  "ph_color": "#777",
  "organic_matter": "1.67 % (Medium)",
  "organic_matter_rating": "Medium",
  "organic_matter_color": "#777",
  "total_nitrogen": "0.08 % (Medium)",
  "potassium": "198.02 kg/ha (Medium)",
  "p2o5": "38.9 kg/ha (Medium)",
  "boron": "0.14 ppm (Low)",
  "zinc": "0.42 ppm (Very Low)",
  "sand": "29.96 %",
  "clay": "16.54 %",
  "slit": "55.51 %",
  "parentsoil": "Fluvial non calcareous",
  "province": "Sudurpaschim",
  "district": "Kailali",
  "palika": "Kailari Gaunpalika",
  "fertilizerData": {
    "Rice": {
      "OPV": {
        "MOP": "1.67",
        "DAP": "2.17",
        "UREA1": "1.57",
        "UREA2": "2.42",
        "UREA3": "2.42",
        "organic": "6",
        "zinc": "2",
        "boron": "1"
      }
    }
  }
}

{
  "result": "Invalid latitude or longitude"
}

{
  "result": "Please select the crop land"
}

{
  "result": "Underlying raster read failed"
}