What does the address object contain, and when are the USPS fields populated?

Every address Baselayer returns, whether the business’s primary address, an entry in its address list, a registration address, or a registered agent’s address, uses the same structured object. It contains:

• The parsed street components: primary number, street name and suffix, pre and post directions, secondary designator and number (suite, apartment), and private mailbox designator and number.

• City, two-letter state, five-digit ZIP code, and the four-digit ZIP extension.

• Latitude and longitude.

• Four USPS indicators: deliverable (whether USPS delivers to it), rdi (the Residential Delivery Indicator, residential or commercial), cmra (whether it is a Commercial Mail Receiving Agency such as a mailbox store), and delivery_type.

delivery_type takes one of a fixed set of USPS values: street, high-rise, PO box, rural route, general delivery, firm, or military. A PO box or a CMRA is a common signal that a business has no physical location at the address it gave.

When the USPS fields are populated. They are filled in when the address validates against USPS data, which is the case for most US street addresses. They are null when the address could not be validated, for example an incomplete or non-US address, or when the source record carried only a partial address. Latitude and longitude follow the same rule; a coordinate pair of zero and zero means the address was not geocoded rather than a real location.