Elevation

Elevation along a path

Generated from OpenAPI
POST
/elevation

Samples surface elevation at each supplied coordinate from Copernicus DEM GLO-30 (EGM2008). The surface model includes vegetation and buildings; it is not surveyed road height.

Cost: 1 credit per 100 points.

Authorization

apiKey
headerAuthorizationBearer <token>

Send your key as Authorization: Bearer sk_live_….

Secret keys (sk_) are for server-side use and must never be exposed in a browser or a mobile binary. Browser or mobile use of secret keys is unsupported. Use your server to call these endpoints.

Request Body

application/json
  1. body
coordinates*array<array<any>>

Points to sample, in order.

Items1 <= items <= 1000

Response Body

Elevations in metres above sea level, in the order supplied.

application/json
  1. response

Fields present on every successful response.

request_id*string

Unique id for this request. Quote it in any support conversation.

Lengthlength <= 64
Example"req_01JBQ7Z9Y4K2M3N4P5Q6R7S8T9"
credits_charged*integer

Credits deducted from the account balance for this request.

Range0 <= value
Example1
data_version*string

The data release that answered this request.

Lengthlength <= 32
Example"2026-09-02T03"
elevations_m*array<|>

Metres above sea level, in the order the coordinates were supplied. A null means the point falls outside our elevation coverage.

Itemsitems <= 1000
curl -X POST 'https://api.uat.audisory.com/v1/elevation' \  -H 'Authorization: Bearer YOUR_API_KEY' \  -H 'Content-Type: application/json' \  -d '{  "coordinates": [    [      30.0619,      -1.9441    ],    [      30.09,      -1.937    ],    [      30.122,      -1.942    ]  ]}'
{  "request_id": "req_01JBQ7Z9Y4K2M3N4P5Q6R7S8TC",  "credits_charged": 1,  "data_version": "2026-09-02T03",  "elevations_m": [    1567,    1489,    1442  ]}

Try this API in your console playground →