This operation provides valuable information about a specific zip code. Included are many demographics codes that many users find valuable for tracking customers and statistical analysis.

URL Endpoints

GetZipInfo Inputs

NameTypeDescription
ZipStringThe zip for which to find demographic data.
LicenseKeyStringYour license key to use the service.
Sign up for a free trial key at
https://www.serviceobjects.com/products/address/address-geocode-us

GetZipInfo Outputs

NameTypeValuesDescription
CityStringVariesThe city of the given zip code. Alternate
city names are given below.
StateStringVariesThe state of the given zip code.
CountyStringVariesThe county of the given zip code.
AreaCodeStringVariesThe area code of the given zip code.
CityAbbreviationStringVariesA common abbreviation of the city
name of the given zip code.
CityTypeStringN, P, U, B,
A, C, S, K
The city type of the given zip code. The
city type of the given zip code. The
code refers to the type of postal station
in a given zip code. See table below for
descriptions for each of the codes.
CountyFIPSStringNumberCounty FIPS(Federal Information
Processing Standard) code; used to
uniquely identify counties across the
US.
StateFIPSStringNumberState FIPS(Federal Information
Processing Standard) code; used to
uniquely identity states.
TimeZoneStringNumberThe number of hours offset from GMT. 5
= Eastern time zone.
DayLightSavingsStringY or NWhether the given zip code observes
Day Light Savings time.
MSAStringVariesThe Metropolitan Statistical Area Code.
Used to uniquely identify a geographic
area with a relatively high population
density at its core.
MDStringVariesThe Metropolitan District Code.
CBSAStringVariesThe Core Based Statistical Area Code.
A code used to identify an urban center
of at least 10,000 people and adjacent
areas that are socioeconomically tied to
the urban center. 
PMSAStringVariesThe Primary Metropolitan Statistical
Area code. Used to uniquely identify
areas that are part of a larger urban
center. 
DMAStringVariesThe Designated Market Area code. Used
to uniquely identify a geographic region
that receive the same(or similar) TV and
radio show programs. 
LatitudeStringNumberThe latitude centroid of the given zip code.
LongitudeStringNumberThe longitude centroid of the given zip code.
ZipStringVariesThe zip code input.
CityAlternativeNameArrayOfStringVariesA list of strings that contain alternate
names for the city of the given zip code.
ErrorErrorVariesError object indicating why the service
could not return a result. See “Errors”
below for more information.

CityType Code Definitions

CodeDescription
NNon-Postal Community Name: Former Postal Facility 
PPost Office: An official post office branch.
UUrbanization: A postal designation specific to Puerto Rico.
BBranch: A postal facility that is not the main post office and is outside the corporate limits of a city.
AAirport Mail Facility: Facilities through which US mail is flown in and out of a city.
CCommunity Post Office: a contract postal unit providing mail services to small communities.
SStation: A post office that is not the main office for a city but is in corporate city limits.
KBulk Mail Center: Centers that handle bulk mail. Typically commercial, business and advertising mail.

References