Point API

Everything at a latitude/longitude: elevation, country, state, district.

Give it a latitude and longitude, get back everything: elevation, and the country, state, and district that contain that point. One call instead of stitching /elevation and a reverse lookup together.

Out in the ocean, place fields come back null and elevation still returns. Lakes and rivers are not a special case, they belong to whatever country and state surround them. Only need elevation? /elevation stays the focused tool.

Lookup

GET

api.parseapi.com/point?lat={lat}&lon={lon}

Elevation, country, state, and district for a point

curl "https://api.parseapi.com/point?lat=36.0726&lon=-79.792" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "latitude": 36.0726,
  "longitude": -79.792,
  "country": "US",
  "country_name": "United States",
  "state": "NC",
  "state_name": "North Carolina",
  "district": "37081",
  "district_name": "Guilford",
  "elevation": 253,
  "elevation_ft": 830,
  "resolution": 30
}

Response fields

latitude: Input latitude
longitude: Input longitude
country: ISO2 country code (null over open ocean)
country_name: Country name
state: State / ADM1 code
state_name: State / ADM1 name
district: District code (US county FIPS, FR INSEE department, GB GSS, null elsewhere)
district_name: District / ADM2 name
elevation: Elevation in meters (null if unavailable)
elevation_ft: Elevation in feet (null if unavailable)
resolution: Approx elevation grid spacing in meters

Got a district code back? Resolve it at /district/{code}.

Deep

?deep=true adds the nearest city and its timezone. Free on every plan.

curl "https://api.parseapi.com/point?lat=36.0726&lon=-79.792&deep=true" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "latitude": 36.0726,
  "longitude": -79.792,
  "country": "US",
  "country_name": "United States",
  "state": "NC",
  "state_name": "North Carolina",
  "district": "37081",
  "district_name": "Guilford",
  "elevation": 253,
  "elevation_ft": 830,
  "resolution": 30,
  "deep": {
    "city": {
      "name": "Greensboro",
      "local_name": null,
      "state": "NC",
      "state_name": "North Carolina",
      "country": "US",
      "latitude": 36.09485,
      "longitude": -79.823624,
      "population": 307381,
      "timezone": "America/New_York",
      "distance": 3.77,
      "distance_mi": 2.34,
      "id": "city_q4pcrp9ayxn9"
    },
    "timezone": {
      "timezone": "America/New_York",
      "name": "Eastern Time",
      "abbreviation": "EDT",
      "offset": "-04:00",
      "offset_minutes": -240,
      "dst": true,
      "next_dst": {
        "at": "2026-11-01T06:00:00.000Z",
        "dst": false,
        "offset": "-05:00",
        "abbreviation": "EST"
      }
    }
  }
}

Deep fields

deep.city: Nearest city (same shape as /city?lat=&lon=, includes distance and distance_mi). Null when no city is within 200 km
deep.timezone: IANA timezone of the nearest city (same shape as /timezone/{timezone}). Null when no city resolves

Questions? Email