Risk Signal: Proof of Residency

Jumio Proof of Residence checks with government, credit and commercial data sources from around the world to corroborate that the physical address on an ID document exists. Jumio then determines if the person being verified online actually lives at the extracted address.

The following countries are support by Proof of Residency today:

  • 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

Yes

 Middle name of the subject.

lastName

string

Yes

 Last name of the subject.

email

string

Yes

Primary email address of the subject.

phoneNumber

string

Yes

Primary phone number of the subject.

address

object

Yes

 

id.idNumber

string

 

Primary id number on the identity document.
Copy
Example Prepared Data Body
{
    "firstName": "Billy",
    "lastName": "Buck",
    "middleName": "Bob",
    "email": "billybuckbob@gmail.com",
    "phoneNumber": "6441234567",
     "address": {
            "line1": "1835 ne",
            "postalCode": "95051",
            "city": "Malarkey",
            "state": "WA",
            "subdivision": "WA",
            "country": "USA"
       },
    "id": {
        "idNumber": "abc123"                
    }
}        

Response

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

Response Structure

Copy
Proof of Residency Response Example
    "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 Details Labels

Decision Type

Label

Description

PASSED

OK

 

REJECTED

DENY

  

WARNING

ALERT

  

WARNING

NOT_ENOUGH_DATA

  

NOT_EXECUTED

UNSUPPORTED_COUNTRY

  

NOT_EXECUTED

TECHNICAL_ERROR

 

Portal View

Open a transaction in the Portal to review the response. The risk signal is labeled Address Validation as shown in the figure below.