United States Postal Service Address

The USPS ZIP + 4 record backing a usps address. Carries the complete USPS field set for the delivery point, including elements the standard address format does not expose.

Example Record

Field	Example	Type
id	usps_V124884241|1040||0001	string
USA Dataset dataset	usps	string
Country country	United States	string
ISO Country Code (3) country_iso	USA	string
ISO Country Code (2) country_iso_2	US	string
Language language	en	string
Primary Number primary_number	1040	string
Secondary Number secondary_number	Empty in this example	string
Plus 4 Code plus_4_code	0001	string
First Address Line line_1	1040 Waverly Ave	string
Second Address Line line_2	Empty in this example	string
Last Line last_line	Holtsville NY 00501-0001	string
ZIP Code zip_code	00501	string
ZIP + 4 Code zip_plus_4_code	00501-0001	string
Update Key Number update_key_number	V124884241	string
Record Type Code record_type_code	S	string
Carrier Route ID carrier_route_id	C000	string
Street Pre-Directional Abbreviation street_pre_directional_abbreviation	Empty in this example	string
Street Name street_name	Waverly	string
Street Suffix Abbreviation street_suffix_abbreviation	Ave	string
Street Post Directional Abbreviation street_post_directional_abbreviation	Empty in this example	string
Building or Firm Name building_or_firm_name	Empty in this example	string
Address Secondary Abbreviation address_secondary_abbreviation	Empty in this example	string
Base Alternate Code base_alternate_code	B	string
LACS Status Indicator lacs_status_indicator	Empty in this example	string
Government Building Indicator government_building_indicator	Empty in this example	string
State Abbreviation state_abbreviation	NY	string
State state	New York	string
Municipality City State Key municipality_city_state_key	Empty in this example	string
Urbanization City State Key urbanization_city_state_key	Empty in this example	string
Preferred Last Line City State Key preferred_last_line_city_state_key	V13916	string
County Name county	Suffolk	string
City Name city	Holtsville	string
City State Name Abbreviation city_abbreviation	Empty in this example	string
Preferred Last Line City State Name preferred_city	Holtsville	string
City State Name Facility Code city_state_name_facility_code	P	string
ZIP Classification Code zip_classification_code	U	string
City State Mailing Name Indicator city_state_mailing_name_indicator	Y	string
Carrier Route Rate Sortation and Merged 5-Digit Indicator carrier_route_rate_sortation	C	string
Finance Number finance_number	353910	number
Congressional District Number congressional_district_number	2	number
County Number county_number	103	number

Every field is documented below.

Essential Elements

line_1 string

Address Line One

The primary delivery line (usually the street address) of the address.

Example 1040 Waverly Ave

line_2 string

Address Line Two

Secondary delivery line of the address. Typically populated if the first line is the firm or building name.

Example Empty in this example

city string

City

A valid city name for mailing purposes; appears in the last line of an address on a mail piece.

Example Holtsville

state string

State

Full name of a state, U.S. territory, or armed forces ZIP Code designation.

Example New York

zip_code string

Zip Code

A 5-digit code that identifies a specific geographic delivery area. ZIP Codes can represent an area within a state, or a single building or company that has a very high mail volume.

Example 00501

Premise

building_or_firm_name string

Building or Firm Name

The name of a company, building, apartment complex, shopping center, or other distinguishing secondary address information. This field is normally used with firm and highrise records but may also contain literals such as “Postmaster” or “United States Postal Service.”

Example Empty in this example

government_building_indicator string

Government Building Indicator

An alphabetic value that identifies the type of government agency at the delivery point and/or whether a firm is the only delivery at an address. For this purpose, "address" is defined as the complete delivery line (e.g., complete street address and, if included as part of the firm record, the secondary abbreviation and/or address secondary number).

• A = City government building - alternates only
• B = Federal government building - alternates only
• C = State government building - alternates only
• D = Firm only - base and alternates
• E = City government building and firm only - alternates only
• F = Federal government building and firm only - alternates only
• G = State government building and firm only - alternates only

Example Empty in this example

Enum

• ""
• "A"
• "B"
• "C"
• "D"
• "E"
• "F"
• "G"

primary_number string

Primary Number

A house, rural route, contract box, or Post Office Box number. The numeric or alphanumeric component of an address preceding the street name. Often referred to as house number.

