Skip to content
POST AI agent ready /v1/elevation/lookup

Elevation API - Get Altitude for Any Coordinates

Returns the elevation above sea level in meters for a given latitude and longitude. Supports single-point lookups and batch queries via the locations array parameter. Useful for terrain analysis, hiking apps, and flood risk assessment.

Parameters

number

Latitude of the location. Use with lng for single-point lookups.

number

Longitude of the location. Use with lat for single-point lookups.

array

Array of { lat, lng } objects for batch elevation lookups. Use instead of lat/lng for multiple points.

Code examples

curl -X POST https://api.botoi.com/v1/elevation/lookup \
  -H "Content-Type: application/json" \
  -d '{"lat":27.9881,"lng":86.925}'

When to use this API

Hiking and trail planning apps

Plot elevation profiles along a hiking route by querying multiple waypoints. Show total elevation gain and loss for a trail, and flag steep sections where the grade exceeds a configurable threshold.

Flood risk assessment

Compare the elevation of a property against nearby waterway elevations. Properties below a certain threshold relative to the nearest river or coast can be flagged as higher flood risk in insurance underwriting or real estate analysis.

Drone flight planning

Calculate terrain elevation along a drone flight path to maintain safe altitude above ground level. Combine with on-water detection to identify bodies of water that require different minimum altitudes.

Frequently asked questions

How accurate is the elevation data?
Elevation data is sourced from SRTM (Shuttle Radar Topography Mission) at approximately 30-meter resolution globally. Accuracy is within 10-16 meters vertically for most terrain types. Mountain peaks and deep valleys may have slightly higher variance.
Can I look up multiple points at once?
Yes. Pass an array of { lat, lng } objects in the locations parameter to get elevations for multiple points in a single request. The response returns an array of elevation results in the same order.
What unit is the elevation returned in?
Elevation is always returned in meters above mean sea level. The unit field confirms this. Convert to feet by multiplying by 3.28084.
Does this work for ocean locations?
The endpoint returns elevation data for land surfaces. For ocean locations, the elevation may return 0 or a negative value representing ocean floor depth, depending on the data source coverage.
What is the maximum batch size?
The locations array supports up to 100 coordinate pairs per request. For larger datasets, split them into multiple requests.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs