Sign in

v47

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-181,0851,7264.5 MB
Addresses

Validate an address

Validates an address for emergency services.

post/addresses/actions/validate

Request body

street_addressstring required

The primary street address information about 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.

administrative_areastring

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

postal_codestring required

The postal code of the address.

country_codestring required

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

Example request

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

Response

Action response

Example response

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