Skip to content

50,000 free calls a month, card-free. Get an API key →

Documentation menu
docs / api / post-elevation
elevation

POST/elevation

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

Call it

bash
curl -fsS -X POST "https://api.mapmap.ai/elevation" \
  -H "Authorization: Bearer $MAPMAP_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Request body

application/json

{"points": [{"lat", "lon"}, …]}, at most 500 points

The OpenAPI document declares this body as a free-form JSON object with no field list, so there is nothing here to generate a table from. The prose above is what the gateway states about it; the raw document is the authority.

Responses

200{"results": [{"lat", "lon", "elevation_m", "source", "resolution_m"}, …]}, one entry per input point in order; elevation_m/source/resolution_m are null together wherever the engine has no DEM coverage
400Invalid request
401Missing or invalid API key
429Quota or rate limit exceeded
501Elevation not enabled on this deployment (SN_ELEVATION_ENABLED unset; the hosted gateway sets it true; this is a self-hosting gate for a Valhalla with no DEM tiles staged)
502Upstream routing engine failed

Error bodies follow the shared problem model documented on API conventions.

Also under elevation

Generated from https://api.mapmap.ai/openapi.json on 2026-09-17 · operationId post_elevation