---
title: "Biometric Authentication Webhooks"
method: POST
path: "/clientauth/{verificationId}"
tags: ["Webhooks"]
---

# Biometric Authentication Webhooks

`POST /clientauth/{verificationId}`

Webhook notifications for <a href="https://docs.fourthline.com/docs/authentication-solutions#biometric-authentication-solution">Biometric Authentication</a>. For setup and authentication, see <a href="https://docs.fourthline.com/docs/webhooks">Webhooks</a>.

## Path parameters

- `verificationId` string, required

## Headers

- `Authorization` string, required — The `access_token` returned in your most recent [Create access token](https://docs.fourthline.com/reference/create-access-token) response.

## Request body

- object
  - `verificationId` string, required — Our unique identifier for the case. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` <br />Validations: uuid format, `verificationId` exists <br />Errors: Format is incorrect or doesn’t exist
  - `status` 'success' | 'completed', required — The [case status](/docs/biometricauth-statuses). <br />Validation: Valid enum value <br />Errors: Invalid enum value.
  - `processType` string, required — The type of workflow. <br />Expected value: Always `ClientConfirmation` <br />Validation: Expected value <br />Errors: Must be set to `ClientConfirmation`
  - `sla` Sla — Information about the SLA for case processing.
    - `kycReceived` string — The timestamp for when the case was created. <br /><br />Format: ISO 8601 UTC date and time <br /><br />Example: `2020-07-10 15:00:00.000` <br />Validation: Valid datetime <br />Errors: Invalid datetime
    - `slaStart` string — The timestamp for when case processing started. <br /><br />Format: ISO 8601 UTC date and time <br /><br />Example: `2020-07-10 15:00:00.000` <br />Validation: Valid datetime <br />Errors: Invalid datetime
    - `slaPause` string — The timestamp for when we paused case processing, e.g. because we sent the case back to you to request more information. <br /><br />Format: ISO 8601 UTC date and time <br /><br />Example: `2020-07-10 15:00:00.000` <br />Validation: Valid datetime <br />Errors: Invalid datetime
    - `slaEnd` string — The timestamp for when case processing was completed. <br /><br />Format: ISO 8601 UTC date and time <br /><br />Example: `2020-07-10 15:00:00.000` <br />Validation: Valid datetime <br />Errors: Invalid datetime
    - `withinSla` boolean — • `true`: The case was processed within the SLA. <br />• `false`: The case **wasn’t** processed within the SLA. <br />Validation: `true` or `false` value <br />Errors: Invalid boolean value.
    - `slaBucket` 'bucket1' | 'bucket2' | 'bucket3' — The SLA category for the case, as defined in your configuration.
  - `messages` object — Information about the [case status](/docs/biometricauth-statuses).
    - `statusCode` integer, required — The [status code](/docs/biometricauth-statuses#status-codes). <br />Validation: Integer between 0 and 6000 <br />Errors: Value must be an integer between 0 and 6000
    - `description` string, required — The status code description.
  - `dataRectified` boolean, required — • `true`: We corrected some data entered by the client after the case has been successfully completed. <br />• `false`: We **didn’t** correct any data after the case has been successfully completed. <br />Validation: `true` or `false` value <br />Errors: Invalid boolean value.
  - `timestamp` string, required — The timestamp for this notification. <br /><br />Format: ISO 8601 UTC date and time <br /><br />Example: `2020-07-10 15:00:00.000` <br />Validation: Valid datetime <br />Errors: Invalid datetime

## Response `200`

Return HTTP 2xx to acknowledge receipt. See [Handle webhook deliveries](https://docs.fourthline.com/docs/webhooks#200-ok).

- object — A successful response is empty.

## Other responses

- `401` — Fourthline could not authenticate with your webhook endpoint. See [troubleshooting](https://docs.fourthline.com/docs/webhooks#401-unauthorized).
- `403` — Fourthline could not authenticate with your webhook endpoint. See [troubleshooting](https://docs.fourthline.com/docs/webhooks#403-forbidden).
- `404` — Fourthline can reach your server, but the webhook endpoint could not be found. See [troubleshooting](https://docs.fourthline.com/docs/webhooks#404-not-found).
- `500` — Your server received the request but could not process it successfully. See [troubleshooting](https://docs.fourthline.com/docs/webhooks#500-internal-server-error).

---

[API](https://skmtc.net/fourthline/apis/fourthline-apis.md) · [All operations](https://skmtc.net/fourthline/apis/fourthline-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthline/fourthline-apis/revisions/7991ae7c8383/schema)