KintsugiKintsugi
API reference / Search

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.

Authorization

x-api-keystringRequired

Your secret API key. Include it with every request.

Body

phonestring

Phone number associated with the address.

street_1string

Primary street address.

street_2string

Additional street address details, such as an apartment or suite number.

citystring

City where the customer resides.

countystring

County or district of the customer.

statestring

State or province of the customer.

postal_codestring

ZIP or Postal code of the customer.

countryCountryCodeEnum

Country code in ISO 3166-1 alpha-2 format

Available options:AFAXALDZASADAOAIAQAGARAMAWAUATAZBSBHBDBBBYBEBZBJBMBTBOBQBABWBVBRIOBNBGBFBICVKHCMCAKYCFTDCLCNCXCCCOKMCGCDCKCRHRCUCWCYCZDKDJDMDOECEGSVGQEREESZETFKFOFJFIFRGFPFTFGAGMGEDEGHGIGRGLGDGPGUGTGGGNGWGYHTHMVAHNHKHUISINIDIRIQIEIMILITCIJMJPJEJOKZKEKIKPKRKWKGLALVLBLSLRLYLILTLUMOMGMWMYMVMLMTMHMQMRMUYTMXFMMDMCMNMEMSMAMZMMNANRNPNLNCNZNINENGNUNFMKMPNOOMPKPWPSPAPGPYPEPHPNPLPTPRQARERORURWBLSHKNLCMFPMVCWSSMSTSASNRSSCSLSGSXSKSISBSOZAGSSSESLKSDSRSJSECHSYTWTJTZTHTLTGTKTOTTTNTRTMTCTVUGUAAEGBUSUMUYUZVUVEVNVGVIWFEHYEZMZWXKZZ_EU
full_addressstring

Complete address string of the customer, which can be used as an alternative to individual fields.

Response

address_submittedAddressSubmittedResponseRequired

The original address data submitted in the request

response_addressAddressResponseDataRequired

The standardized and enriched version of the submitted address

verification_statusstringRequired

Indicates if the address was VERIFIED, PARTIALLY_VERIFIED, INVALID, UNVERIFIABLE, BLANK

enrich_fieldsstring[]Required

List of additional fields added to enrich the address

200

Address found successfully

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.

cURL
POST /v1/address_validation/search
-H "x-api-key: ***"
{
"phone": "555-123-4567",
"street_1": "1600 Amphitheatre Parkway",
"street_2": "Building 40",
"city": "Mountain View",
"county": "Santa Clara",
"state": "CA",
"postal_code": "94043",
"country": "US",
"full_address": "1600 Amphitheatre Parkway, Mountain View, CA 94043"
}
Response
[
{
"address_submitted": {
"street_1": "1600 Amphitheatre Parkway",
"street_2": "",
"city": "Mountain View",
"county": "",
"state": "CA",
"postal_code": "94043",
"country": "US",
"full_address": ""
},
"response_address": {
"street_1": "1600 AMPHITHEATRE PARKWAY",
"street_2": "",
"city": "MOUNTAIN VIEW",
"county": "SANTA CLARA",
"state": "CA",
"postal_code": "94043",
"country": "US",
"full_address": ""
},
"verification_status": "VERIFIED",
"enrich_fields": [
"county"
]
}
]