# Elevation API
> Terrain elevation in metres above sea level for any coordinate — a single point or a batch of up to 50 points for route and grid profiles. Ideal for hiking and outdoor apps, mapping, drone flight planning, solar siting, flood and line-of-sight analysis.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/elevation-api/..."
```

## Pricing
- **Free** (Free) — 2,000 calls/Mo, 2 req/s
- **Basic** ($11/Mo) — 120,000 calls/Mo, 8 req/s
- **Pro** ($34/Mo) — 600,000 calls/Mo, 25 req/s
- **Mega** ($89/Mo) — 2,500,000 calls/Mo, 80 req/s

## Endpoints

### Elevation

#### `GET /v1/elevation` — Elevation for one point

**Parameters:**
- `lat` (query, required, string) — Latitude Example: `27.988`
- `lon` (query, required, string) — Longitude Example: `86.925`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/elevation-api/v1/elevation?lat=27.988&lon=86.925"
```

**Response:**
```json
{
    "data": {
        "unit": "meters",
        "latitude": 27.988,
        "longitude": 86.925,
        "elevation_m": 8771
    },
    "meta": {
        "timestamp": "2026-05-30T05:50:02.606Z",
        "request_id": "b5f7f90f-d923-4ae8-b387-0ba576aebfea"
    },
    "status": "ok",
    "message": "Elevation retrieved",
    "success": true
}
```

#### `GET /v1/path` — Elevations for many points

**Parameters:**
- `points` (query, required, string) — lat,lon|lat,lon (max 50) Example: `52.516,13.377|48.858,2.294`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/elevation-api/v1/path?points=52.516%2C13.377%7C48.858%2C2.294"
```

**Response:**
```json
{
    "data": {
        "unit": "meters",
        "count": 2,
        "results": [
            {
                "latitude": 52.516,
                "longitude": 13.377,
                "elevation_m": 36
            },
            {
                "latitude": 48.858,
                "longitude": 2.294,
                "elevation_m": 49
            }
        ]
    },
    "meta": {
        "timestamp": "2026-05-30T05:50:04.476Z",
        "request_id": "6f74fd8e-f9e5-4b7f-bde9-8514ab27c0ff"
    },
    "status": "ok",
    "message": "Elevations retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/elevation-api
OpenAPI spec: https://www.oanor.com/api/elevation-api/openapi.json