---
title: "Search postal codes, places or countries"
method: GET
path: "/search"
tags: ["Search"]
---

# Search postal codes, places or countries

`GET /search`

Returns lightweight suggestions used by the public lookup UI. Use country filtering when the user's country is known. Postal-code coverage and granularity vary by country.

## Query parameters

- `q` string, required
- `country` string
- `region` string

## Response `200`

A list of matching country, locality or postal-code suggestions.

- SearchSuggestion[]
  - `type` string, required
  - `text` string, required
  - `sub` string, required
  - `url` string, required

---

[API](https://skmtc.dev/postalcodes/apis/postalcodes-info-postal-code-reference-api.md) · [All operations](https://skmtc.dev/postalcodes/apis/postalcodes-info-postal-code-reference-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/postalcodes/postalcodes-info-postal-code-reference-api/revisions/d98a4c6d6ad6/schema)