Proof of Address
This document explains how to enable Proof of Address check in the verification flow and Passbase API
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.
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.
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:
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
}