Gets an ID Proofing request
GET/api/web/v1/idproofing/:requestId
Gets an ID Proofing request. Caller requires the IDPROOFING:VIEW permission.
Request
Path Parameters
The UUID of the ID Proofing request.
Responses
- 200
- 400
- 401
- 403
- 404
- 409
Successful
- application/json
- Schema
- Example (from schema)
Schema
Returns true if the document back image was successfully classified into a known document.
The time when the document ID back image was uploaded.
Possible values: [ALLOW
, DENY
, NONE
, REVIEW
]
The device risk assessment result. A result of DENY will not allow to continue with an ID Proofing request.
Possible values: [NONE
, UNKNOWN
, PASSED
, FAILED
, SKIPPED
, ATTENTION
]
The ID document authentication result.
Returns true if the document photo and the selfie matched.
Face match score normalized to the range 0-100, where 80 or higher is considered a match. Clients should rely on the faceMatch attribute rather than the raw score.
Returns true if the document front image was successfully classified into a known document.
The time when the document ID front image was uploaded.
ID Proofing request identifier.
The time when the request was initiated.
Possible values: [COMPLETE
, IMAGE
, INIT
]
The state of the request.
{
"backImageClassified": true,
"backImageUploadTime": "2019-02-19T13:15:27Z",
"deviceCheckResult": "REVIEW",
"documentAuthenticationResult": "ATTENTION",
"faceMatch": true,
"faceMatchScore": 85,
"frontImageClassified": true,
"frontImageUploadTime": "2019-02-19T13:15:27Z",
"requestId": "be0176b9-473b-4543-a338-101e2c899abb",
"requestTime": "2019-02-19T13:15:27Z",
"state": "COMPLETE"
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
Error Codes specific to cause of failure.
Additional Error Message describing the error.
Optional additional error information.
{
"errorCode": "invalid_user_response",
"errorMessage": "Application id cannot be null",
"parameters": [
{}
]
}
Access denied
- application/json
- Schema
- Example (from schema)
Schema
Error Codes specific to cause of failure.
Additional Error Message describing the error.
Optional additional error information.
{
"errorCode": "invalid_user_response",
"errorMessage": "Application id cannot be null",
"parameters": [
{}
]
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
Error Codes specific to cause of failure.
Additional Error Message describing the error.
Optional additional error information.
{
"errorCode": "invalid_user_response",
"errorMessage": "Application id cannot be null",
"parameters": [
{}
]
}
Not Found
- application/json
- Schema
- Example (from schema)
Schema
Error Codes specific to cause of failure.
Additional Error Message describing the error.
Optional additional error information.
{
"errorCode": "invalid_user_response",
"errorMessage": "Application id cannot be null",
"parameters": [
{}
]
}
Conflict
- application/json
- Schema
- Example (from schema)
Schema
Error Codes specific to cause of failure.
Additional Error Message describing the error.
Optional additional error information.
{
"errorCode": "invalid_user_response",
"errorMessage": "Application id cannot be null",
"parameters": [
{}
]
}