Example 1040

secondary_number string

Secondary Number

Number of the sub unit, apartment, suite etc

Example Empty in this example

Street

street_name string

Street Names

The official name of a street as assigned by a local governing authority. The Street Name field contains only the street name and does not include directionals (EAST, WEST, etc.) or suffixes (ST, DR, BLVD, etc.). This element may also contain literals, such as PO BOX, GENERAL DELIVERY, USS, PSC, or UNIT.

Example Waverly

street_post_directional_abbreviation string

Street Post Directional Abbreviation

A geographic direction that follows the street name.

Example Empty in this example

street_pre_directional_abbreviation string

Street Pre-Directional Abbreviation

A geographic direction that precedes the street name.

Example Empty in this example

street_suffix_abbreviation string

Street Suffix Abbreviation

Code that is the standard USPS abbreviation for the trailing designator in a street address.

Example Ave

Locality

city_abbreviation string

City Abbreviation

A standard 13-character abbreviation for a city/state name. This field is only used for names that are greater than 13 characters in length and have a city/state mailing name indicator of "Y." If the field is longer than 13 characters and the city/state mailing name indicator is "N," the field will be blank.

Example Empty in this example

city_state_mailing_name_indicator string

City State Mailing Name Indicator

Specifies whether or not the city state name can be used as a last line of address on a mail piece.

• "Y = City/state name is a USPS-approved mailing name."
• "N = City/state name is not approved for mailing purposes."

Example Y

city_state_name_facility_code string

City State Name Facility Code

The type of locale identified in the city/state name. The facility may be a USPS facility, such as a post office, station, or branch, or it may be a non-postal place name. City/state name facility codes include the following:

• B = Branch
• C = Community post office (CPO)
• N = Non-postal community name, former USPS facility, or place name
• P = Post Office
• S = Station
• U = Urbanization

Example P

Enum

• "B"
• "C"
• "N"
• "P"
• "S"
• "U"
• "Y"
• ""

last_line string

Last Line

Last line of the address comprising of city, state, zip code and zip+4

Example Holtsville NY 00501-0001

plus_4_code string

Plus 4 Code

4 digit ZIP add-on code.

Example 0001

preferred_city string

Preferred Last Line City State Name

Field that contains the default preferred or alternate preferred last-line name for a ZIP Code.

Example Holtsville

preferred_last_line_city_state_key string

Preferred Last Line City State Key

In the Carrier Route, Five-Digit ZIP Code, Delivery Statistics, and ZIP + 4 products, an index to the City State product record that provides the preferred last-line name for this address range. In the City State product, the preferred last line city/state key contains the key value of a City State product record that has the default preferred or alternate preferred last-line key for a given ZIP Code.

Example V13916

zip_classification_code string

ZIP Classification Code

A field that describes the type of ZIP area that a 5-digit ZIP Code serves, e.g., a single educational institution, post office boxes only, or a single address that has unusually high mail volume or many different addresses. - M = Military ZIP Code - P = ZIP Code having only Post Office Boxes - U = Unique ZIP Code (ZIP assigned to a single organization) - Blank = Standard ZIP with many addresses assigned to it

Example U

Enum

• ""
• "M"
• "P"
• "U"

zip_code string

ZIP Code

A 5-digit code that identifies a specific geographic delivery area. ZIP Codes can represent an area within a state, or a single building or company that has a very high mail volume.

Example 00501

zip_plus_4_code string

ZIP +4 Code

Nine-digit code that identifies a small geographic delivery area that is serviceable by a single carrier; appears in the last line of the address on a mail piece.

Example 00501-0001

Administrative

county_number string | number

County Number

The Federal Information Processing Standard (FIPS) code assigned to a given county or parish within a state. In Alaska, it identifies a region within the state. If APO/FPO/DPO, and the record type is “S,” “H,” or “F,” the county number will be blank.

Example 103

county string

County

The name of the county or parish in which the 5-digit ZIP Code resides. If APO/FPO/DPO, then the county name will be blank.

Example Suffolk

state_abbreviation string

State Abbreviation

A 2-character abbreviation for the name of a state, U.S. territory, or armed forces ZIP Code designation. If APO/FPO/DPO, then the state abbreviation will be “AA,” “AE,” or “AP.”

Example NY

country_iso string

USPS ISO Country Codes

