AI Proof of Address (PoA) Verification

AI Proof of address verification can be performed via API. The service uses Utility bill COMPARE credits. More information about COMPARE method - Value explanation -> type -> COMPARE.

Request

Send a HTTP POST request to: https://ivs.idenfy.com/api/v2/poa-checks/

Possible values:

Key	Required	Type	Explanation
file	Yes	String	Base64 encoded document file. Can be: jpeg, jpg, png, gif, webp, heic, heif, pdf files.
providedName	No	String	Full name of the user. It will be compared against the data retrieved from the PoA document if fullName was provided.
providedAddress	No	String	Address of the PoA verification. It will be compared against the data retrieved from the PoA document if address was provided.

Example request:

{
  "file": "iVBORw0KGgoAAAANSUhEUgAAAxoAAAC6CAYAAAApyZWVuc2hvdO8Dvz4AAAA[...]",
  "providedName": "John Smith",
  "providedAddress": "4344 Poco Mas Drive, Dallas, FL, 33009"
}

Response

note

Below mentioned values could be returned as null if PoA document is invalid and/or not recognizable.

Key	Type	Explanation
id	String	PoA check ID.
created	String	Timestamp when PoA check was created.
updated	String	Timestamp when PoA check was updated.
issueDate	String	Issue data retrieved from the PoA document.
documentType	String	Document type retrieved from the PoA document.
hasLogo	Boolean	Boolean describing if document has logo.
nameMatch	Boolean	Boolean describing if provided name/surname matches name/surname on the document.
addressMatch	Boolean	Boolean describing if provided address matches address on the document.
dateValid	Boolean	Boolean describing if provided document is not older than 3 months.
overallStatus	String	Possible values: MATCH, NO_MATCH, NOT_COMPARED
name	String	Full name retrieved from the PoA document.
address	String	Address retrieved from the PoA document.
partner	Object	Partner environment related information.
fileType	String	Type of the file that was provided for the check.
providedName	String	Provided name value when check was initiated.
providedAddress	String	Provided address value when check was initiated.
file	String	URL to download the file.

Example response:

{
  "id": "aa4e1453-abc0-4649-84ab-d6a65984329b",
  "created": "2024-10-21T06:10:31.559212Z",
  "updated": "2024-10-21T06:10:31.559246Z",
  "issueDate": "2021-11-15",
  "documentType": "Electricity bill",
  "hasLogo": true,
  "nameMatch": false,
  "addressMatch": true,
  "dateValid": false,
  "overallStatus": "NO_MATCH",
  "name": "Leslie Holden",
  "address": "4344 Poco Mas Drive Dallas, FL, 33009",
  "partner": {
    "id": 2253,
    "created": "2023-10-11T14:09:40.458303Z",
    "companyName": "iDenfy Techsupport TEST",
    "environment": "TESTING",
    "isActive": true
  },
  "fileType": "png",
  "providedName": "John Smith",
  "providedAddress": "4344 Poco Mas Drive, Dallas, FL, 33009",
  "file": "https://s3.eu-west-1.amazonaws.com/[...]"
}