# Suggest addresses for many inputs

> POST /addresses/suggestions/bulk

Source: https://docs.trykintsugi.com/reference/2026-07-21/suggest-addresses-for-many-inputs

POST /addresses/suggestions/bulk

Suggest addresses for many inputs

Return suggestions for a batch of addresses in one request, one group per input correlated by the `id` you send. Every input always comes back as a group, in request order; a group has an empty `suggestions` list when there are no matches, the country is unsupported, or the validation service was unavailable for it.

Category: Addresses

Request body:
addresses (BulkAddressSuggestionsItem[], required) - The addresses to fetch suggestions for.
  id (string) - Your identifier, echoed on the response group.
  connectionId (string) - Connection this address belongs to, used to resolve a default country.
  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:
id (string) - The `id` from the matching request address; empty if none was sent.
suggestions (AddressSuggestion[], required) - Suggested addresses for this input; empty when there are none.
  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

---

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