Address Validation API Documentation


Analyze users with Address Validation scoring through a real-time API call. Instantly detect invalid addresses, misformatted user data and typos, and physical addresses that have recently been reported for fraudulent behavior. Physical Address Verification makes it easy to verify users and validate personal user information.

Address Validation API

Perform Address Verification on any user or transaction with a simple API call. Addresses are verified to ensure the location exists and is valid. Further checks with Fraud Fusion™ perform address reputation scoring to identify data that has been associated with abusive behavior or fraudulent actions.

Scoring Additional User Information

Additional user data such as phone numbers, email addresses, full names, devices, and IP addresses, can also be scored for risk analysis. Please view the Transaction Scoring documentation to learn more.

JSON Address Validation Example API Request

The example below incorporates scoring a physical address with an IP address. It is recommended to pass all billing or shipping variables, or both.

API Lookup with Billing Address Details
The user's primary information should be passed into the "billing" variables even if a transaction is not taking place. Additional user data can be passed with this request.


Key Expected Values Description
billing_address_1 String User's billing or primary street address part 1.
billing_address_2 String User's billing or primary street address part 2.
billing_city String User's billing or primary city.
billing_region String User's billing or primary region or state.
billing_postcode String / Number User's billing or primary postcode or zipcode.
billing_country String User's billing or primary country name or billing country ISO-Alpha2. (EG: United States or US)
shipping_address_1 String User's billing or primary street address part 1.
shipping_address_2 String User's billing or primary street address part 2.
shipping_city String User's billing or primary city.
shipping_region String User's billing or primary region or state.
shipping_postcode String / Number User's billing or primary postcode or zipcode.
shipping_country String User's billing or primary country name or shipping country ISO-Alpha2. (EG: United States or US)
Example Code