FaceApi
| Method | HTTP request | Description |
|---|---|---|
| CreateFaceAuthenticatorUsingPOST | POST /api/web/v2/users/{userid}/face | Create a Face Biometric for a user |
| CreateFaceUsingPOST | POST /api/web/v1/users/{userid}/face | Create a Face Biometric for a user |
| DeleteFaceUsingDELETE | DELETE /api/web/v1/face/{faceid} | Delete a Face Biometric |
| GetFacesUsingGET | GET /api/web/v1/users/{userid}/faces | Get the Face Biometrics for a given user |
| GetUserFaceSettingsUsingGET | GET /api/web/v1/users/{userid}/settings/face | Gets a users Face Biometric settings |
| SendFaceActivationEmailUsingPUT | PUT /api/web/v1/face/{faceid}/activation | Send an activation email for the Face Biometric |
| UpdateFaceUsingPUT | PUT /api/web/v1/users/{userid}/face | Update the Face Biometric for a given user |
CreateFaceAuthenticatorUsingPOST
FaceCreateResponse CreateFaceAuthenticatorUsingPOST (string userid, FaceCreateParms faceCreateParms)
Create a Face Biometric for a user
Create a Face Biometric for the specified user. Caller requires the FACE:ADD permission.
The Face Biometric can be created using either the web flow or the mobile flow.
If using the web flow, the Face Biometric can optionally use the Onfido applicantId and workflowRunId to link the Face Biometric to the correct Onfido applicant and workflow run.
If using the mobile flow, setting deliverActivationEmail to true will send an activation email to the user with instructions to download the mobile app and complete activation.
Setting returnQRCode to true will include a QR code in the response that can be scanned by the user to start the activation process.
If using the IDaaS stored biometric web flow, the encryptedBiometricToken parameter is required and must include both the encrypted biometric token and the customer user ID used to create the token in Onfido.
Using the CreateFaceAuthenticatorUsingPOSTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | string | ||
| faceCreateParms | FaceCreateParms |
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 | - |
CreateFaceUsingPOST
FaceAuthenticator CreateFaceUsingPOST (string userid, FaceCreateParms faceCreateParms)
Create a Face Biometric for a user
Create a Face for the specified user. Caller requires the FACE:ADD permission.
Example
Using the CreateFaceUsingPOSTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | string | ||
| faceCreateParms | FaceCreateParms |
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 | - |
DeleteFaceUsingDELETE
void DeleteFaceUsingDELETE (string faceid)
Delete a Face Biometric
Delete a Face Biometric by the specified ID. Caller requires the FACE:REMOVE permission.
Example
Using the DeleteFaceUsingDELETEWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| faceid | string | The ID of the Face Biometric. |
Return type
void (empty response body)
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 | - |
GetFacesUsingGET
List<FaceAuthenticator> GetFacesUsingGET (string userid)
Get the Face Biometrics for a given user
Get the Face Biometrics for the specified user. Caller requires the FACE:VIEW permission.
Example
Using the GetFacesUsingGETWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | string | The UUID of the user to get the Face Biometrics for. |
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 | - |
GetUserFaceSettingsUsingGET
UserFaceSettings GetUserFaceSettingsUsingGET (string userid)
Gets a users Face Biometric settings
Get Face Biometric settings information for the specified user. Caller requires the FACE:VIEW permission.
Example
Using the GetUserFaceSettingsUsingGETWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | string | The UUID of the user whose Face Biometric settings information is to be fetched. |
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 | - |
SendFaceActivationEmailUsingPUT
void SendFaceActivationEmailUsingPUT (string faceid)
Send an activation email for the Face Biometric
Send an activation email for the Face Biometric specified by ID. Caller requires the FACE:ADD permission.
Example
Using the SendFaceActivationEmailUsingPUTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| faceid | string | The ID of the Face Biometric. |
Return type
void (empty response body)
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 | - |
UpdateFaceUsingPUT
void UpdateFaceUsingPUT (string userid, FaceUpdateParms faceUpdateParms)
Update the Face Biometric for a given user
Update the Face Biometric for the specified user. Caller requires the FACE:EDIT permission.
Example
Using the UpdateFaceUsingPUTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | string | The UUID of the user to update the Face Biometric for. | |
| faceUpdateParms | FaceUpdateParms |
Return type
void (empty response body)
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 | - |