**European Economic Area (EEA) developers**

> [!NOTE]
> If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](https://developers.google.com/maps/comms/eea/faq.md.txt).

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

- [validateAddress](https://developers.google.com/maps/documentation/address-validation/reference/rest/v1/TopLevel/validateAddress.md.txt) (REST)
- [ValidateAddress](https://developers.google.com/maps/documentation/address-validation/reference/rpc/google.maps.addressvalidation.v1.md.txt#google.maps.addressvalidation.v1.AddressValidation.ValidateAddress) (gRPC)

> [!NOTE]
> **Note:** This documentation uses REST for its examples, but the approach is similar with [gRPC](https://www.grpc.io/).

Your request should also pass a [JSON request body](https://developers.google.com/maps/documentation/address-validation/reference/rest/v1/TopLevel/validateAddress.md.txt#request-body) to the request that
defines the address to validate. The following request body contains one field
and three subfields:

```json
curl -X POST -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 omit `locality` and specify it as an element in
the `addressLines` array:

```json
{
  "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 with
the API and the API options:
[Try it!](https://developers.google.com/maps/documentation/address-validation/requests-validate-address.md.txt#try_it)

## Address request fields

The request body consists of a single field:

- `address` --- a field of type [`PostalAddress`](https://developers.google.com/maps/documentation/address-validation/reference/rest/v1/TopLevel/validateAddress.md.txt#postaladdress), which must contain at least one entry in `addressLines`.

When sending the `address` field to the Address Validation API, you need only
supply one field: `addressLines`. However, the simplest address request
should contain the following subfields:

- `regionCode` --- Recommended. This is an optional field, but if omitted, the Address Validation API infers the region from the address. However, for best results, include the `regionCode` if you know it. For the list of supported regions, see [supported regions](https://developers.google.com/maps/documentation/address-validation/coverage.md.txt).
- `addressLines` --- Required. An array with addresses describing the lower structure of the address.

|---|
| See [PostalAddress](https://developers.google.com/maps/documentation/address-validation/reference/rest/v1/TopLevel/validateAddress.md.txt#postaladdress) in the reference guide. |

## USPS CASS™ option

The United States Postal Service® (USPS®)^[1](https://developers.google.com/maps/documentation/address-validation/requests-validate-address.md.txt#fn1)^ maintains the
[Coding Accuracy Support System (CASS™)](https://postalpro.usps.com/certifications/cass) to support and certify
address validation providers.

> [!NOTE]
> **Note:** The Address Validation API is confirmed as a CASS-Certified™ service. This means the service is confirmed for its ability to fill in missing address information, standardize it, and update it to the most current and accurate address.

For US and PR regions only, you can enable CASS processing by setting
`enableUspsCass` to `true` in the request body. For best results when using
CASS, provide an address that includes the street and street number along with
the city, state, and ZIP code:

```json
{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}
```

> [!NOTE]
> **Note:** If you don't require CASS processing, or if you are validating addresses outside of the US and PR regions, Google does not recommend enabling this feature.

## Try it!

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

1. Select the API icon api
   on the right side of the page.

2. Optionally edit the request parameters.

3. Select the **Execute** 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 icon
   fullscreen to expand the APIs Explorer window.

<br />

<br />

*** ** * ** ***

1. Google Maps Platform is a non-exclusive Licensee of the United States
   Postal Service®. The following trademark(s) are owned by the United States
   Postal Service® and used with permission: United States Postal Service®,
   CASS™, CASS Certified™. [↩](https://developers.google.com/maps/documentation/address-validation/requests-validate-address.md.txt#fnref1)