Proof of Address Check

Search…
Run a proof of address check
To run a Proof of Address Check, you must create a check with type set to proof_of_address_check.
This check can only be performed on a client of type person. Furthermore, the documentId provided must have associated image attachments that adhere to our image specifications.
​Learn more about Proof of Address Checks.
We will use the front side of the document for the Proof of Address Check.
Proof of address check request
Attribute
Type
Description
clientId
string
The ID of the client associated with this check. (Required)
type
string
This must be set to proof_of_address_check. (Required)
documentId
string
The ID of the document. (Required)
Example request
cURL
Node.js
Python
PHP
.NET
curl -X POST https://api.complycube.com/v1/checks \
     -H 'Authorization: <YOUR_API_KEY>' \
     -H 'Content-Type: application/json' \
     -d '{
          "clientId":"CLIENT_ID",
          "documentId":"DOCUMENT_ID",
          "type": "proof_of_address_check"
        }'
const check = await complycube.check.create("CLIENT_ID", {
        documentId: "DOCUMENT_ID",
        type: "proof_of_address_check"
});
check = cc_api.check.create('CLIENT_ID', 
                                'proof_of_address_check', 
                                documentId='DOCUMENT_ID')
$result = $ccapi->checks()->create('CLIENT_ID',
                                   ['type' => 'proof_of_address_check',
                                   'documentId' => 'DOCUMENT_ID',
                                   'addressId' => 'ADDRESS_ID']);
var checkRequest = new CheckRequest
                    {
                        clientId = "CLIENT_ID",
                        documentId = "DOCUMENT_ID",
                        addressId = "ADDRESS_ID",
                        type = "proof_of_address_check"
                    };
​
var check = await checkApi.CreateAsync(checkRequest);
Result object
The result object is only returned when the status of the check is complete . It has two components - outcome and breakdown.
Outcome
The outcome attribute represents the overall check result. Returned values include:
1.clear: Indicates every analysis conducted returned a successful result, and hence the proof of address document is valid.
2.attention: Indicates at least one of the analysis results requires attention.
Breakdown
The breakdown comprises the following objects:
extractedData object
The data extracted using Optical Character Recognition (OCR). It has the following constituents:
documentDetails: Data relating to the document.
documentType: The detected document type. Values include: 
bank_statement
driving_license
utility_bill
tax_document
​
issuer: The document issuing vendor.
issuingDate: The issuing date of the document. This will be a structured date.
​
holderDetails : Data relating to the document holder.
entityName: The full extracted name of the document holder.
​
addressDetails : Data relating to the extracted address.
addressLine: The extracted address line as a string.
addressCountry: The address country. This will be the two-letter country ISO code.
address: This will be the structured address, which includes the following:
propertyNumber: The property number.
building: The building name.
line: The address line.
city: The address city.
state: The address state.
postalCode: The address postal code.
country: The address country. This will be the two-letter country ISO code.
latLong: The address latitude and longitude geographic coordinates.
Analysis
For each conducted analysis, the returned values include:
1.clear: Indicates the analysis returned a successful result.
2.attention: Indicates a potential falsified or fraudulent document. 
3.not_processed: Returned when ComplyCube is not able to process the document. This can occur due to a number of reasons, including:
The document image is invalid
The document image is of poor quality and therefor unreadable
clientValidation object
The client validation results. It has the following constituents::
firstName: Indicates whether the client provided first name matches the extracted entity name.
lastName: Indicates whether the client provided last name matches the extracted entity name.
address: Indicates whether any of the client provided addresses match the extracted address.
contentAnalysis object
The content analysis results. It has the following constituents:
documentAge: Indicates the document had expired (when it's a Driving License) or is older than 3 months when it's a Bank Statement, Utility Bill, or Tax Document.
geolocationAnalysis object
The geolocation analysis results. It has the following constituents:
ipInAddressCountry: Indicates the geolocation of the client IP address resides in the extracted address country. 
ipProximityToAddress: Indicates the geolocation of the client IP address is within a reasonable distance from the extracted address country. 
Sample Response
{
   "id": "614cfa9460fe4700098f3af9",
   "entityName": "John Doe",
   "type": "proof_of_address_check",
   "clientId": "5e94b75d01bce00008c86f02",
   "documentId": "6149f415cb31190008991526",
   "status": "complete",
   "result": {
      "outcome": "clear",
      "breakdown": {
         "extractedData": {
            "holderDetails": {
               "entityName": "John Doe"
            },
            "documentDetails": {
               "documentType": "bank_statement",
               "issuer": "Barclays Bank",
               "issuingDate": {
                  "day": 25,
                  "month": 1,
                  "year": 2021
               }
            },
            "addressDetails": {
               "address": {
                  "propertyNumber": "323",
                  "line": "Common street",
                  "city": "Aldgate",
                  "state": "London",
                  "postalCode": "W99 0RD",
                  "country": "GB",
                  "latLong": "51.5136,-0.077188"
               },
               "addressLine": "323 Common Street Aldgate London W99 0RD",
               "addressCountry": "GB"
            }
         },
         "clientValidation": {
            "firstName": "clear",
            "lastName": "clear",
            "address": "clear"
         },
         "contentAnalysis": {
            "documentAge": "clear"
         },
         "geoLocationAnalysis": {
            "ipInAddressCountry": "clear",
            "ipProximityToAddress": "clear"
         }
      }
   },
   "createdAt": "2021-04-04T17:25:21.116Z",
   "updatedAt": "2021-04-04T17:25:33.116Z"
}