---
title: "Suggests geocodes for a given query string"
method: GET
path: "/geocode/suggest"
tags: ["Suggest", "Geocode"]
---

# Suggests geocodes for a given query string

`GET /geocode/suggest`

## Query parameters

- `q` string, required
- `limitToResolution` string

## Response `200`

OK

- Location[] — A list of geo locations
  - `country` string — ISO-3166-2 code of a country
  - `administrativeAreaLevel1` string — First administrative subdivision of a country
  - `administrativeAreaLevel2` string — Second administrative subdivision of a country
  - `administrativeAreaLevel3` string — Third administrative subdivision of a country
  - `place` string — Name of the place this location refers to
  - `name` string — Full name of the location
  - `geoResolution` 'Point' | 'Admin3' | 'Admin2' | 'Admin1' | 'Country' — How granular the location is
  - `geometry` object
    - `latitude` number, required
    - `longitude` number, required

## Other responses

- `403` — Forbidden
- `422` — Unprocessable entity
- `500` — Internal server error

---

[API](https://skmtc.net/globaldothealth/apis/global-health-curator-service-api.md) · [All operations](https://skmtc.net/globaldothealth/apis/global-health-curator-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/globaldothealth/global-health-curator-service-api/revisions/5b1151265235/schema)