Send an address validation request

  • The Address Validation API validates addresses using a POST request to a specified endpoint with a JSON request body containing the address details.

  • The request body minimally requires theaddressLines field, whileregionCode is recommended for improved accuracy.

  • For US and PR addresses, enabling theenableUspsCass option leverages the CASS™ system for enhanced validation and standardization.

  • Users can experiment with the API using the API Explorer, which allows for composing requests, customizing parameters, and executing them.

European Economic Area (EEA) developers If your billing address is in the European Economic Area, effective on 8 July 2025, the Google Maps Platform EEA Terms of Service will apply to your use of the Services. Functionality varies by region.Learn more.

Send an address validation request by issuing a POST request to one of thefollowing endpoints:

Note: This documentation uses REST for its examples, but the approach is similarwithgRPC.

Your request should also pass aJSON request body to the request thatdefines the address to validate. The following request body contains one fieldand three subfields:

curl-XPOST-d'{"address":{"regionCode":"US","locality":"Mountain View","addressLines":["1600 Amphitheatre Pkwy"]}}'\-H'Content-Type:application/json'\"https://addressvalidation.googleapis.com/v1:validateAddress?key=API_KEY"

You can also omitlocality and specify it as an element intheaddressLines array:

{"address":{"regionCode":"US","addressLines":["1600 Amphitheatre Pkwy","Mountain View, CA, 94043"]},}

The APIs Explorer lets you make live requests so that you can get familiar withthe API and the API options:

Address request fields

The request body consists of a single field:

  • address — a field of typePostalAddress, which must contain atleast one entry inaddressLines.

When sending theaddress field to the Address Validation API, you need onlysupply one field:addressLines. However, the simplest address requestshould contain the following subfields:

  • regionCode — Recommended. This is an optional field, but if omitted, theAddress Validation API infers the region from the address. However, for bestresults, include theregionCode if you know it.For the list of supported regions, seesupported regions.
  • addressLines — Required. An array with addresses describing the lowerstructure of the address.
SeePostalAddress in the reference guide.

USPS CASS™ option

The United States Postal Service® (USPS®)1 maintains theCoding Accuracy Support System (CASS™) to support and certifyaddress validation providers.

Note: The Address Validation API is confirmed as a CASS-Certified™ service. Thismeans the service is confirmed for its ability to fill in missing addressinformation, standardize it, and update it to the most current and accurateaddress.

For US and PR regions only, you can enable CASS processing by settingenableUspsCass totrue in the request body. For best results when usingCASS, provide an address that includes the street and street number along withthe city, state, and ZIP code:

{"address":{"regionCode":"US","locality":"Mountain View","administrativeArea":"CA","postalCode":"94043","addressLines":["1600 Amphitheatre Pkwy"]},"enableUspsCass":true}
Note: If you don't require CASS processing, or if you are validatingaddresses outside of the US and PR regions, Google does not recommend enablingthis feature.

Try it!

The APIs Explorer lets you make sample requests sothat you can get familiar with the API and the API options.

  1. Select the API iconapi on the right side of the page.

  2. Optionally edit the request parameters.

  3. Select theExecute button. In the dialog, choose the account that you want to use to make the request.

  4. In the APIs Explorer panel, select the fullscreen iconfullscreen to expand the APIs Explorer window.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-11-21 UTC.