Validate and enrich an address
Validate an address and return the standardized, enriched version of it along with whether it verified and which fields were added or corrected. The address is validated against postal reference data; components such as county are filled in when they can be. Returns 400 if the country is not supported, and 503 if the address validation service is temporarily unavailable.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Body
First line of the street address. An empty string when none was supplied.
Second line of the street address. An empty string when none was supplied.
City or locality. An empty string when none was supplied.
County or district. An empty string when none was supplied.
State or province code.
Postal or ZIP code. An empty string when none was supplied.
ISO-3166 alpha-2 country code.
Single-line full address, as an alternative to fields.
Contact phone for the address.
Response
The address exactly as it was submitted.
The standardized and enriched version of the submitted address.
Whether the address verified. An unverified address can resolve to the wrong jurisdiction, so check this before treating tax on it as final.
UNVERIFIEDINVALIDPARTIALLY_VERIFIEDVERIFIEDUNVERIFIABLEBLANKNames of the fields validation added or corrected on the standardized address. Empty when nothing was enriched.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.
A service this request depends on was unavailable. Retry the request.