3 letter country code (ISO 3166-1)

Example USA

Enum

• "ASM"
• "FSM"
• "GUM"
• "MHL"
• "MNP"
• "PLW"
• "PRI"
• "USA"
• "VIR"

country string

Country

Full country names (ISO 3166)

Example United States

Enum

9 possible values

• "American Samoa"
• "Federated States of Micronesia"
• "Guam"
• "Marshall Islands"
• "Northern Mariana Islands"
• "Palau"
• "Puerto Rico"
• "United States"
• "United States Virgin Islands"

Miscellaneous

address_secondary_abbreviation string

Address Secondary Abbreviation

A descriptive code used to identify the type of address secondary range information in the Address Secondary Range field. This code may be useful in address matching, e.g., the secondary address numbers may indicate apartment, suite, or trailer numbers.

Example Empty in this example

base_alternate_code string

Base Alternate Code

Code that specifies whether a record is a base (preferred) or alternate record. Base records (represented as "B") can represent a range of addresses or an individual address, such as a firm record, while alternate records (represented as "A") are individual delivery points. Base records are generally preferred over alternate records. Government deliveries will only be listed on alternate records with the appropriate government building indicator (federal, state, or city) set.

Example B

Enum

• "A"
• "B"
• ""

carrier_route_id string

Carrier Route ID

A 4 character ID identifying the postal route for the address. The first character indicates the route type. Specifically:

• "B" indicates PO Box
• "H" indicates highway
• "C" indicates city
• "G" indicates general
• "R" indicates rural

Example C000

carrier_route_rate_sortation string

Carrier Route Rate Sortation and Merged 5-Digit Indicator

Identifies where automation Carrier Route rates are available and where the commingling of automation and non-automation mail, including Enhanced Carrier Routes and 5-digit presort, on the same pallet or in the same container is allowed.

Example C

congressional_district_number string | number

Congressional District Number

A standard value identifying a geographic area within the United States served by a member of the U.S. House of Representatives. If Army/Air Force (APO), Fleet Post Office (FPO), or Diplomatic/Defense Post Office (DPO), this field will be blank. If there is only one member of Congress within a state, the code will be "AL" (at large).

Example 2

finance_number string | number

Finance Number

A code assigned to Postal Service facilities (primarily Post Offices) to collect cost and statistical data and compile revenue and expense data.

Example 353910

lacs_status_indicator string

LACS Status Indicator

The Locatable Address Conversion Service (LACS) indicator describes records that have been converted to the LACS system (a product/system in a different USPS® product line that allows mailers to identify and convert a rural route address to a city-style address). Rural route and some city addresses are being modified to city-style addresses so that emergency services (e.g., ambulances, police) can find these addresses more efficiently.

• L = LACS address: The old (usually rural-route) address that has been converted for the LACS system.
• Blank = Not applicable

Example Empty in this example

Enum

• ""
• "L"

record_type_code string

Record Type Code

An alphabetic value that identifies the type of data in the record. - G = General delivery (5-Digit ZIP, ZIP + 4, and Carrier Route products) - H = High-rise (ZIP + 4 only) - F = Firm (ZIP + 4 only) - S = Street (5-Digit ZIP, ZIP + 4, and Carrier Route products) - P = PO Box (5-Digit ZIP, ZIP + 4, and Carrier Route products) - R = Rural route/contract (5-Digit ZIP, ZIP + 4, and Carrier Route products) - M = Multi-carrier (Carrier Route product only)

Example S

Enum

• "G"
• "H"
• "F"
• "S"
• "P"
• "R"
• "M"
• ""

update_key_number string

Update Key Number

Field that contains a number that uniquely identifies a record; used to identify the base record to which an add or delete transaction is being directed. The Update Key Number field is used only when applying transactions to the base file; it is not used in address matching and remains fixed for the life of the record. The field is alphanumeric and consists of the database segment code (V1, V2, W1, W2, X1, X2, Y1, Y2, Z1, or Z2) and eight characters containing an alphanumeric value ranging from 00000001 to AAAAAAAA.

Example V124884241

urbanization_city_state_key string

Urbanization City State Key

An index to the City State file that provides the urbanization name for this delivery range.

Example Empty in this example

dataset string

USA Dataset

Identifies the address as sourced from USPS

Example usps

Enum

• "usps"