Elevation and Slope API: height above sea level of a plot

Example

Request

curl -X POST https://verified.realestate/api/v1/tools/elevation \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":12.901,"lng":80.2279}'

Responsereal answer

{
  "ok": true,
  "status": "ok",
  "data": {
    "found": true,
    "elevation_m": 9,
    "slope_deg": 1.9,
    "slope_pct": 3.3,
    "slope_band": "gentle",
    "aspect_deg": 180,
    "aspect_compass": "S",
    "neighbors_m": {
      "north": 9,
      "south": 7,
      "east": 9,
      "west": 9
    },
    "note": "Copernicus 90 m DEM figures; slope from a 30 m grid. State the elevation and slope plainly; for aspect say which way the ground falls. Below ~5 m near the coast deserves a flood-risk mention (offer the flood zone check). For the full terrain/soil/geology report offer geo_insights."
  },
  "credits_charged": 0
}

A real answer from the API (22 Oct 2026).

What it returns

One call, one point. found is false (status not_found) when the elevation service does not answer.

Field	What it holds
`elevation_m`	Height above sea level at the point, in metres.
`slope_deg, slope_pct`	The ground slope, in degrees and in percent.
`slope_band`	flat (under 1 degree), gentle (1 to 3), moderate (3 to 8) or steep (8 and over).
`aspect_deg, aspect_compass`	The direction the ground falls, in degrees from north and as a compass point (N, NE, E ...). Null on flat ground.
`neighbors_m`	The heights about 30 metres north, south, east and west, in metres.
`note`	How to read the figures.

Inputs

The JSON body of the POST is the arguments. Both are required. resolve_parcel gives a point inside any Tamil Nadu plot.

Argument	Type	What to send
`lat`required	number	Latitude in decimal degrees.
`lng`required	number	Longitude in decimal degrees.

Code

Set LANDLENS_KEY to your key. In an AI app, connect https://verified.realestate/mcp once and ask in plain words instead. In Postman, download this API's collection, import it (File, Import) and set apiKey.

curl -X POST https://verified.realestate/api/v1/tools/elevation \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":12.901,"lng":80.2279}'

import os, requests

r = requests.post(
    "https://verified.realestate/api/v1/tools/elevation",
    headers={"Authorization": f"Bearer {os.environ['LANDLENS_KEY']}"},
    json={
        "lat": 12.901,
        "lng": 80.2279
    },
    timeout=20,
)
body = r.json()
print(body["status"], body["credits_charged"], body["data"])

const res = await fetch("https://verified.realestate/api/v1/tools/elevation", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LANDLENS_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "lat": 12.901,
    "lng": 80.2279
  }),
});
const body = await res.json();
console.log(body.status, body.credits_charged, body.data);

How high above sea level is the land at 12.9010, 80.2279, and which way does it slope?

Your AI reads the height and slope at the point. It is free.

Responses

Every answer has the same envelope. What status can say for this call:

status	What it means
`ok`	The height and slope were read.
`not_found`	The elevation service did not answer. Try again in a moment.
`invalid_args`	lat or lng is missing.
`free_limit_reached`	The account has used its free calls for the hour or the day. retry_after says how many seconds to wait; paid calls keep working.

Where the data comes from

Register

The Copernicus digital elevation model, a global model of ground height at about 90 metre resolution, read through a public elevation service.

Coverage

Any point on land, in Tamil Nadu or elsewhere.

How current

The elevation model is a fixed survey of the terrain; it does not change with time. Recent earthworks, buildings and filling are not in it.

How we read it

The height is read at the point and at four points about 30 metres north, south, east and west of it. Slope and the direction of fall are worked out from those four heights. Below half a degree of slope no direction is given.

Who uses it

Buyers

See whether a plot sits low before buying in a flood-prone area, and ask the right questions about drainage.

Builders and engineers

Get the fall of a site before planning its drainage, plinth level and earthwork.

Analysts

Add height and slope to every parcel in a study at no cost.

Limits and good practice

The model's cells are about 90 metres across. It shows the lie of the land, not the level of one plot; a site level survey is still needed for design.
Buildings, filled plots and recent earthworks are not in the model.
Near the coast, a height under about 5 metres is a reason to check the flood zone too.

Pricing

Free

The elevation API costs nothing. Free calls have their own allowance per hour and per day. Credits come from the same LandLens wallet as the chat and the minis. How billing works.

Calling at volume?

Free calls have an hourly and daily allowance. For more than that, or a platform built on these registers, we set up limits and a plan to match.

WhatsApp 99961 29996