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 (string requestId, byte[] 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.
Using the IdProofingCompleteSelfieUsingPUTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
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 (string requestId, IdProofingCompleteParms 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
Using the IdProofingCompleteUsingPUTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
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 (string requestId, int side, byte[] 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
Using the IdProofingImageUsingPUTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
Name | Type | Description | Notes |
---|---|---|---|
requestId | string | The UUID of the ID Proofing request. | |
side | int | 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 idProofingInitParms)
Initiates an ID Proofing request, checks the risk of a device and obtains license details
Caller requires the IDPROOFING:ADD permission.
Example
Using the IdProofingInitUsingPOSTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
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 (string requestId)
Gets an ID Proofing request
Gets an ID Proofing request. Caller requires the IDPROOFING:VIEW permission.
Example
Using the IdProofingRequestUsingGETWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
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 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
Using the IdProofingRequestsPagedUsingPOSTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
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 | - |