NewAPIVerve Academy: free courses and certifications anyone can verify.Explore the Academy →

Reverse Geocode API

GET

Resolve raw coordinates to US and Canadian cities and ZIP codes.

Reverse Geocode converts latitude and longitude coordinates into US, Canada and Australia location details. Pass geographic coordinates to retrieve the corresponding city, state, postal code, country code, time zone and US county. Paid plans can add the point's geohash, plus code and degrees-minutes-seconds notation.

Try it — live request, no key required

Request
GETapi.apiverve.com/v1/reversegeocode?lat=40.714224&lon=-73.961452
Query parameters
Verification
Format

No key required to try it. Get a key to use it in your app.

Example
{
  "status": "ok",
  "error": null,
  "data": {
    "zipcode": "11211",
    "state_abbr": "NY",
    "city": "Brooklyn",
    "state": "New York",
    "distance": 0.6501757300758664,
    "latitudeClosest": "40.712090",
    "longitudeClosest": "-73.95427",
    "countryCode": "US",
    "latitude": 40.714224,
    "longitude": -73.961452,
    "estimatedCity": true,
    "nearestCities": [
      "Brooklyn",
      "Brooklyn Park",
      "East Brooklyn",
      "Brooklyn Center",
      "Brooklyn Heights"
    ],
    "timezone": "America/New_York",
    "county": "Kings County",
    "countyFips": "36047",
    "geocodes": {
      "geohash": "dr5rsgyct",
      "plusCode": "87G8P27Q+MC",
      "dms": {
        "latitude": "40°42'51.2\"N",
        "longitude": "73°57'41.2\"W"
      }
    }
  }
}

About the Reverse Geocode API

A reverse geocoding API for US, Canadian and Australian coordinates. Send a latitude and longitude and get back the nearest city, state or province, the ZIP or postal code and the country code, so you can get city from coordinates or convert coordinates to location details without a mapping SDK. It returns a place, not a street address: the answer is the closest known postal location to the point you sent.

Apps use it to label GPS coordinates in check-ins and delivery logs, find state from lat long for tax or compliance rules, fill in city and ZIP fields from a phone's location, and group sensor or fleet data by area. Each response also echoes the coordinates you sent.

The Free plan returns the city, state, state abbreviation, ZIP or postal code and country code. Paid plans add the coordinates of the matched location and its distance from your point, an estimated-city flag, and a list of the nearest city names ordered by distance.

How it works

Lookup runs in two steps, both against bundled offline data. First the point given by lat and lon is placed in a country using country boundary polygons. Then the nearest entry in a US, Canada and Australia postal location dataset is found for that country, and its city, state, state_abbr and zipcode are returned. Coordinates in any other country are outside the dataset and are not supported.

Results are only as fine-grained as the dataset: the answer is the closest postal-code location, not the containing boundary, so points near a town or ZIP line can resolve to the neighbouring one. latitudeClosest and longitudeClosest are the matched location's coordinates, returned as strings, and distance is how far it lies from your point. latitude and longitude echo the input and countryCode is the two-letter code from the first step.

nearestCities holds up to 20 unique city names from a worldwide city list, ordered by distance from your point, closest first, so it usually starts with the city you are in and continues with its neighbours. distance, the closest coordinates, estimatedCity and nearestCities are null on the Free plan.

What people use it for

Fleet Telematics Tracking
Logistics systems match vehicle GPS pings against city and state boundaries to generate human-readable trip summaries for dispatchers.
Mobile Photo Geotagging
Camera apps read coordinate metadata from uploaded photos to display the city and state where each picture was taken.
Delivery Address Autofill
When a customer shares device coordinates at checkout, ecommerce apps automatically populate the city, state, and ZIP code fields.
Field Service Dispatch
To assign incoming repair tickets, maintenance platforms convert technician coordinates into local municipality names and postal codes.

See it in action

The Reverse Geocode API in one live call, from the Playground to your own code.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON
Default REST response
XML
Markup format
YAML
Human-readable
CSV
Tabular export
Beta
GraphQL
Query language
New
MCP
For AI agents

Other ways to use Reverse Geocode

Same data, same APIVerve account, same credit balance — one key works on all of them.

Questions.

Common questions about the Reverse Geocode API.

Read the docs →
Does Reverse Geocode work for coordinates outside the US, Canada and Australia?
No. The API supports coordinates within the United States, Canada and Australia. Coordinates from other countries return a 404. For Australian points, region can be empty or a locality label.
How far does the Starter plan go for reverse geocoding lookups?
Each lookup consumes 6 credits. The Starter plan provides 200,000 monthly credits, which covers up to 33,333 reverse geocode calls. That works out to about $0.90 per 1,000 lookups, or $0.0009 per call. The Free plan includes 200 credits, allowing about 33 lookups each month.
Are nearest cities and distance metrics included on the Free plan?
No. Nearby cities, distance to closest coordinate, closest mapped coordinates, and the estimated city indicator are premium fields. Any paid plan unlocks these fields alongside the standard city, state, ZIP code, and country code returned on the Free plan.
How does the API handle coordinates that fall between towns or in rural areas?
The API maps the point to the closest known location in its database. On paid plans, you receive the estimated city indicator to confirm whether the city was an exact match or an estimate, along with the distance in miles to that closest coordinate.
Can I store and display the returned location data in a commercial application?
Yes, provided you are on a paid plan. Commercial use is allowed across all paid tiers for powering features within your own application. You may not resell or redistribute the raw geocoding data as a standalone dataset.

Ready to build with Reverse Geocode? Start with 200 free credits — one key unlocks all 300+ APIs.

Explore the catalog

300+ APIs on the same key and the same response shape.

Browse all APIs