With KBA Quiz
Age verification via trusted and verified data sources in the United States. This service will also return a KBA quiz for verification.
post
https://production.idresponse.com
/process/comprehensive/gateway
AgeMatch5.0.KBA
Use the test_key attribute to test the service. When the test_key is provided the system will dynamically drop the live data sources and use the testing database. These transactions are free of charge. To access live data do not send this attribute. The below sample request is one of the available test cases. To access more click the link below.

Sample Request Body

This is the initial query to get the quiz. See below example of how to submit the answers for final scoring and evaluation.
{
"user": "USERNAME",
"pass": "PASSWORD",
"service": "AgeMatch5.0.KBA",
"rules": "A_RULESET_ID",
"reference": "12345 {A UNIQUE ID}",
"target":{
"fn":"Barbara",
"ln": "Miller",
"addr": "123 Main St",
"city": "Stratford",
"state": "CT",
"zip": "06614",
"dob": "19740821",
"ssn": "854125698",
"phone": "2015106000",
"email": "[email protected]",
"age": "21+",
"test_key": "general_identity"
}
}

Request with Quiz Answers

Once your user has answered the questions, send those answers back to the system for scoring and a final evaluation.
post
https://production.idresponse.com
/process/continue
Submit Answers

Sample Request Body - Quiz Score

{
"answers": {
"state3": ["NEW YORK"],
"mothers_maiden0": ["None of the above"],
"phone1": ["(206) 393-4478"],
"county2": ["FAIRFIELD"]
},
"token": "1bauxkpczhdiyy3vqm15ais8ue12u7zw"
}

Action and Detail Responses

The following are all values that will be returned in the result object of the response.
Action
Detail
Description
FAIL
NO MATCH
No matching identity found in the data sources
FAIL
AGE NOT VERIFIED
Target found, but no DOB information available
FAIL
TARGET IS DECEASED
Target found as a deceased identity
FAIL
POSSIBLE MINOR
Target found, but a minor age detected
FAIL
QUESTION CHECK FAILED
The user did not answers at least 3/4 questions correct.
FAIL
QUIZ NOT GENERABLE
The target did not have enough data to generate a quiz.
PENDING
MORE INFORMATION IS REQUIRED
Target was found is not deceased and meets the age requirement, but they have not yet answered the quiz.
PASS
ALL CHECKS PASSED
Target was found is not deceased, passed the verification quiz and meets the age requirement

Rules

AgeMatch with KBA will process with the default base ruleset:
The base ruleset will return a PASS when:
  • A match is found
  • The target is not deceased
  • The target meets the age requirement
  • The user has answered at least 3/4 questions correct
The base ruleset will return a PENDING when:
  • A match found
  • The target is not deceased
  • The age requirement is met
  • Questions are returned, but not answered yet
The base ruleset will return a FAIL when:
  • A match is not found or
  • The target is deceased or
  • The target does not meet the minimum age requirement
In this case no questions will be provided.

API Processing Error Returns

Each token is only valid for 90 seconds with this service. See the error responses to get information on what happens if a token is bad or expired.
Copy link
Outline
post
AgeMatch5.0.KBA
Sample Request Body
Request with Quiz Answers
post
Submit Answers
Sample Request Body - Quiz Score
Action and Detail Responses
Rules
API Processing Error Returns