Proof of Address

This document explains how to enable Proof of Address check in the verification flow and Passbase API

Overview

Increase your assurance during the identity verification process with a Proof of Address document that you can add directly into your workflow. Use the Passbase dashboard to add this Additional Check.

Requesting a proof of address is often part of the process to get to know your customer (KYC) and also supports Customer Identification Program (CIP) requirements in the US. Popular proof of address documents include bank statements, utility bills, and government correspondence, but it is ultimately up to a business to decide what is acceptable.

Enable Proof of Address Check

Within the customization additional checks page, you can enable the Proof of Address check by dragging the Proof of Address tile to the Live Version section. Click the Publish Changes button when complete. Your users will now be prompted to scan the front of their Proof of Address as the final step of the verification flow.

With the Proof of Address feature enabled, all users using a laptop, desktop, or tablet device will automatically be redirected to complete the verification on their mobile device.

Proof of Address API Response

The Proof of Address data for each Verification is accessible using the below Passbase API endpoints. You can find more information about the endpoints in our API explorer, and you can use one of our server-side libraries to interact with the Passbase API.

// List all identities
https://api.passbase.com/verification/v1/identities
‚Äč
// Get identity for a specific id / key
https://api.passbase.com/verification/v1/identities/{id}

The response of the API will have the following parameters:

Response parameters

Parameter

Description

first_names

First names of the user the Proof of Address belongs to

last_name

Last name of the user the Proof of Address belongs to

street_and_house_number

Street and house number of the user the Proof of Address belongs to

more_address_information

More address information of the user the Proof of Address belongs to

city

City of the user the Prof of Address belongs to

country

Country of the user the Proof of Address belongs to

zip_code

Zip code of the user the Proof of Address belongs to

document_origin_country

Document origin country of the user the Proof of Address belongs to

{
"id": "a44c2593-e2ae-4ed9-b81b-c1330580338a",
"status": "approved",
"score": 0.86,
"created": 1621017727,
"updated": 1621143649,
"owner": {
"email": "[email protected]",
"first_name": "JOHN",
"last_name": "DOE"
},
"resources": [
{
"id": "cd7f5b2c-6029-4b7a-bd78-ac343f50edf4",
"status": "processed",
"created": 1621017766,
"updated": 1621017769,
"type": "PASSPORT",
"datapoints": {
"authority": "United States Department of State",
"place_of_birth": "MASSACHUSETTS, U.S.A.",
"nationality": "us",
"sex": "male",
"date_of_expiry": "2017-09-30",
"date_of_issue": "2007-09-30",
"date_of_birth": "2000-01-01",
"face_match_factor": 0.8,
"id_authenticity_factor": 0.94,
"last_name": "Doe",
"first_names": "John",
"country": "US"
},
"resource_files": [...
]
},
{
"id": "79a355ec-0da9-465c-a67d-6b87fb1736eb",
"status": "created",
"created": 1603444534,
"updated": 1603444534,
"type": "PROOF_OF_ADDRESS",
"datapoints": {
"document_origin_country": "us",
"zip_code": "10016",
"country": "us",
"city": "New York",
"more_address_information": "Apt 39C",
"street_and_house_number": "20 W 34th St",
"last_name": "DOE",
"first_names": "JOHN"
},
"resource_files": [...
]
}
],
"watchlist": null,
"metadata": null
}