Whitepages Pro : Address Validation

ActiveProspect partners with WhitePages Pro to offer their Address Validation API directly through LeadConduit. Upon submitting an address, this integration returns a corrected and standardized address. It also returns additional address details. For example, if available, this will include modifiers, deliverability, whether the address is a business or residence, ZIP+4, and latitude and longitude.


Address Validation

Whitepages Address Validation corrects, validates, appends, and normalizes address information.

If the customer wants to know if an address can receive mail, they should filter on the fields described below in the Validates section.

If the customer wants to correct and normalize the address data being delivered to their marketing systems, they should map the fields described below in the Normalize section to the outbound fields of their deliveries.

If the customer wants to know more about how mail is delivered to an address, they can leverage the data fields mentioned below in the Appends section.

Fields Added to the Flow

  • address_1
  • address_2
  • city
  • state
  • postal_code
  • country


What constitutes a Success? What constitutes a Failure

Success is determined by the HTTP result code == 200, meaning that LeadConduit received a successful API response from Whitepages.

A Whitepages Address Validation step can only be Success or Error or Skip. This integration will never return a Failure.


What constitutes a Skip? What constitutes an Error

The Step will Skip unless the following fields are populated:

  • address_1
  • city
  • state (must also be valid)

- OR -

  • address_1
  • postal_code (must also be valid)

This step will return error:

  • If Whitepages cannot match on the address. Typically this is due to the address information on the outbound being bogus.
  • The error is determined by the HTTP result code != 200, meaning LeadConduit did not receive a successful API response from Whitepages.




Corrects: If a real street address is provided with the correct city and state or correct zip, Whitepages Address Validation will recognize the correct address (fix/append zip based on city & state, fix/append city & state based on a zip code) and return the correct address in the Standard Address fields. If a street address, city, state and zip are provided to the enhancement, and the street address happens to have a typo, this enhancement may correct the typo in the street address. Corrected addresses are provided in the standardized address fields.


Validates: If Whitepages cannot find the address or the API otherwise fails, the step result will return an error. This could potentially be viewed as an invalid/non-existent address, but more likely the address information passed to the API was input incorrectly or is invalid. Validation can also be performed by looking at fields returned by this integration, specifically:

    • Is Receiving Mail - if true, then this indicates that the US Postal Service believes that mail delivered to that address will be collected. If false, then the not_receiving_mail_reason field will be set
    • Is Deliverable - only valid for a LocationType "address". Indicates whether the Postal Service can deliver mail to this address


Appends: Additional data about the address is appended including Lat/Long, Usage (Business or Residential), Delivery Point, and Address Type (these are used to tell more about how mail is delivered to the address).


Normalize: Normalized address information is returned via the Standard Address Line 1, Standard Address Line 2, and Standard Address Location fields. These fields will include appended/corrected address information if any was provided during the lookup. In addition, this integration separates each piece of the address into their own fields. Examples include Pre Dir, Post Dir (directional indicators before or after an address e.g. NW in 123 NW Guadalupe St. == Pre Dir, 123 Guadalupe St. NW == Post Dir), postal code, zip4, etc.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


You must be logged in to comment.