# address # address A physical location, described down to the components a postal system and a legal description each need. An address describes a physical location described in terms of street address, city, state, region, province, country and other geo-location references. ## Why it matters The widest class in the model, because an address has to satisfy several consumers at once: postal delivery, legal description, geocoding, and the jurisdiction lookups that tax and title depend on. Components are separate properties rather than lines of text. A line is enough to print a letter and not enough to match two records, and matching is the operation that actually gets performed. ## Properties | Property | Type | Definition | | --- | --- | --- | | `address_format_type` | `string` | Address format type refers to the different conventions or standards used to structure and format addresses in various countries or regions. | | `address_line_1` | `string` | Address line 1 is the first line of the address where the primary information for locating a specific location or recipient is provided. | | `address_line_2` | `string` | Address line 2 is the second line of the address where the primary information for locating a specific location or recipient is provided. | | `address_line_3` | `string` | Address line 3 is the third line of the address where the primary information for locating a specific location or recipient is provided. | | `address_type` | `enumeration` | Address type is a classification or categorization of an address based on its purpose or characteristics. `as_shown_on_tax_return``corporate_headquarters``current``legal_entity_formation``mailing``other``primary``prior` | | `address_type_other_description` | `string` | If an address type is 'other,' address type other description provides more details on the address type. | | `address_unit_designator_type` | `enumeration` | Address unit designator type describes the category that a specific unit belongs to. `apartment``basement``building``condo``department``floor``front``hangar``key``lobby``lot``lower``office``penthouse``pier``rear``room``side``space``stop``suite``trailer``unit``upper` | | `attention_to_name` | `string` | An attention to name on an address is an optional line that can be included in an address to indicate the name of a specific person or department within an organization to whom the mail is intended. | | `carrier_route_code` | `string` | A carrier route code is a unique identifier assigned by the United States Postal Service (USPS) to a specific mail delivery route or group of addresses serviced by a single mail carrier. | | `cbsa_code` | `string` | A CBSA code is a Canada Border Services Agency (CBSA) code, which is a unique identifier assigned to specific ports, airports, or border crossing points in Canada. The CBSA code helps facilitate the import/export process and customs clearance activities at these designated locations. | | `city_name` | `string` | City name refers to the name of the city in which the address is located. | | `country_code` | `string` | Country code is a code that represents the country in which the address is located. | | `country_name` | `string` | Country name refers to the country where a person resides. | | `county_code` | `string` | County code is a code that represents the county in which the address is located. | | `county_name` | `string` | A property county name refers to the name of the county in which a property is located. In the United States, counties are geographic and political subdivisions of states, typically governed by a county government. Each county is identified by a unique name and is responsible for providing certain public services to residents, such as law enforcement, public schools, and infrastructure maintenance. | | `created_datetime` | `dateTime` | Created_datetime describes when an address was created in a system. | | `delivery_point_bar_code` | `dateTime` | A Delivery Point Barcode (DPBC) is a barcode used by the United States Postal Service (USPS) to facilitate the automated sorting and delivery of mail. It contains encoded information that helps identify the specific delivery point or address to which mail should be delivered. | | `delivery_point_bar_code_check` | `dateTime` | A Delivery Point Barcode (DPBC) check is a verification process used to ensure the accuracy and validity of a Delivery Point Barcode, which is a barcode used by the United States Postal Service (USPS) to automate the sorting and delivery of mail. | | `full_address` | `string` | A full address includes all the necessary information to identify and locate a specific location or recipient. | | `highway_contract_route_identifier` | `string` | A highway contract route (HCR) identifier is a unique code assigned to a specific highway contract route used for mail transportation by the United States Postal Service (USPS). | | `last_updated_datetime` | `dateTime` | Last_updated_datetime describes when an address was last updated in a system. | | `mail_stop_code` | `string` | A mail stop code, also known as a mail code or department code, is a unique identifier used within an organization to facilitate the sorting and delivery of internal mail or correspondence. It is primarily used in large organizations where there may be multiple departments or units located in the same physical location. | | `plus_four_postal_code` | `string` | A postal code plus four, also known as a ZIP code plus four (in the United States) is a numerical extension to a postal code. | | `post_office_box_identifier` | `string` | A post office box identifier refers to the unique number or alphanumeric code assigned to an individual or organization's post office box (PO Box) for receiving mail at a post office facility. | | `postal_code` | `string` | A postal code, also known as a ZIP code (in the United States) or postcode (in many other countries), is a numerical code used by postal services to identify specific geographic areas for efficient mail sorting and delivery. | | `rural_route_box_identifier` | `string` | A rural route box identifier, also known as an RR box identifier, is a number or alphanumeric code assigned to a mailbox or mail receptacle on a rural route. | | `rural_route_identifier` | `string` | A rural route identifier, also known as an RR identifier, is a number or alphanumeric code assigned to a specific rural route for mail delivery. In rural areas, where homes and businesses are often spread out over long distances, a rural route is a designated path followed by mail carriers to deliver mail to multiple addresses along that route. | | `sequence_number` | `string` | A license sequence number is a unique numerical identifier assigned to license within a specific sequence or order. It is used to indicate the position or sequence of a license within a given range or list. | | `state_code` | `string` | State code is a code that represents the state in which the address is located. | | `state_name` | `string` | State name refers to the name of the state in which the address is located. | | `street_name` | `string` | A street name is the name of a street on which an address is located. | | `street_post_directional_text` | `string` | Street post directional text refers to the directional indicator or suffix added to a street name to provide additional information about the direction or orientation of the street segment. It helps to clarify the position of a particular street in relation to other streets or landmarks in a given area. | | `street_pre_directional_text` | `string` | Street pre directional text refers to the directional indicator or prefix added to a street name to provide additional information about the direction or orientation of the street segment. It helps to clarify the position of a particular street in relation to other streets or landmarks in a given area. | | `street_primary_number` | `string` | Street primary number refers to the numerical part of a street address that indicates the specific location or position of a building or property along a street. | | `street_suffix` | `string` | A street suffix, also known as a street type or street name suffix, is a word or abbreviation that follows the street name in an address, indicating the type or category of the street (e.g., Drive, Circle, Boulevard). | | `unit_identifier` | `string` | A unit identifier is a reference to the specific unit, suite, apartment, or other secondary identifier associated with an address. It is used to differentiate individual units within a larger building or complex. |