Validate Identity Verification Answers Action

Validates caller-provided answers against the active identity verification session and returns whether verification succeeded.

This action is available in API version 68.0 and later.

Supported REST HTTP Methods

URI: /services/data/vXX.X/actions/standard/validateIdVerifAnswers

Where XX.X is the latest API version.

Formats: JSON, XML

HTTP Methods: POST

Authentication: Authorization: Bearer TOKEN

Where TOKEN is your OAuth access token.

Inputs

Input	Type	Description
`callerAnswers`	Array	Required A JSON array of caller-provided answers, where each object contains `label`, `answer`, and `developerName` properties.
`verificationContext`	Reference	Required The identity verification context, which is updated with verifiers upon output.

Outputs

Output	Type	Description
`verificationSuccessful`	Boolean	Indicates whether all caller-provided answers match the active identity verification session.

Example

Sample Request

1{
2        "inputs": [
3        {
4        "verificationContext": {
5        "processDefinition": {
6        "developerName": "StandardIdentityVerification"
7        }
8        },
9        "callerAnswers": [
10        {
11        "label": "Date of Birth",
12        "answer": "1985-03-22",
13        "developerName": "DateOfBirth"
14        },
15        {
16        "label": "ZIP Code",
17        "answer": "94105",
18        "developerName": "ZipCode"
19        }
20        ]
21        }
22        ]
23        }

Sample Response

1[
2        {
3        "verificationSuccessful": true,
4        "verificationContext": {
5        "isSuccess": true,
6        "verifiedResult": {
7        "verifiers": [
8        {
9        "developerName": "DateOfBirth",
10        "verificationState": "Verified"
11        },
12        {
13        "developerName": "ZipCode",
14        "verificationState": "Verified"
15        }
16        ]
17        }
18        }
19        }
20        ]