IdProofingApi
| Method | HTTP request | Description |
|---|---|---|
| idProofingCompleteSelfieUsingPUT | PUT /api/web/v1/idproofing/{requestId}/completeselfie | Upload a selfie image and performs a face match with the ID Document photo image. |
| idProofingCompleteUsingPUT | PUT /api/web/v1/idproofing/{requestId}/complete | Send liveness check transaction data and performs a face match with the ID Document photo image. |
| idProofingImageUsingPUT | PUT /api/web/v1/idproofing/{requestId}/image/{side} | Upload an ID Document image (binary) |
| idProofingInitUsingPOST | POST /api/web/v1/idproofing/init | Initiates an ID Proofing request, checks the risk of a device and obtains license details |
| idProofingRequestUsingGET | GET /api/web/v1/idproofing/{requestId} | Gets an ID Proofing request |
| idProofingRequestsPagedUsingPOST | POST /api/web/v1/idproofing | Lists a page of ID Proofing requests |
idProofingCompleteSelfieUsingPUT
IdProofingAuthenticationResult idProofingCompleteSelfieUsingPUT(requestId, body)
Upload a selfie image and performs a face match with the ID Document photo image.
Returns the document authentication result and the face match result. This ID Proofing API call consumes two transactions and the ID Proofing request status is marked as COMPLETED. Any subsequent ID Proofing API calls using the same requestId will return an error. Caller requires the IDPROOFING:EDIT permission.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| requestId | String | The UUID of the ID Proofing request. | |
| body | byte[] |
Return type
IdProofingAuthenticationResult
Authorization
HTTP request headers
- Content-Type: application/octet-stream
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
idProofingCompleteUsingPUT
IdProofingAuthenticationResult idProofingCompleteUsingPUT(requestId, idProofingCompleteParms)
Send liveness check transaction data and performs a face match with the ID Document photo image.
Returns the document authentication result and the face match result. This ID Proofing API call consumes two transactions and the ID Proofing request status is marked as COMPLETED. Any subsequent ID Proofing API calls using the same requestId will return an error. Caller requires the IDPROOFING:EDIT permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| requestId | String | The UUID of the ID Proofing request. | |
| idProofingCompleteParms | IdProofingCompleteParms |
Return type
IdProofingAuthenticationResult
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
idProofingImageUsingPUT
IdProofingDocumentClassification idProofingImageUsingPUT(requestId, side, body)
Upload an ID Document image (binary)
Uploads the front (side = 0) or back (side = 1) of an ID document. Caller requires the IDPROOFING:EDIT permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| requestId | String | The UUID of the ID Proofing request. | |
| side | Integer | The side of the ID document image. | |
| body | byte[] |
Return type
IdProofingDocumentClassification
Authorization
HTTP request headers
- Content-Type: application/octet-stream
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
idProofingInitUsingPOST
IdProofingInitResult idProofingInitUsingPOST(idProofingInitParms)
Initiates an ID Proofing request, checks the risk of a device and obtains license details
Caller requires the IDPROOFING:ADD permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| idProofingInitParms | IdProofingInitParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
idProofingRequestUsingGET
IdProofingRequest idProofingRequestUsingGET(requestId)
Gets an ID Proofing request
Gets an ID Proofing request. Caller requires the IDPROOFING:VIEW permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| requestId | String | The UUID of the ID Proofing request. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
idProofingRequestsPagedUsingPOST
IdProofingRequestPage idProofingRequestsPagedUsingPOST(searchParms)
Lists a page of ID Proofing requests
Returns ID Proofing requests for the provided search parameters. Caller requires the IDPROOFING:VIEW permission. The following searchByAttributes are supported:
- requestTime: a String value representing an ISO-8601 date in UTC time (e.g., 2018-08-04T18:15:30). Allowed operators are: GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.
- deviceCheckResult: a String value. Allowed operator: EQUALS. Allowed values: ALLOW, DENY, NONE, REVIEW.
- state: a String value. Allowed operator: EQUALS. Allowed values: COMPLETE, DEVICE, IMAGE, INIT.
- documentAuthenticationResult: a String value. Allowed operator: EQUALS. Allowed values: NONE, UNKNOWN, PASSED, FAILED, SKIPPED, ATTENTION.
- faceMatch: true or false. Allowed operator: EQUALS.
If you provide more than one search attribute, they are joined with an AND condition.
The orderByAttribute supports these attribute names: requestTime, deviceCheckResult, state, documentAuthenticationResult, faceMatch.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| searchParms | SearchParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |