{
"object": "address.resolution_result",
"created": 1764892800,
"input": {
"address": "1600 Amphitheatre Parkway, Mountain View, CA"
},
"normalized": "1600 Amphitheatre Parkway, Mountain View, CA 94043, United States",
"components": {
"street_number": "1600",
"thoroughfare": {
"name": "Amphitheatre Parkway"
},
"localities": [
{
"name": "Mountain View",
"type": "city"
}
],
"admin_areas": [
{
"name": "California",
"code": "CA",
"type": "state",
"level": 1
}
],
"region": "California",
"region_code": "CA",
"postal_code": "94043",
"country": "United States",
"country_code": "US",
"address_lines": [
"1600 Amphitheatre Parkway",
"Mountain View, CA 94043",
"United States"
],
"canonical_form": "1600 AMPHITHEATRE PARKWAY, MOUNTAIN VIEW, CA 94043, US",
"coordinates": {
"lat": 37.4224764,
"lng": -122.0842499
},
"metadata": {
"confidence": 0.95,
"address_type": "commercial",
"deliverability": "deliverable",
"timezone": "America/Los_Angeles"
}
}
}Resolve an Address
Normalize and optionally validate an address
{
"object": "address.resolution_result",
"created": 1764892800,
"input": {
"address": "1600 Amphitheatre Parkway, Mountain View, CA"
},
"normalized": "1600 Amphitheatre Parkway, Mountain View, CA 94043, United States",
"components": {
"street_number": "1600",
"thoroughfare": {
"name": "Amphitheatre Parkway"
},
"localities": [
{
"name": "Mountain View",
"type": "city"
}
],
"admin_areas": [
{
"name": "California",
"code": "CA",
"type": "state",
"level": 1
}
],
"region": "California",
"region_code": "CA",
"postal_code": "94043",
"country": "United States",
"country_code": "US",
"address_lines": [
"1600 Amphitheatre Parkway",
"Mountain View, CA 94043",
"United States"
],
"canonical_form": "1600 AMPHITHEATRE PARKWAY, MOUNTAIN VIEW, CA 94043, US",
"coordinates": {
"lat": 37.4224764,
"lng": -122.0842499
},
"metadata": {
"confidence": 0.95,
"address_type": "commercial",
"deliverability": "deliverable",
"timezone": "America/Los_Angeles"
}
}
}validate: true in options to include deliverability and consistency checks in the response.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
API version in YYYY-MM-DD format.
^\d{4}-\d{2}-\d{2}$Provide on POST requests to make them idempotent for safe retries.
Body
- Option 1
- Option 2
Request to resolve an address into normalized, structured format.
Free-form address text.
A structured representation of a postal address designed for global coverage. Compatible with the Universal Postal Union (UPU) standards, CLDR address formats, and major geocoding providers. Supports addresses from all countries including complex East Asian, Middle Eastern, and rural addressing systems.
Show child attributes
Show child attributes
Optional processing instructions for address resolution.
Show child attributes
Show child attributes
Response
OK
Result of address resolution. Fields present depend on options.
"address.resolution_result"Epoch seconds.
Show child attributes
Show child attributes
Arbitrary key/value pairs attached to the request; echoed in results.
Show child attributes
Show child attributes
Canonical single-line address in requested format (e.g., postal).
A structured representation of a postal address designed for global coverage. Compatible with the Universal Postal Union (UPU) standards, CLDR address formats, and major geocoding providers. Supports addresses from all countries including complex East Asian, Middle Eastern, and rural addressing systems.
Show child attributes
Show child attributes
High-level quality assessment of the resolved address.
Show child attributes
Show child attributes
Present only if the result is persisted.