ParseAPI Elevation API

Elevation at a point, a list of coordinates, or evenly along a path, in feet and meters.

GitHub OpenAPI

Operations 2

GET /elevation Elevation at a point, a list, or evenly along a path #
POST /elevation Elevation for a list or a sampled path in JSON #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/parseapi-com:parseapi-com-elevation-api"
All apis
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.

Get an API 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 Specification

parseapi-com-elevation-api-openapi.yml Raw ↑
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'