---
title: "Reverse geocode a coordinate"
method: GET
path: "/places/reverse"
tags: ["discovery"]
---

# Reverse geocode a coordinate

`GET /places/reverse`

## Request

- Base URL: `https://api.mapsource.io`
- URL: `https://api.mapsource.io/places/reverse`
- Auth: HTTP bearer

Reverse geocodes against the local Photon address index and returns the nearest indexed house number, street, district, city, state, postcode, country and country code with coordinate, distance and OSM identity. Local Overpass candidates remain available as traceable fallbacks.

When to use: Retrieve a complete locally indexed postal address or place identity associated with a coordinate.

## Query parameters

- `lat` number, required
- `lon` number, required
- `radius` integer

## Response `200`

Reverse geocode a coordinate

- object
  - `schema` string
  - `place` object, nullable
  - `candidates` unknown[]
    - unknown
  - `meta` object
    - `requestId` string
    - `computeMs` integer
    - `requestedAt` string, date-time
    - `sources` object[]
      - `dataset` string
      - `observedAt` string, nullable
      - `license` string
    - `freshness` object, nullable
    - `licenses` string[]
    - `attribution` string[]

## Other responses

- `400`: Error with a stable machine code.
- `401`: Error with a stable machine code.
- `429`: Error with a stable machine code.
- `500`: Error with a stable machine code.

---

[API](https://skmtc.dev/mapsource/apis/mapsource-overpass-api.md) · [All operations](https://skmtc.dev/mapsource/apis/mapsource-overpass-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mapsource/apis/mapsource-overpass-api/revisions/8af8c2769e7b?raw)