# Suggestions

> POST /v1/address_validation/suggestions

Source: https://docs.trykintsugi.com/reference/suggestions

API version: v1 (legacy API)

POST /v1/address_validation/suggestions

Suggestions

This API endpoint provides address suggestions based on
    partial input data. It helps users auto-complete and validate addresses efficiently
    by returning a list of suggested addresses that match the input criteria.
    This improves accuracy, increases speed, reduces errors,
    and streamlines the data entry process.

Category: Address Validation

Request body:
line1 (string) - Primary address line, such as street name and number
line2 (string) - Additional address details, such as an apartment or suite number
line3 (string) - Additional address details for complex addresses
city (string) - The city or town name for the address
state (string) - State, province, or region of the address
country (string) - Country code in ISO 3166-1 alpha-2 format (e.g., 'US' for the United States).
        Defaults to 'US'.
        should not be empty. Not validating here as the validation
        structure can be different for different providers
postalCode (string) - ZIP or postal code for the address. Can be empty for some locales.
        Not validating here as the validation structure can be different for different providers
id (integer) - Unique identifier for the request, if applicable
county (string) - County or district name for the address
fullAddress (string) - A complete address string that can be used as an alternative to providing individual fields.

Response statuses: 200, 401, 422, 500

---

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