---
title: "Reverse geocode coordinates to location name"
method: GET
path: "/location/reverse"
tags: ["location-timezone"]
---

# Reverse geocode coordinates to location name

`GET /location/reverse`

## Request

- Base URL: `https://api.openephemeris.com`
- URL: `https://api.openephemeris.com/location/reverse`
- Auth: HTTP bearer

Convert latitude/longitude to a human-readable location with timezone.

## Query parameters

- `lat` number, required: Latitude in decimal degrees
- `lng` number, required: Longitude in decimal degrees

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable
- `X-OpenEphemeris-API-Key` string, nullable
- `apikey` string, nullable

## Response `200`

Successful Response

- ReverseGeocodeResponse: Response for /location/reverse endpoint.
  - `city` string: City or locality name, if available
  - `country` string: Full country name
  - `country_code` string: ISO 3166-1 alpha-2 country code
  - `display_name` string, required: Formatted name suitable for UI display
  - `latitude` number, required: Latitude in decimal degrees
  - `longitude` number, required: Longitude in decimal degrees
  - `region` string: Region, state, or province name
  - `timezone` string, required: IANA timezone identifier

## Other responses

- `400`: Bad Request - Invalid parameters
- `422`: Validation Error
- `503`: Service Unavailable - Geocoding provider down

---

[API](https://skmtc.dev/openephemeris/apis/open-ephemeris-api.md) · [All operations](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/revisions/d195a769cb89?raw)