Proof of Residency

Jumio Proof of Residency verifies that the physical address on an ID document exists by cross-checking it against government, credit, and commercial data sources worldwide. It then determines whether the person being verified actually resides at the extracted address.

Supported Countries

The following countries are supported by Proof of Residency:

• Australia
• Canada
• France
• Germany
• Italy
• Mexico
• Spain
• United Kingdom
• United States

Supported Credentials

The following values can be uploaded as Prepared Data. Alternatively, they can be extracted by an upstream capability in a workflow.

Key	Type	Mandatory	Description
firstName	string	Yes	First name of the subject.
middleName	string	No	Middle name of the subject.
lastName	string	Yes	Last name of the subject.
email	string	No	Primary email address of the subject.
phoneNumber	string	No	Primary phone number of the subject.
address	object	Yes	Address that contains (address line, city, state, postalCode, subdivision, country)
id.idNumber	string	No	Primary id number on the identity document.

Example Prepared Data Body

{
    "firstName": "Billy",
    "lastName": "Buck",
    "middleName": "Bob",
     "address": {
            "line1": "1835 ne",
            "postalCode": "95051",
            "city": "Malarkey",
            "state": "WA",
            "subdivision": "WA",
            "country": "USA"
       },
}

Response

Response data is available for transactions that include the risk signal. For information on transaction data see View or Retrieve Workflow Transactions.

    "capabilities": {
        "proofOfResidency": [
            {
                "id": "debbccf1-b03f-425d-aa1b-771251dbc465",
                "credentials": [
                    {
                        "id": "07a5046c-21dd-436b-82c3-4fc0a94c636a",
                        "category": "DATA"
                    }
                ],
                "decision": {
                    "type": "REJECTED",
                    "details": {
                        "label": "DENY"
                    }
                },
                "data": {
                    "reasonMessage": "Unknown Street"
                }
            }
        ]
    }

Decision Type	Label	Description
PASSED	OK	Provided data matches DMV data.
REJECTED	DENY	Provided data does not match DMV data.
WARNING	ALERT	Provided data partially matches DMV data.
WARNING	NOT_ENOUGH_DATA	Provided data is insufficient to complete a full verification against DMV records. Please ensure all mandatory fields are properly filled in.
NOT_EXECUTED	UNSUPPORTED_COUNTRY	Provided address.country value is not supported. Must be USA.
NOT_EXECUTED	TECHNICAL_ERROR	Verify the provided data is correct and retry, or contact Support.

Portal View

Open a transaction in the Portal to review the response. The risk signal is labeled Proof Of Residency as shown in the figure below.