API ReferenceChangelogDashboard ->

Global Address Verification

Global address check ensures the legitimacy of customer residence information by cross-referencing trusted global sources. This feature not only eliminates the need for supporting documents, but also streamlines the user experience, reducing friction and speeding up processing time. The result is an increase in genuine user conversions.

Supported countries

The following is a list of countries for which Global Address Verification is available.

CountryCountry codeRequired fieldsRecommended fieldsOptional fieldsSupported verification methods
AustraliaAUSFirst name
Last name
Date of birth
Street
Postal code		National ID number (Passport, Residence Permit, Driver's License)
Phone number
Additional street information
Building number
Town/city
State/province		1x1
2x2
AustriaAUTFirst name
Last name
Street
Postal code		Date of birth
Additional street information
Building number
Town/city
State/province		1x1
2x2
BelgiumBELFirst name
Last name
Date of birth
Street
Postal code		Phone number
Additional street information
Building number
Town/city
State/province		1x1
2x2
CanadaCANFirst name
Last name
Phone number
Street
Postal code		Date of birth
National ID number (Canadian Social Insurance Number)
Additional street information
Building number
Town/city
State/province		1x1
2x2
ChinaCHNFirst name
Last name
National ID number (ID card)
Phone number
Street
Postal code		1x1
2x2
DenmarkDNKFirst name
Last name
Date of birth
National ID number (CPR)
Street
Postal code		Additional street information
Building number
Town/city
State/province		1x1
2x2
FinlandFINFirst name
Last name
Date of birth
National ID number
Street
Postal code		Additional street information
Building number
Town/city
State/province		1x1
2x2
FranceFRAFirst name
Last name
Street
Postal code		Date of birthPhone number
Additional street information
Building number
Town/city
State/province		1x1
2x2
GermanyDEUFirst name
Last name
Street
Postal code		Date of birth
Phone number
Additional street information
Building number
Town/city
State/province		1x1
2x2
ItalyITAFirst name
Last name
Date of birth
Street
Postal code		Phone number
Additional street information
Building number
Town/city
State/province		1x1
2x2
NetherlandsNLDFirst name
Last name
Date of birth
Street
Postal code		Phone number
Additional street information
Building number
Town/city
State/province		1x1
2x2
NorwayNORFirst name
Last name
Date of birth
National ID number
Street
Postal code
Phone number		Additional street information
Building number
Town/city
State/province		1x1
PhilippinesPHLFirst name
Last name
Date of birth
National ID number
Street
Postal code
Phone number		Additional street information
Building number
Town/city
State/province		1x1
2x2
PolandPOLFirst name
Last name
Date of birth
National ID number (PESEL)
Street
Postal code		Additional street information
Building number
Town/city
State/province		1x1
SingaporeSGPFirst name
Last name
Date of birth
National ID number
Street
Postal code		Additional street information
Building number
Town/city
State/province		1x1
SpainESPFirst name
Last name
Street
Postal code		National ID number (NIF - DNI/NIE)
Date of birth		Additional street information
Building number
Town/city
State/province		1x1
2x2
SwedenSWEFirst name
Last name
Date of birth
National ID number (Swedish SSN)
Street
Postal code		Phone number
Additional street information
Building number
Town/city
State/province		1x1
2x2
ThailandTHAFirst name
Last name
Date of birth
National ID number
Street
Postal code		Additional street information
Building number
Town/city
State/province		1x1
TurkeyTURFirst name
Last name
Date of birth
National ID number
Street
Postal code		Additional street information
Building number
Town/city
State/province		1x1
UKGBRFirst name
Last name
Street
Postal code		Phone number
Additional street information
Building number
Town/city
State/province		1x1
2x2

Get started

To get started with Database Address Verification:

  1. Set up the WebSDK or MobileSDK integration. You can also start with our API.
  2. Enable Global Address Verification and configure verification settings by reaching out to your Customer Success Manager or Support team.
  3. Set up a verification level and add the Applicant data step.
  4. Include the Required fields as specified in the table and add Recommended/Optional fields to increase positive impact on pass rates. Note that the National ID number field must be configured as a custom field with the documentNumber field name.
  5. Submit the applicant data via SDKs or API.
  6. Receive verification results.

Submit applicant data

To submit the applicant data via API:

  1. Create an applicant with the levelName which will be used for the check (a verification level must contain the Applicant Data step).
  2. Provide the required information according to the Supported countries table.
  3. Request an applicant check.

📘

Info

All the required fields and country code must be provided in the fixedInfo object, as described in the this article, except for the National ID number. The National ID number must always be provided in the metadata array with the documentNumber key.

Example request:

curl -X POST \
    'https://api.sumsub.com/resources/applicants?levelName=global-address-verification' \
    -H 'Content-Type: application/json' \
    -d '{
            "externalUserId" : "someUniqueUserId",
            "metadata": [
                {
                    "key": "documentNumber",
                    "value": "12345678A"    // National ID number
                }
            ],
            "fixedInfo": {
                "firstName": "John",    // First name
                "lastName": "Doe",      // Last name
                "dob": "1990-01-01",    // Date of birth
                "country": "ESP",       // Country code in alpha-3 format
                "phone": "+34 123 456 789",     // Phone number
                "addresses": [
                    {
                        "street": "C. Ramon J Sender",  // Street name
                        "buildingNumber": "7A",         // Building number
                        "town": "Cartagena",            // Town/city
                        "state": "Murcia",              // State/province
                        "postCode": "30204",            // Postal Code
                        "country": "ESP"                // Country code in alpha-3 format
                    }
                ]
            }
        }

Get verification results

Once the check is performed, you will receive a webhook with the verification status:

  • The reviewResult field contains extra verification information.
  • The reviewAnswer field contains a final answer:
    • If the address verification was completed successfully, the reviewAnswer field will be set to GREEN.
    • If the check fails, the reviewAnswer field will be set to RED and reviewRejectType will be set to RETRY.

Updated 5 days ago