---
title: "Geocode autocomplete (type-ahead)."
method: GET
path: "/search/geocode/v1/autocomplete"
tags: ["Geocoding"]
---

# Geocode autocomplete (type-ahead).

`GET /search/geocode/v1/autocomplete`

## Request

- Base URL: `https://api.rijwind.com`
- URL: `https://api.rijwind.com/search/geocode/v1/autocomplete`
- Auth: HTTP bearer

Type-ahead variant of `/search/geocode/v1/forward`, billed at a tenth of the cost — fire it on every keystroke from a search bar.

**Quota cost:** 0.1 unit per call.

## Query parameters

- `q` string, required
- `lang` string
- `limit` integer

## Response `200`

Autocomplete suggestions.

- PlaceFeatureCollection: Standard GeoJSON FeatureCollection, ranked by relevance.
  - `features` PlaceFeature[], required
    - `geometry` PointGeometry, required
      - `coordinates` number[], required: `[lon, lat]`.
      - `type` string, required: Fixed string `"Point"`.
    - `properties` PlaceProperties, required: Geographic metadata for a place. Optional fields are omitted when the underlying record doesn't carry them — e.g. a country-level result has no `street`.
      - `city` string, nullable
      - `country` string, nullable
      - `countrycode` string, nullable: ISO 3166-1 alpha-2 country code.
      - `name` string, nullable: Display name of the place.
      - `postcode` string, nullable
      - `state` string, nullable
      - `street` string, nullable
      - `type` string, nullable: What kind of place this is — `street`, `house`, `locality`, `city`, `district`, `region`, `country`, etc.
    - `type` string, required: Fixed string `"Feature"`.
  - `type` string, required

## Other responses

- `400`: Query parameters failed validation.
- `401`: Missing, malformed, or revoked API key.
- `429`: Monthly quota exhausted.

---

[API](https://skmtc.dev/rijwind/apis/rijwind-api.md) · [All operations](https://skmtc.dev/rijwind/apis/rijwind-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rijwind/apis/rijwind-api/revisions/01d72fb6aa4d?raw)