Use ZIP Codes to retrieve location metadata for US ZIP codes, including city, county, state, latitude, and longitude.
Use ZIP Codes to retrieve location metadata for US ZIP codes, including city, county, state, latitude, and longitude.
ZIP code metadata is useful for display, tariff discovery, and location-based workflows. For example, if you are interested in tariffs for ZIP code 48322, you can retrieve the city, county, state, and coordinate details associated with that ZIP code.
Search ZIP code records and retrieve matching location metadata.
Retrieve details for one ZIP code.
Data definitions
ZIP Code
The ZipCode object has the following data structure.
| Name | Type | Description |
|---|---|---|
| zipcode | String | 5-character string of the ZIP code. |
| latitude | Integer | Latitude of this location. |
| longitude | Integer | Longitude of this location. |
| city | String | Display name of the city containing this ZIP code. |
| county | String | Display name of the county containing this ZIP code. |
| areaCode | String | Area code or codes for this ZIP code. Area codes are separated by a forward slash, such as 415/510. |
| cityType | String | Not currently used. |
| cityAliasAbbreviation | String | Common abbreviation for this city, if available. |
| elevation | Integer | Highest elevation, in feet, within this ZIP code. |
| dayLightSaving | Boolean | Whether this ZIP code observes daylight saving time. |
| cityMixedCase | String | Alternate display name of the city containing this ZIP code. |
| stateAnsi | Integer | State ANSI code representing the state containing this ZIP code. |
| countyAnsi | Integer | ANSI code representing the county containing this ZIP code. |
| state | String | Two-character abbreviation of the state containing this ZIP code. |
| timeZone | Integer | Number indicating the time zone, such as 8 for Pacific Time. |
State ANSI codes for the United States are published by the US Census Bureau.
This example shows a ZIP code object:
{
"zipcode":"48322",
"latitude":42,
"longitude":-83,
"city":"WEST BLOOMFIELD",
"county":"OAKLAND",
"areaCode":"248/734",
"cityType":"B",
"cityAliasAbbreviation":"W BLOOMFIELD",
"elevation":943,
"dayLightSaving":true,
"classificationCode":null,
"cityMixedCase":"West Bloomfield",
"cityAliasMixedCase":"West Bloomfield",
"stateAnsi":26,
"countyAnsi":125,
"state":"MI",
"timeZone":5
}Get ZIP Codes
Retrieve ZIP code records and their associated location metadata.
Resource URI
GET /rest/public/zipcodesFor endpoint-specific details, see Get ZIP Codes.
Get One ZIP Code
Retrieve details for a ZIP code in the standard response format.
Resource URI
GET /rest/public/zipcodes/{zipCode}Request parameters
| Name | Type | Description |
|---|---|---|
| zipCode | String | ZIP code to retrieve. Required. |
