Scanning Basic

Instantly scan an identity document for validation purposes. You can also match your customer to the document and have the document details returned to your application.

What is the difference between basic and enhanced?

Please see the table below for a list of features to decide which option fits your business best.

Feature	basic	enhanced
Data Extraction	yes	yes
Expiration Check	yes	yes
Age Check	yes	yes
Target Data Matching	yes	yes
Automatically Recognizes Document Type	no	yes
Automatically Recognizes Document Region	no	yes
Enhanced Security Checks	no	yes
Selfie Matching	no	yes
Expanded International Coverage	no	yes

DCAMSPLUS5.0

POST https://docs.idresponse.com/process/comprehensive/gateway

Send a POST request with target parameters along with the document image(s) to receive the verification result.

Request Body

Name	Type	Description
user	string	Your account's API username
pass	string	Your account's API password
service	string	The service name (DCAMSPLUS5.0)
rules	string	The rule set name (if left empty then the base rule set will be used)
reference	string	A unique identifier for your customer
target	object	The individual being sent for verification
fn	string	The target's first name
ln	object	The target's last name
addr	string	The target's street address (line 1 and line 2)
city	string	the target's city
state	string	The target's state
zip	string	The target's zip
dob	string	The target's Date of Birth (YYYYMMDD format)
license	object	The target's document images and other parameters.This is not required if you send the passport object
front	string	The target's front document image
back	string	The target's back document image
state	string	The document's state.Only applicable for US documents. If included it can speed up processing times.
region	string	The document's region. If this is left empty then United States will be assumed. To verify a document outside of the United States you must include this attribute. Acceptable values are:Asia Australia Africa Canada Europe Oceania South America United States
passport	object	The target's passport image.Only required if you are not sending the license object
age	string	The age to check (must be sent like "age+" i.e. "18+", "21+" etc.)
test_key	string	The test key value that you are using to test

200 Transaction processed and result returned

{
    "output": {
        "documents": { //this is the test case data in the system. So, when you use the test_key dcams_pass this si what will be returned.
            "FirstName": "LOUISA",
            "LastName": "SAMPLE",
            "MiddleName": "ANNA",
            "Address": "109 S FOSTER RD",
            "City": "BATON ROUGE",
            "State": "LA",
            "Zip": "70808",
            "DateOfBirth": "19720629",
            "Height": "5-08",
            "Sex": "F",
            "EyeColor": "BRN",
            "DocumentNumber": "003009381",
            "IssueDate": "20140714",
            "ExpirationDate": "20300629",
            "CountryCode": "USA", // (ISO Alpha 2 or 3)
            "DocumentType": "DRIVERS LICENSE", // other values are PASSPORT, IDENTITY CARD and UNKNOWN
            "Confidence": 100
        }
    },
    "meta": {
        "confirmation": 96095474,
        "reference": "12345",
        "service": "DCAMSPLUS5.0",
        "timestamp": "2020-07-08 14:49:19",
        "company": "Company ABC, Inc.",
        "user": "[e-mail]"
    },
    "result": {
        "action": "PASS",
        "detail": "ALL CHECKS PASSED",
        "issues": []
    }
}

Sample Request Body

{
  "user": "[e-mail]",
  "pass": "PASSWORD",
  "service": "DCAMSPLUS5.0",
  "reference": "12345",
  "rules": "additional matching rules",
  "target": {
    "license": { // this object will accept any identity document except a passport i.e. driving license or identity card.
      "front": "base64 encoded image file",
      "back": "base64 encoded image file",
      "state": "CT",
      "region": "United States"
    },
    "passport":{
      "front": "base64 encoded image file"
    },
    "age": "21+",
    "fn": "John",
    "ln": "Smith",
    "dob": "19870621",
    "test_key": "dcams_pass"
  }
}

If you send both the license and passport objects the system will prefer the license and ignore the passport.If you want to verify a passport please remove the license object and only send the passport object.

Test Keys

Use the test_key attribute to test the service. When the test_key is provided the system will return a known canned response (regardless of the image submitted) and these transactions are free of charge.

test_key	description
dcams_pass	Will return a PASS action result
dcams_fail_expired	Will return a FAIL action result

If you are using one of the matching rule sets and want to force a REVIEW then use the dcams_pass case and change the input target attributes to something other than the target returned.

For example, the test case's first name is LOUISA, so to get a FIRST NAME DOES NOT MATCH THE DOCUMENT issue just change the target's first name to something other than LOUISA.

Action and Detail Responses

The following are all values that will be returned in the result object of the response.

action	detail	description
FAIL	NOT A VALID DOCUMENT	We can not detect the image as a valid identity document
FAIL	DOCUMENT NOT VERIFIED	We have detected an identity document, but the confidence level is below the threshold
FAIL	DOCUMENT IS EXPIRED	The document's expiration date is in the past
FAIL	DOCUMENT AGE CHECK FAILED	The Date of Birth on the document does not meet the minimum age requirement
REVIEW	TRANSACTION REQUIRES FURTHER ATTENTION	One of the matching rules was not met (this only happens when using an additional rule set)
PASS	ALL CHECKS PASSED	The document is valid, is not expired, the Date of Birth meets the minimum age requirement and additional matching rules all passed.

Issues Responses

When a transaction returns as REVIEW then there will be a list of issues. This list can include any of the below values. For this service the REVIEW action will only return if you are not using the base rule set.

Issue	Description
FIRST NAME DOES NOT MATCH THE DOCUMENT	The target's first name does not match the first name discovered on the document
LAST NAME DOES NOT MATCH THE DOCUMENT	The target's last name does not match the last name discovered on the document
DOB DOES NOT MATCH THE DOCUMENT	The target's DOB does not match the DOB discovered on the document
ADDRESS DOES NOT MATCH THE DOCUMENT	The target's address does not match the address discovered on the document
STATE DOES NOT MATCH THE DOCUMENT	The target's state does not match the state discovered on the document

Rules

DCAMSPLUS5.0 will process with the default base ruleset unless a below rule set value is supplied:

The base ruleset will return a PASS when:

• The document is valid

• The document is not expired

• The Date of Birth on the document meets the age requirement

The base ruleset will return a REVIEW when:

• The base rule set is not used

• One or more of the target attributes do not match the document.

The base ruleset will return a FAIL when:

• The document is not valid

• The document is expired

• The Date of Birth on the document does not meet the age requirement

Additional Rule Sets

You can set a new rule set.

Rule Set Name	Description
DCAMS5_0_RuleSet_NAME_DOB	Base Ruleset + Name and DOB on target must match the document
DCAMS5_0_RuleSet_NAME	Base Ruleset + Name on target must match the document
DCAMS5_0_RuleSet_NAME_ADDR	Base Ruleset + Name and Address on target must match the document
DCAMS5_0_RuleSet_NAME_STATE	Base Ruleset + Name and State on target must match the document
DCAMS5_0_RuleSet_NAME_STATE_DOB	Base Ruleset + Name, State and Date of Birth on target must match the document
DCAMS5_0_RuleSet_NAME_ADDR_DOB	Base Ruleset + Name, Address and Date of Birth on target must match the document

If you do not see a rule set that you would like to use -- please just ask. We can always create a new rule set for your business purpose.

Helpful Information

• The total payload may not exceed 10 MB in size.

• The minimum image size is 400 pixels on each side of the document

• For the best results ensure:

  • The image is not blurry

  • There is no glare

  • The document takes up at least 80% of the image

  • The edges are not cut off

  • The document is on a flat surface