RetroSearch Browse

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://developers.google.com/maps/documentation/address-validation/requests-validate-address below:

Send an address validation request | Address Validation API

Skip to main content Send an address validation request

Stay organized with collections Save and categorize content based on your preferences.

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

validateAddress (REST)
ValidateAddress (gRPC)

Note: This documentation uses REST for its examples, but the approach is similar with gRPC.

Your request should also pass a JSON request body to the request that defines the address to validate. The following request body contains one field and three subfields:

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:

{
  "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:

Address request fields

The request body consists of a single field:

address — a field of type 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.
addressLines — Required. An array with addresses describing the lower structure of the address.

USPS CASS™ option

The United States Postal Service® (USPS®)¹ maintains the Coding Accuracy Support System (CASS™) to support and certify address validation providers.

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:

{
  "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 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.

Select the API icon api on the right side of the page.
Optionally edit the request parameters.
Select the Execute button. In the dialog, choose the account that you want to use to make the request.
In the APIs Explorer panel, select the fullscreen icon fullscreen to expand the APIs Explorer window.

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

Last updated 2025-07-16 UTC.

[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-16 UTC."],[[["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 the `addressLines` field, while `regionCode` is recommended for improved accuracy."],["For US and PR addresses, enabling the `enableUspsCass` 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."]]],["To validate an address, send a POST request to the provided REST or gRPC endpoint, including a JSON request body that defines the address. The request body must contain the `address` field, a `PostalAddress` type with at least one entry in `addressLines`. Recommended subfields are `regionCode` and `addressLines`; the simplest request should have both. For US and PR regions, enabling `enableUspsCass` will use USPS CASS processing. Use the APIs Explorer to make sample requests.\n"]]

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4