# Suggest Services

> Predictive autocomplete for countries, cities, streets, postal codes, and house numbers. Results update as you type, so users enter valid addresses.

OpenAPI contract: [JSON](https://documentation.egon.com/openapi/suggest-services.json) · [YAML](https://documentation.egon.com/openapi/suggest-services.yaml)

## Endpoints

- [Suggest Country](https://documentation.egon.com/docs/api/country.md): The Suggest Country endpoint provides predictive autocomplete and search over world countries, with names in many languages, ISO codes, and Egon IDs. (`POST /api/suggest/country`)
- [Suggest State](https://documentation.egon.com/docs/api/state.md): The Suggest State endpoint provides predictive autocomplete and search for states and federal states, returning names, codes, and Egon IDs. (`POST /api/suggest/state`)
- [Suggest Region](https://documentation.egon.com/docs/api/region.md): The Suggest Region endpoint provides predictive autocomplete and search for regions, returning each matching region with its name and Egon ID. (`POST /api/suggest/region`)
- [Suggest Province](https://documentation.egon.com/docs/api/province.md): The Suggest Province endpoint provides predictive autocomplete and search for provinces, returning each match with its province code and Egon ID. (`POST /api/suggest/province`)
- [Suggest City](https://documentation.egon.com/docs/api/city.md): The Suggest City endpoint provides predictive autocomplete and search for cities and municipalities, with their postal code and Egon ID. (`POST /api/suggest/city`)
- [Suggest District 1](https://documentation.egon.com/docs/api/district-1.md): The Suggest District 1 endpoint provides predictive autocomplete and search for first-level districts, such as localities and municipalities. (`POST /api/suggest/district1`)
- [Suggest Zipcode](https://documentation.egon.com/docs/api/zipcode.md): The Suggest Zipcode endpoint suggests postal codes at locality level (L) or at street level (S, available for GBR, IRL, NLD, and JPN). (`POST /api/suggest/zipcode`)
- [Suggest Zipcode All](https://documentation.egon.com/docs/api/zipcode-all.md): The Suggest Zipcode All endpoint returns every house-number range for a city, street, or house number, with its parity and range type. (`POST /api/suggest/zipcodeAll`)
- [Suggest Street](https://documentation.egon.com/docs/api/street.md): The Suggest Street endpoint provides predictive autocomplete for street search. (`POST /api/suggest/street`)
- [Suggest House Number](https://documentation.egon.com/docs/api/hn.md): The Suggest House Number endpoint suggests house numbers for a street, including numbers with exponents and kilometer markers. (`POST /api/suggest/hn`)
- [Suggest Birth Locality](https://documentation.egon.com/docs/api/birth-locality.md): The Suggest Birth Locality endpoint searches official and historical birth localities and returns the corresponding Belfiore code. (`POST /api/suggest/birthLocality`)