---
title: "Search"
method: POST
path: "/v1/address_validation/search"
tags: ["Address Validation"]
---

# Search

`POST /v1/address_validation/search`

This API validates and enriches address information
    submitted by the user. It ensures that the address is standardized, accurate,
    and compliant with geographical and postal standards.
    The API also adds additional fields, such as county, when possible.

## Request body

- AddressBase
  - `phone` string, nullable — Phone number associated with the address.
  - `street_1` string, nullable — Primary street address.
  - `street_2` string, nullable — Additional street address details, such as an apartment or suite number.
  - `city` string, nullable — City where the customer resides.
  - `county` string, nullable — County or district of the customer.
  - `state` string, nullable — State or province of the customer.
  - `postal_code` string, nullable — ZIP or Postal code of the customer.
  - `country` 'AF' | 'AX' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BQ' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'CV' | 'KH' | 'CM' | 'CA' | 'KY' | 'CF' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'HR' | 'CU' | 'CW' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'SZ' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GG' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IM' | 'IL' | 'IT' | 'CI' | 'JM' | 'JP' | 'JE' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'ME' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MK' | 'MP' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'BL' | 'SH' | 'KN' | 'LC' | 'MF' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'RS' | 'SC' | 'SL' | 'SG' | 'SX' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'GS' | 'SS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'XK' | 'ZZ_EU'
  - `full_address` string, nullable — Complete address string of the customer, which can be used as an alternative to individual fields.

## Response `200`

Address found successfully

- AddressSearchResponse[]
  - `address_submitted` AddressSubmittedResponse, required
    - `street_1` string, nullable — Primary street address of the customer
    - `street_2` string, nullable — Additional street address details, such as an apartment or suite number
    - `city` string, nullable — City where the customer resides
    - `county` string, nullable — County or district of the customer
    - `state` string, nullable — State or province of the customer
    - `postal_code` string, nullable — ZIP or Postal code of the customer
    - `country` string, nullable — Country code in ISO 3166-1 alpha-2 format
    - `full_address` string, nullable — Complete address string of the customer, which can be used as an alternative to individual fields
  - `response_address` AddressResponseData, required
    - `street_1` string, nullable — Primary street address of the customer
    - `street_2` string, nullable — Additional street address details, such as an apartment or suite number
    - `city` string, nullable — City where the customer resides
    - `county` string, nullable — County or district of the customer
    - `state` string, nullable — State or province of the customer
    - `postal_code` string, nullable — ZIP or Postal code of the customer
    - `country` string, nullable — Country code in ISO 3166-1 alpha-2 format
    - `full_address` string, nullable — Complete address string of the customer, which can be used as an alternative to individual fields
  - `verification_status` string, required — Indicates if the address was VERIFIED, PARTIALLY_VERIFIED, INVALID, UNVERIFIABLE, BLANK
  - `enrich_fields` string[], required — List of additional fields added to enrich the address

## Other responses

- `401` — The request is missing a valid x-api-key.
- `422` — Validation error - Address fields failed validation or are incomplete
- `500` — An unexpected server error occurred.

## Changes

- **2026-08-29** `6ba4f4c774c3` — 268 breaking, 9 info
  - removed the enum value `AD` of the request property `country`
  - removed the enum value `AE` of the request property `country`
  - removed the enum value `AF` of the request property `country`
  - removed the enum value `AG` of the request property `country`
  - …273 more
  - …this revision’s changelog is incomplete

[Change history](https://skmtc.dev/trykintsugi/apis/tax-platform/changes/v1/address_validation/search/post.md)

---

[API](https://skmtc.dev/trykintsugi/apis/tax-platform.md) · [All operations](https://skmtc.dev/trykintsugi/apis/tax-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trykintsugi/tax-platform/revisions/6ba4f4c774c3/schema)