Data Types

Details about how data is formatted in PDL response objects

The Schema pages contain every available field for each dataset. Each field has a listed type. This page includes additional details about the supported data types.

No Data

Every response object will contain every field listed in the Schema page that the customer has paid for.

If we do not have data for a field, its value will be null unless the field is an Array type, in which case its value will be an empty list [].


Unless otherwise stated in the Schema page for a field, all strings will be lowercase with all leading or trailing whitespace removed.

Enums // Canonical Values

Some fields have a specific set of known values. In the Schema pages, these fields will be marked as type Enum with a link to their known value sets. We call these known values "Canonical Field Values." For more information about Canonical Values or to see the value lists, see this page:


Dates can be accurate to the day (YYYY-MM-DD), the month (YYYY-MM) or the year (YYYY). The most specific date value that we have for a field will be used.

Phone Numbers

All phone numbers will be in in E164 format with a leading + and country code. For example, "+15558675309".


Unless otherwise stated in the Schema page for a field, all currency values are in USD.



We match locations using a strict/fuzzy logic. Our goal is match as many locations as possible to our Location Data entity, linking them based on To tap into our location matching logic, use our Location Cleaner API or retrieve possible location values using our Autocomplete API.


We standardize addresses in the US and Canada using a home-built address parser. We do not conform to any standards such as CASS (which also means that we may have invalid addresses in the data), although we try to imitate them as much as possible.

Common Location Fields

We break location data into the following fields. These names are used throughout our data to refer to location information.

FieldData TypeDescription
nameStringOur cleaned values for locations in the format locality, region, country.
localityStringThe locality of the address
regionStringThe region of the address
metroEnum (String)US ONLY. These are generated based on the census-designated MSAs and maps. Will be one of our Canonical Metros.
countryEnum (String)Standardized format for country. Will be one of our Canonical Countries.
continentEnum (String)Standardized format for continent. Will be one of our Canonical Continents.
street_addressStringThe street address
address_line_2StringThe street address line 2
postal_codeStringThe postal code of the address
geoStringCity-center geo code of a locality, in the format latitude, longitude