# United States Postal Service Address

## Essential Elements[​](#essential-elements "Direct link to Essential Elements")

### Address Line One[​](#address-line-one "Direct link to Address Line One")

`line_1`string

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

* Example

  `12 Armstrong Ct Apt 12`

### Address Line Two[​](#address-line-two "Direct link to Address Line Two")

`line_2`string

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

* Example

  `9450 Pinecroft Dr`

### City[​](#city "Direct link to City")

`city`string

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

* Example

  `HOLTSVILLE`

### State[​](#state "Direct link to State")

`state`string

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

* Example

  `New York`

### Zip Code[​](#zip-code "Direct link to Zip Code")

`zip_code`string

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

  `1234`

***

## Premise[​](#premise "Direct link to Premise")

### Building or Firm Name[​](#building-or-firm-name "Direct link to Building or Firm Name")

`building_or_firm_name`string

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

  `POSTMASTER`

### Government Building Indicator[​](#government-building-indicator "Direct link to Government Building Indicator")

`government_building_indicator`string

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

- Values

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

### Primary Number[​](#primary-number "Direct link to Primary Number")

`primary_number`string

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

  `A298`

### Secondary Number[​](#secondary-number "Direct link to Secondary Number")

`secondary_number`string

Number of the sub unit, apartment, suite etc

* Example

  `123A`

***

## Street[​](#street "Direct link to Street")

### Street Names[​](#street-names "Direct link to Street Names")

`street_name`string

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

  `GOSHEN`

### Street Post Directional Abbreviation[​](#street-post-directional-abbreviation "Direct link to Street Post Directional Abbreviation")

`street_post_directional_abbreviation`string

A geographic direction that follows the street name.

### Street Pre-Directional Abbreviation[​](#street-pre-directional-abbreviation "Direct link to Street Pre-Directional Abbreviation")

`street_pre_directional_abbreviation`string

A geographic direction that precedes the street name.

### Street Suffix Abbreviation[​](#street-suffix-abbreviation "Direct link to Street Suffix Abbreviation")

`street_suffix_abbreviation`string

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

* Example

  `ST`

***

## Locality[​](#locality "Direct link to Locality")

### City Abbreviation[​](#city-abbreviation "Direct link to City Abbreviation")

`city_abbreviation`string

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

  `W TOWNSHEND`

***

### City State Mailing Name Indicator[​](#city-state-mailing-name-indicator "Direct link to City State Mailing Name Indicator")

`city_state_mailing_name_indicator`string

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."

### City State Name Facility Code[​](#city-state-name-facility-code "Direct link to City State Name Facility Code")

`city_state_name_facility_code`string

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

- Values

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

### Last Line[​](#last-line "Direct link to Last Line")

`last_line`string

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

* Example

  `Greenwich CT 06830-1234`

### Plus 4 Code[​](#plus-4-code "Direct link to Plus 4 Code")

`plus_4_code`string

4 digit ZIP add-on code.

* Example

  `1234`

### Preferred Last Line City State Name[​](#preferred-last-line-city-state-name "Direct link to Preferred Last Line City State Name")

`preferred_city`string

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

* Example

  `AGUADA`

### Preferred Last Line City State Key[​](#preferred-last-line-city-state-key "Direct link to Preferred Last Line City State Key")

`preferred_last_line_city_state_key`string

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[​](#zip-classification-code "Direct link to ZIP Classification Code")

`zip_classification_code`string

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

- Values

  * ""
  * "M"
  * "P"
  * "U"

### ZIP Code[​](#zip-code-1 "Direct link to ZIP Code")

`zip_code`string

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

  `1234`

### ZIP +4 Code[​](#zip-4-code "Direct link to ZIP +4 Code")

`zip_plus_4_code`string

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

  `12345-6789`

***

## Administrative[​](#administrative "Direct link to Administrative")

### County Number[​](#county-number "Direct link to County Number")

`county_number`oneOf

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.

* string

  Empty string \`""\` if not available

* number

  FIPS code

### County[​](#county "Direct link to County")

`county`string

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[​](#state-abbreviation "Direct link to State Abbreviation")

`state_abbreviation`string

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`

### USPS ISO Country Codes[​](#usps-iso-country-codes "Direct link to USPS ISO Country Codes")

`usps_country_iso`string

3 letter country code (ISO 3166-1)

* Values

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

### Country[​](#country "Direct link to Country")

`usps_country`string

Full country names (ISO 3166)

* Values

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

## Miscellaneous[​](#miscellaneous "Direct link to Miscellaneous")

### Address Secondary Abbreviation[​](#address-secondary-abbreviation "Direct link to Address Secondary Abbreviation")

`address_secondary_abbreviation`string

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.

### Base Alternate Code[​](#base-alternate-code "Direct link to Base Alternate Code")

`base_alternate_code`string

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.

* Values

  * "A"
  * "B"
  * ""

### Carrier Route ID[​](#carrier-route-id "Direct link to Carrier Route ID")

`carrier_route_id`string

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

  `R012`

### Carrier Route Rate Sortation and Merged 5-Digit Indicator[​](#carrier-route-rate-sortation-and-merged-5-digit-indicator "Direct link to Carrier Route Rate Sortation and Merged 5-Digit Indicator")

`carrier_route_rate_sortation`string

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.

### Congressional District Number[​](#congressional-district-number "Direct link to Congressional District Number")

`congressional_district_number`oneOf

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).

* string

  Empty string \`""\` if not available

* number

  Congressional district number

### Finance Number[​](#finance-number "Direct link to Finance Number")

`finance_number`oneOf

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

* string

  Empty string \`""\` if not available

* number

  Finance Number

### LACS Status Indicator[​](#lacs-status-indicator "Direct link to LACS Status Indicator")

`lacs_status_indicator`string

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

- Values

  * ""
  * "L"

### Record Type Code[​](#record-type-code "Direct link to Record Type Code")

`record_type_code`string

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)

* Values

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

### Update Key Number[​](#update-key-number "Direct link to Update Key Number")

`update_key_number`string

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

  `00000001`

### Urbanization City State Key[​](#urbanization-city-state-key "Direct link to Urbanization City State Key")

`urbanization_city_state_key`string

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

* Example

  `V18475`

### USA Dataset[​](#usa-dataset "Direct link to USA Dataset")

`usps_dataset`string

Identifies the address as sourced from USPS

* Values

  * "usps"