---
title: "Geocode through the compatibility provider"
method: GET
path: "/geocode"
tags: ["discovery"]
---

# Geocode through the compatibility provider

`GET /geocode`

## Request

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

Address and place lookup through the separately configured, rate-limited geocoding provider. Retained for clients using this response format; local search is available through lookupPlaces.

When to use: Maintain an existing integration that requires the compatibility geocoder's response format.

When not to use: Use lookupPlaces for new address, business, brand and place search integrations. This provider-backed endpoint supports interactive requests, not bulk geocoding.

## Query parameters

- `q` string, required

## Response `200`

Geocode through the compatibility provider

- object
  - `schema` string
  - `results` unknown[]
    - unknown

## 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)