Overview
The Address Lookup returns detailed metadata for a given address and includes two map views. For example, if you are using Persona for KYC and need to verify an individual's address to ensure that it's not a post office or elementary school, the Address Lookup Report would help provide the information you're seeking within the dashboard so that you don't have to Google the address to verify it's a legitimate business or residence.
Report Features
![addresslookupreport.png](http://images.ctfassets.net/7fn0srsqjxkr/2jLTdaLwPY3f7W1eT864G8/af28687fe68bdf1309f93a1296b0d8ce/addresslookupreport.gif)
Search Inputs
- Full US address (required)
Report Outputs
There are multiple returned fields for the Address Lookup Report. Below, we've listed all of the fields and their definitions so that you can better understand how to use and interpret the information.
Address Details
Resolved/Corrected address
The fully-formatted and corrected version of the address passed in.
Record type
Represents the type of record this address matched against. Only given if a DPV match is made.
Zip type
Indicates the type of the ZIP code for the address that was matched. Only given if a 5-digit match is made. There are four zip code types:
- Unique: The ZIP code consists of a single delivery point, pertaining to a US Postal Service customer (like a large business or government agency) that routes all of its own mail internally.
- Military: The ZIP code pertains to military units and diplomatic organizations, often in foreign locations.
- PO Box: The ZIP code is a PO Box ZIP code and is assigned to a collection of post office boxes.
- Standard: The ZIP code does not pertain to any of the above categories.
County FIPS
The 5-digit county FIPS (Federal Information Processing Standards) code. It is a combination of a 2-digit state FIPS code and a 3-digit county code assigned by the NIST (National Institute of Standards and Technology).
County name
The name of the county in which the address is located.
Building default indicator
Indicates whether the address is the "default" address for a building; for example, the main lobby.
Latitude
The exact latitude of this address.
Longitude
The exact longitude of this address.
Precision
Indicates the precision of the latitude and longitude values. There are six values that could be returned for precision:
- Zip9: Accurate to a 9-digit ZIP code level (most accurate)
- Zip8: Accurate to an 8-digit ZIP code level
- Zip7: Accurate to an 7-digit ZIP code level
- Zip6: Accurate to an 6-digit ZIP code level
- Zip5: Accurate to an 5-digit ZIP code level
- Unknown: Coordinates not known. Reasons could include: address is invalid, military address (APO or FPO), lat/lon coordinates not available.
Congressional district
The congressional district to which the address belongs. Output will be two digits from 01 - 53 or "AL." "AL" means that the entire state (or territory) is covered by a single congressional district. These include Alaska, Delaware, Montana, North Dakota, South Dakota, Vermont, Wyoming, Washington DC, Virgin Islands, and other territories.
Delivery Details
Residential Delivery Indicator
Residential delivery indicator (residential or commercial).Ā Note: For some reason, known only to the US Postal Service, PO Boxes are always marked as "residential."
There are three indicator types that could be returned:
- Residential: The address is a residential address.
- Commercial: The address is a commercial address.
- [blank]: This happens when the address is invalid or we don't have enough information to ascertain RDI status. The bulk address validation tool translates a [blank] RDI value to "unknown."
Carrier route
The postal carrier route for the address. Consists of a one-letter prefix followed by a three-digit route designator. (e.g., C007, R123). ** Routes C770 through C779 pertain to PO Box Street Addresses.*
There are five carrier route prefixes:
- C: Carrier route (commonly termed "city route")
- R: Rural route
- H: Highway contract route
- B: Post office box section
- G: General delivery unit
DPV match code
Status of the Delivery Point Validation (DPV). This lets you know if the USPS delivers mail to the address. There are two possible returned results for match code:
- Confirmed
- Not confirmed
DPV footnotes
Information related to the delivery point validation of this address.
DPV CMRA
Indicates whether the address is associated with a Commercial Mail Receiving Agency (CMRA), also known as a private mailbox (PMB) operator. A CMRA is a business through which USPS mail may be sent or received, for example, the UPS Store and Mailboxes Etc.
DPV vacant
Indicates that a delivery point was active in the past but is currently vacant (in most cases, unoccupied over 90 days) and is not receiving deliveries. This status is often obtained when mail receptacles aren't being emptied and are filling up, so mail is held at the post office for a certain number of days before the delivery point is marked vacant.
Active
Indicates whether the address is active or not, based on USPS data. Note that the USPS is often months behind in updating this data point, so use with caution. Some users may prefer not to base any decisions on the active status of an address.
Footnotes
Indicates which changes were made to the input address.
Time Zone Details
Time zone
Indicates the common name of the time zone associated with the address. Valid time zones include: Alaska, Atlantic, Central, Eastern, Hawaii, Mountain, None, Pacific, Samoa, UTC+9, UTC+10, UTC+11, UTC+12.
UTC offset
Indicates the number of hours the time zone is offset from Universal Time Coordinated (UTC), the international time standard, also known as Greenwich Meridian Time (GMT).
Observes daylight savings time
Indicates if the time zone "obeys," or, in other words, adjusts their clocks forward and back with the seasons. This information is particularly useful to determine time in other time zones with areas that may or may not use daylight saving time - for example, Arizona, Hawaii, and Indiana.
Mailing Details
LACSLink Code
The reason for the LACSLink indication that was given. The LACSLink Product is a secure dataset of converted addresses that primarily arise from the implementation of the 911 system, which commonly involves changing rural-style addresses to city-style addresses. The LACSLink Product also contains existing city-style addresses that have been renamed or renumbered.
There are 6 reason codes:
- A: Match. Address provided. LACSLink record match was found, and a converted address was provided
- 00: No match. No converted address. No soup for you!
- 09: Match. No new address. LACSLink matched an input address to an old address which is a "high-rise default" address; no new address was provided.
- 14: Match. No conversion. Found a LACSLink record, but couldn't convert the data to a deliverable address.
- 92: Match. Dropped secondary number. LACSLink record was matched after dropping the secondary number from input.
- [blank]: No LACSLink lookup attempted.
LACSLink indicator
Indicates whether there is an address match in the LACSLink database.
Suitelink match
Indicates a match (or not) to the USPS SuiteLink data. SuiteLink attempts to provide secondary information such as "suite" or "apartment" whenever there is a match based on address and company name.
Notifications
The best way to be notified immediately of a match on the Address Lookup Report is to set up a webhook listening for the event type: report/address-lookup.ready
.
Configuration Options
There is no configuration option available for this report type.
Plans Explained
Startup Program | Essential Plan | Growth and Enterprise Plans | |
---|---|---|---|
Address Lookup Report | Not Available | Available | Available |
Learn more about pricing and plans
Disclaimer
Persona is not a consumer reporting agency and the services (and the data provided as part of its services) do not constitute a āconsumer reportā for the purposes of the Federal Fair Credit Reporting Act (FCRA). The data and reports we provide to you may not be used, in whole or in part, to: make any consumer debt collection decision, establish a consumerās eligibility for credit, insurance, employment, government benefits, or housing, or for any other purpose authorized under the FCRA. If you use any of any of our services, you agree not to use them, or the data, for any purpose authorized under the FCRA or in relation to taking an adverse action relating to a consumer application.