Skip to main content
POST
/
tools
/
validate-address
{
  "valid": false,
  "suggestedAddress": {
    "street1": "500 S Main St",
    "street2": "Apt 1",
    "city": "Natick",
    "zip": "01701",
    "country": "US",
    "state": "CA",
    "region": "<string>",
    "attention": "<string>"
  },
  "validationDetails": {
    "issues": [
      {
        "message": "Missing city",
        "property": "city"
      },
      {
        "message": "Invalid zip format",
        "property": "zip"
      }
    ]
  }
}

Authorizations

X-API-Key
string
header
required

An API key that grants access to the Connect API. You can create and manage API keys in the portal.

Headers

X-Idempotency-Key
string

A unique key to ensure idempotency of requests. If a request with the same key has already been processed, the same result will be returned. The key must be unique for each distinct operation. Keys are expired after 24 hours, but we recommend using a new key for each request.

Modified requests with the same idempotency keys are rejected with a 409 Conflict status code.

Maximum length: 256

Body

application/json

Address to validate.

Request to validate an address.

address
object
required

Response

Address validation completed.

Result of address validation with optional suggestions.

Depending on setup, address validation is either shape based (e.g. this looks like an address), or verified against an address registry.

valid
boolean
required

Whether the provided address is valid.

Example:

false

suggestedAddress
object

If provided, a suggestion for a corrected address by the underlying address validation service.

Do note that this may be returned for seemingly valid addresses, where the network has a more precise or standardized version of the address. A typical example of this is the address is found in the networks' registry but under a different name because it contains aliases or minor formatting issues, mistyped zip codes, etc.

validationDetails
object

Additional validation details.

Example:
{
"issues": [
{
"message": "Missing city",
"property": "city"
},
{
"message": "Invalid zip format",
"property": "zip"
}
]
}
I