# Suggest addresses for a partial input

> POST /addresses/suggestions

Source: https://docs.trykintsugi.com/reference/2026-07-21/suggest-addresses-for-a-partial-input

POST /addresses/suggestions

Suggest addresses for a partial input

Return a list of suggested addresses that match a partial or ambiguous input, to power address autocomplete. The list is empty when there are no matches. Returns 400 if the country is not supported, and 503 if the address validation service is temporarily unavailable.

Category: Addresses

Request body:
street1 (string) - First line of the street address. An empty string when none was supplied.
street2 (string) - Second line of the street address. An empty string when none was supplied.
city (string) - City or locality. An empty string when none was supplied.
county (string) - County or district. An empty string when none was supplied.
state (string) - State or province code.
postalCode (string) - Postal or ZIP code. An empty string when none was supplied.
country (string) - ISO-3166 alpha-2 country code.
fullAddress (string) - Single-line full address, as an alternative to fields.

Response fields:
city (string) - City or locality. An empty string when none was supplied.
county (string) - County or district. An empty string when none was supplied.
state (string) - State or province of the suggested address.
postalCode (string) - Postal or ZIP code. An empty string when none was supplied.
country (string) - ISO-3166 alpha-2 country code of the suggestion.

Response statuses: 200, 400, 401, 403, 404, 409, 422, 503

---

Index of every page: https://docs.trykintsugi.com/llms.txt