Sign in

v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Addresses

Validate an address

Validates an address for emergency services.

post/addresses/actions/validate

Request body

administrative_areastring

The locality of the address. For US addresses, this corresponds to the state of the address.

country_codestring required

The two-character (ISO 3166-1 alpha-2) country code of the address.

extended_addressstring

Additional street address information about the address such as, but not limited to, unit number or apartment number.

localitystring

The locality of the address. For US addresses, this corresponds to the city of the address.

postal_codestring required

The postal code of the address.

street_addressstring required

The primary street address information about the address.

Example request

{
  "administrative_area": "TX",
  "country_code": "US",
  "extended_address": "14th Floor",
  "locality": "Austin",
  "postal_code": "78701",
  "street_address": "600 Congress Avenue"
}

Response

Action response

Example response

{
  "data": {
    "errors": [
      {
        "code": "20207",
        "description": "The street address provided is invalid.",
        "source": {
          "pointer": "/street_address"
        },
        "title": "Invalid street address"
      }
    ],
    "record_type": "address_validation",
    "result": "valid",
    "suggested": {
      "administrative_area": "TX",
      "country_code": "US",
      "extended_address": "14th Floor",
      "locality": "Austin",
      "postal_code": "78701",
      "street_address": "600 Congress Avenue"
    }
  }
}