Address Validate

This operation validates addresses to improve postal accuracy within the country (e.g., United States). This ensure that parcels are rated correctly and shipments reach their final destination on time. The validate address operation sends an address for verification, and the response indicates whether the address is valid.
Key Considerations:

  • Validation results include VALIDATED_AND_NOT_CHANGED or VALIDATED_CHANGED for valid addresses. Invalid addresses result in HTTP status 400 with an errorCode of invalid_address.
  • Only U.S. domestic addresses are validated.
  • Pitney Bowes verifies addresses for accuracy against current USPS® data and makes corrections to delivery lines and last lines when possible.
  • The minimalAddressValidation query parameter can be used to limit the extent of corrections to the address.
  • If validation fails, you can use the Suggest Addresses API call to provide suggestions that could result in the address passing verification in a subsequent Address Validation API call.
SecuritybearerAuth
Request
Request Body schema: application/json
addressLine1
required
string

The addressLine1 can contain the Flat number, Building or Apartment Name/number (if any) or company name (if not residential).

addressLine2
string

The addressLine2 contains Street address or Landmark (if any).

addressLine3
string

The addressLine3 contains P.O.Box (if any) near the address.

cityTown
string

The name of the city or town to where the address belongs.

countryCode
required
string

This indicates the two-character ISO code of the country from the ISO country list.

name
string

Name of the person to which this address points.

postalCode
required
string

The postal code or ZIP code of the address. For US addresses, use either the 5-digit or 9-digit ZIP code in one of the following formats: '12345' or '12345-6789'. If you use a different format, such as 12345- or 123451234, will receive an error.

stateProvince
string

The State or Province of the address. For a US or Canadian address, it is the 2-letter state or province code.

Responses
200

The address has been verified.

400

Invalid request.

401

The request could not be authorized.

500

The request could not be completed due to an internal error.

post/api/v1/address/verify
Request samples
application/json
{
  • "addressLine1": "27 Watervw Dr",
  • "addressLine2": "near abc street",
  • "addressLine3": "near xyz street",
  • "cityTown": "Shelton",
  • "countryCode": "US",
  • "name": "John Smith",
  • "postalCode": "06484",
  • "stateProvince": "CT"
}
Response samples
application/json
{
  • "addressLine1": "27 Waterview Drive",
  • "addressLine2": "near abc street",
  • "addressLine3": "near xyz street",
  • "cityTown": "Shelton",
  • "countryCode": "US",
  • "name": "John Smith",
  • "postalCode": "06484-5841",
  • "residential": true,
  • "stateProvince": "CT",
  • "status": "VALIDATED_AND_NOT_CHANGED",
  • "deliveryPoint": "57",
  • "carrierRoute": "C005"
}