Page tree
Skip to end of metadata
Go to start of metadata



This operation will validate that a given city-state-zip validate together properly.  The inputs can be marginally incorrect, and this operation will correct them.  For instance, a combination with a valid city, slightly misspelled state, and totally incorrect zip code will be corrected to a valid city – state – zip code combination.


Important Note!
In this case, the corrected zip code will be the "standard" or most common zip code for that city/state.

URL Endpoints

JSON

https://trial.serviceobjects.com/AV3/api.svc/CityStateZipInfo/{CITY}/{STATE}/{ZIP}/{LICENSEKEY}?format=json

XML

https://trial.serviceobjects.com/AV3/api.svc/ValidateCityStateZip?City={CITY}&State={STATE}&Zip={ZIP}&LicenseKey={LICENSEKEY}

ValidateCityStateZip Inputs


Name

Type

Description

City

String

The city to validate.

State

String

The state to validate.

PostalCode

String

The zip code to validate.

LicenseKey

String

Your license key to use the service. 
Sign up for a free trial key at
https://www.serviceobjects.com/products/address-geocoding/usps-address-validation


ValidateCityStateZip Outputs


CityStateZipResponse

Name

Type

Values

Description

CityStateZip

CityStateZip

Varies

The validated city state and zip code for information.

Error

Error

Varies

Error object indicating why the service could not return a result. See “Errors” below for more information.


CityStateZip

Name

Type

Values

Description

City

String

Varies

The corrected city name.

State

String

Varies

The corrected state name.

Zip

String

Varies

The corrected zip code.  The standard zip code for the city and state is used if it was corrected.

GeneralDeliveryService

String

True or False

Indicates whether this location has General Delivery service.

POBoxServiceStringTrue or FalseWhether this location has PO Box service.
StreetServiceStringTrue or FalseIndicates whether this location has Street Delivery service.
RRHCServiceStringTrue or FalseIndicates whether this location has Rural Route / Highway Contract service.
UrbanizationServiceStringTrue or FalseIndicates whether this location has Urbanization service.
POBoxRangeLowStringTrue or FalseIf PO Box service is available in the area, this is its lowest valid PO Box number.
POBoxRangeHighStringTrue or FalseIf PO Box service is available in the area, this is its highest valid PO Box number.
IsUniqueZipCodeStringTrue or FalseIf the Zip code is assigned to a single entity like a University or Government building.


  • No labels