ParseAPI Elevation API
Elevation at a point, a list of coordinates, or evenly along a path, in feet and meters.
Elevation at a point, a list of coordinates, or evenly along a path, in feet and meters.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/parseapi-com:parseapi-com-elevation-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Parse Elevation API
version: 1.0.0
summary: Fast APIs for developers, locate, validate, decode.
description: 'One base URL, one key, minimal JSON. Response schemas describe API 2.3.0. Paid plans include their profile detail automatically at its natural resource homes; Free returns the complete ordinary answer. There is no deep response object. When neither version header is sent, requests use the saved team default, or 1.0.0 for keyless self-lookups. Read https://parseapi.com/docs/versioning for other supported contracts. Responses that reach the organization rate check carry X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. Optional X-RateLimit-Burst indicates continuous refill. Rate-limit 429 responses add Retry-After (seconds). See https://parseapi.com/agents and https://parseapi.com/llms.txt for agent-oriented guidance. Field-level docs: https://parseapi.com/docs Free-plan users must include a link to ParseAPI on their website, app, or project documentation. A footer, about page, credits page, or another reasonable location is fine. Paid plans do not require ParseAPI attribution. Example HTML: Data provided by ParseAPI. Details: https://parseapi.com/legal/attribution#crediting-parseapi.'
termsOfService: https://parseapi.com/legal/terms
contact:
name: ParseAPI
email: hello@parseapi.com
url: https://parseapi.com
servers:
- url: https://api.parseapi.com
description: Production
tags:
- name: Elevation
description: Elevation at a point, a list of coordinates, or evenly along a path, in feet and meters.
externalDocs:
description: Elevation API docs
url: https://parseapi.com/docs/elevation
paths:
/elevation:
get:
operationId: elevation
tags:
- Elevation
summary: Elevation at a point, a list, or evenly along a path
description: 'Pass lat and lon for one point, points for a list, or path with samples for an evenly sampled path. Do not combine them. samples is required with path and invalid without it. A single lookup returns one elevation object; a list or path returns an ordered points array. Each request uses one pooled request on every plan. Full field reference: https://parseapi.com/docs/elevation'
security:
- ApiKeyAuth: []
- BearerAuth: []
parameters:
- $ref: '#/components/parameters/ParseVersion'
- name: format
in: query
required: false
description: 'json by default. geojson returns application/geo+json: a Point Feature for lat/lon, or an ordered FeatureCollection for points and path. The same limits and request allowance apply. Available in API 2.0.0.'
schema:
type: string
enum:
- json
- geojson
default: json
- name: lat
in: query
required: false
description: Latitude. Required unless points or path is set.
schema:
type: number
minimum: -90
maximum: 90
example: 45.5
- name: lon
in: query
required: false
description: Longitude. Required unless points or path is set.
schema:
type: number
minimum: -180
maximum: 180
example: -122.7
- name: points
in: query
required: false
description: 'lat,lon pairs separated by a pipe, or enc: followed by a Google encoded polyline at precision 5. At most 512 points and 12000 characters. URL-encode the value and omit lat and lon. POST /elevation with a JSON points array when the list does not fit in the URL; the 512-point limit still applies.'
schema:
type: string
minLength: 1
maxLength: 12000
description: 'lat,lon pairs separated by |, or enc: followed by a Google encoded polyline at precision 5. At most 512 decoded points.'
example: 39.7392,-104.9903|40.71,-74.01
- name: path
in: query
required: false
description: Ordered path vertices. Requires samples. Omit lat, lon and points. The returned points are evenly spaced by cumulative great-circle distance, including endpoints. Repeated vertices are supported; an all-identical path returns repeated coordinates.
schema:
type: string
minLength: 1
maxLength: 12000
description: 'A path of 2-512 ordered vertices as lat,lon pairs separated by |, or an enc: polyline at precision 5. Segments follow shortest great-circle arcs. Antipodal segments are invalid.'
example: 39.7392,-104.9903|40.71,-74.01
- name: samples
in: query
required: false
description: Number of results along path, including both endpoints. Required only with path; no default.
schema:
type: integer
minimum: 2
maximum: 512
example: 65
responses:
'200':
description: Success, minimal JSON object (shape varies by endpoint)
headers:
X-RateLimit-Limit:
description: Sustained requests per minute for your team
schema:
type: integer
X-RateLimit-Remaining:
description: Estimated requests available in the current window or token bucket
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
schema:
type: integer
X-RateLimit-Burst:
description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
schema:
type: integer
X-API-Version:
description: The exact response contract selected for this request.
schema:
type: string
enum:
- 1.0.0
- 2.0.0
- 2.1.0
- 2.2.0
- 2.3.0
content:
application/json:
schema:
oneOf:
- type: object
required:
- latitude
- longitude
- elevation
- elevation_ft
- resolution
properties:
latitude:
type: number
minimum: -90
maximum: 90
longitude:
type: number
minimum: -180
maximum: 180
elevation:
type:
- integer
- 'null'
description: Meters relative to the EGM2008 geoid. Negative below that reference; null when unavailable.
elevation_ft:
type:
- integer
- 'null'
description: Feet relative to the EGM2008 geoid. Negative below that reference; null when unavailable.
resolution:
type:
- integer
- 'null'
description: Approximate horizontal grid spacing in meters, not vertical accuracy.
- type: object
required:
- points
properties:
points:
type: array
minItems: 1
maxItems: 512
items:
type: object
required:
- latitude
- longitude
- elevation
- elevation_ft
- resolution
properties:
latitude:
type: number
minimum: -90
maximum: 90
longitude:
type: number
minimum: -180
maximum: 180
elevation:
type:
- integer
- 'null'
description: Meters relative to the EGM2008 geoid. Negative below that reference; null when unavailable.
elevation_ft:
type:
- integer
- 'null'
description: Feet relative to the EGM2008 geoid. Negative below that reference; null when unavailable.
resolution:
type:
- integer
- 'null'
description: Approximate horizontal grid spacing in meters, not vertical accuracy.
description: For points, one result per input coordinate in the same order. Duplicate coordinates retain their positions. For path, exactly samples evenly spaced results along the path, including both endpoints.
application/geo+json:
schema:
oneOf:
- type: object
required:
- type
- geometry
- properties
properties:
type:
type: string
const: Feature
geometry:
type: object
required:
- type
- coordinates
properties:
type:
type: string
const: Point
coordinates:
type: array
minItems: 2
maxItems: 2
prefixItems:
- type: number
minimum: -180
maximum: 180
- type: number
minimum: -90
maximum: 90
items: false
description: '[longitude, latitude] in WGS84. Height stays in properties because its reference is EGM2008, not ellipsoid altitude.'
properties:
type: object
required:
- elevation
- elevation_ft
- resolution
properties:
elevation:
type:
- integer
- 'null'
description: Meters relative to the EGM2008 geoid. Negative below that reference; null when unavailable.
elevation_ft:
type:
- integer
- 'null'
description: Feet relative to the EGM2008 geoid. Negative below that reference; null when unavailable.
resolution:
type:
- integer
- 'null'
description: Approximate horizontal grid spacing in meters, not vertical accuracy.
- type: object
required:
- type
- features
properties:
type:
type: string
const: FeatureCollection
features:
type: array
minItems: 1
maxItems: 512
items:
type: object
required:
- type
- geometry
- properties
properties:
type:
type: string
const: Feature
geometry:
type: object
required:
- type
- coordinates
properties:
type:
type: string
const: Point
coordinates:
type: array
minItems: 2
maxItems: 2
prefixItems:
- type: number
minimum: -180
maximum: 180
- type: number
minimum: -90
maximum: 90
items: false
description: '[longitude, latitude] in WGS84. Height stays in properties because its reference is EGM2008, not ellipsoid altitude.'
properties:
type: object
required:
- elevation
- elevation_ft
- resolution
properties:
elevation:
type:
- integer
- 'null'
description: Meters relative to the EGM2008 geoid. Negative below that reference; null when unavailable.
elevation_ft:
type:
- integer
- 'null'
description: Feet relative to the EGM2008 geoid. Negative below that reference; null when unavailable.
resolution:
type:
- integer
- 'null'
description: Approximate horizontal grid spacing in meters, not vertical accuracy.
description: One Point Feature per returned sample, in the same order, including duplicates and null heights. A path returns exactly samples features, including endpoints.
'400':
description: invalid_request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: invalid_api_key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: permission_denied or plan_required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: not_found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'410':
description: api_version_retired
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: rate_limited or quota_exceeded
headers:
X-RateLimit-Limit:
description: Sustained requests per minute for your team
schema:
type: integer
X-RateLimit-Remaining:
description: Estimated requests available in the current window or token bucket
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
schema:
type: integer
X-RateLimit-Burst:
description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
schema:
type: integer
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: server_error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: service_unavailable
headers:
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
operationId: elevation_points_post
tags:
- Elevation
summary: Elevation for a list or a sampled path in JSON
description: 'Send 1-512 coordinates in points, or 2-512 vertices in path with an integer samples count from 2 to 512. Each pair is [latitude, longitude]. A pipe-separated string or enc: polyline at precision 5 is also accepted, limited to 12000 characters. Choose exactly one mode and put all selectors in the body. A path returns exactly samples results at uniform cumulative great-circle distances, including endpoints; antipodal segments are invalid. Each list or path uses one pooled request on every plan. Full field reference: https://parseapi.com/docs/elevation'
security:
- ApiKeyAuth: []
- BearerAuth: []
parameters:
- $ref: '#/components/parameters/ParseVersion'
- name: format
in: query
required: false
description: 'json by default. geojson returns application/geo+json: a Point Feature for lat/lon, or an ordered FeatureCollection for points and path. The same limits and request allowance apply. Available in API 2.0.0.'
schema:
type: string
enum:
- json
- geojson
default: json
requestBody:
required: true
content:
application/json:
schema:
oneOf:
- type: object
required:
- points
additionalProperties: false
properties:
points:
oneOf:
- type: array
minItems: 1
maxItems: 512
items:
type: array
minItems: 2
maxItems: 2
prefixItems:
- type: number
minimum: -90
maximum: 90
- type: number
minimum: -180
maximum: 180
items: false
- type: string
minLength: 1
maxLength: 12000
description: 'lat,lon pairs separated by |, or enc: followed by a Google encoded polyline at precision 5. At most 512 decoded points.'
example: 39.7392,-104.9903|40.71,-74.01
- type: object
required:
- path
- samples
additionalProperties: false
properties:
path:
oneOf:
- type: array
minItems: 2
maxItems: 512
items:
type: array
minItems: 2
maxItems: 2
prefixItems:
- type: number
minimum: -90
maximum: 90
- type: number
minimum: -180
maximum: 180
items: false
- type: string
minLength: 1
maxLength: 12000
description: 'A path of 2-512 ordered vertices as lat,lon pairs separated by |, or an enc: polyline at precision 5. Segments follow shortest great-circle arcs. Antipodal segments are invalid.'
example: 39.7392,-104.9903|40.71,-74.01
samples:
type: integer
minimum: 2
maximum: 512
example: 65
example:
path:
- - 39.74
- -104.99
- - 39.74
- -105.63
samples: 65
responses:
'200':
description: Success, minimal JSON object (shape varies by endpoint)
headers:
X-RateLimit-Limit:
description: Sustained requests per minute for your team
schema:
type: integer
X-RateLimit-Remaining:
description: Estimated requests available in the current window or token bucket
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
schema:
type: integer
X-RateLimit-Burst:
description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
schema:
type: integer
X-API-Version:
description: The exact response contract selected for this request.
schema:
type: string
enum:
- 1.0.0
- 2.0.0
- 2.1.0
- 2.2.0
- 2.3.0
content:
application/json:
schema:
type: object
required:
- points
properties:
points:
type: array
minItems: 1
maxItems: 512
items:
type: object
required:
- latitude
- longitude
- elevation
- elevation_ft
- resolution
properties:
latitude:
type: number
minimum: -90
maximum: 90
longitude:
type: number
minimum: -180
maximum: 180
elevation:
type:
- integer
- 'null'
description: Meters relative to the EGM2008 geoid. Negative below that reference; null when unavailable.
elevation_ft:
type:
- integer
- 'null'
description: Feet relative to the EGM2008 geoid. Negative below that reference; null when unavailable.
resolution:
type:
- integer
- 'null'
description: Approximate horizontal grid spacing in meters, not vertical accuracy.
description: For points, one result per input coordinate in the same order. Duplicate coordinates retain their positions. For path, exactly samples evenly spaced results along the path, including both endpoints.
application/geo+json:
schema:
type: object
required:
- type
- features
properties:
type:
type: string
const: FeatureCollection
features:
type: array
minItems: 1
maxItems: 512
items:
type: object
required:
- type
- geometry
- properties
properties:
type:
type: string
const: Feature
geometry:
type: object
required:
- type
- coordinates
properties:
type:
type: string
const: Point
coordinates:
type: array
minItems: 2
maxItems: 2
prefixItems:
- type: number
minimum: -180
maximum: 180
- type: number
minimum: -90
maximum: 90
items: false
description: '[longitude, latitude] in WGS84. Height stays in properties because its reference is EGM2008, not ellipsoid altitude.'
properties:
type: object
required:
- elevation
- elevation_ft
- resolution
properties:
elevation:
type:
- integer
- 'null'
description: Meters relative to the EGM2008 geoid. Negative below that reference; null when unavailable.
elevation_ft:
type:
- integer
- 'null'
description: Feet relative to the EGM2008 geoid. Negative below that reference; null when unavailable.
resolution:
type:
- integer
- 'null'
description: Approximate horizontal grid spacing in meters, not vertical accuracy.
description: One Point Feature per returned sample, in the same order, including duplicates and null heights. A path returns exactly samples features, including endpoints.
'400':
description: invalid_request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: invalid_api_key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: permission_denied or plan_required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: not_found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'410':
description: api_version_retired
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: rate_limited or quota_exceeded
headers:
X-RateLimit-Limit:
description: Sustained requests per minute for your team
schema:
type: integer
X-RateLimit-Remaining:
description: Estimated requests available in the current window or token bucket
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
schema:
type: integer
X-RateLimit-Burst:
description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
schema:
type: integer
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: server_error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: service_unavailable
headers:
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
parameters:
ParseVersion:
name: X-API-Version
in: header
required: false
description: Exact response contract for this lookup. Overrides the saved team default for this request only. Legacy Parse-Version is also accepted; both headers must match if sent together. With neither header, keyed requests use that default and keyless self-lookups use 1.0.0. Invalid or unsupported values return invalid_request (400). Retired selections return api_version_retired (410). Reference/help URLs keep their documented version and do not use this selector.
schema:
type: string
enum:
- 1.0.0
- 2.0.0
- 2.1.0
- 2.2.0
- 2.3.0
example: 2.3.0
schemas:
Error:
type: object
required:
- code
- message
- docs
- request_id
properties:
code:
type: string
description: Machine-readable error code
enum:
- invalid_request
- ambiguous_time
- nonexistent_time
- invalid_api_key
- permission_denied
- plan_required
- not_found
- api_version_retired
- rate_limited
- quota_exceeded
- server_error
- service_unavailable
- dns_resolution_failed
- task_invalid
- task_not_found
- task_request_conflict
- task_budget_exceeded
- task_limit_exceeded
- task_terms_changed
- task_expired
- task_cancelled
- task_in_progress
- task_outcome_unknown
- task_unavailable
message:
type: string
docs:
type: string
format: uri
description: Link to the docs section for this error
request_id:
type: string
description: Send this if you contact support
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: API key from the ParseAPI dashboard
BearerAuth:
type: http
scheme: bearer
description: 'Same key as X-API-Key, via Authorization: Bearer'