---
title: "Qualified Electronic Signature Webhooks"
method: POST
path: "/qes/{signatureId}"
tags: ["Webhooks"]
---

# Qualified Electronic Signature Webhooks

`POST /qes/{signatureId}`

## Request

- Base URL: `https://mysite.com/api/fourthline`
- URL: `https://mysite.com/api/fourthline/qes/{signatureId}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://example.com/token`

Webhook notifications for <a href="https://docs.fourthline.com/docs/qes-overview">Qualified Electronic Signature</a>. For setup and authentication, see <a href="https://docs.fourthline.com/docs/webhooks">Webhooks</a>.

## Path parameters

- `signatureId` string, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `signatureId` string, required: Our unique identifier for the signature. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` <br />Validations: uuid format, `signatureId` exists <br />Errors: Format is incorrect or doesn’t exist
  - `status` 'new' | 'pending' | 'selfie_required' | 'kyc_required' | 'user_consent_required' | 'confirmation_required' | 'pending_verification' | 'invalid_signature' | 'signed' | 'error', required: The [signature status](https://docs.fourthline.com/docs/qes-statuses). <br />Validation: Valid enum value <br />Errors: Invalid enum value.
  - `statusCode` integer: The [status code](https://docs.fourthline.com/docs/qes-statuses#status-codes). <br />Validation: Integer between 0 and 6010 <br />Errors: Value must be an integer between 0 and 6010
  - `errors` object[]: Information about any errors.
    - `attemptId` string: Our unique identifier for the failed attempt. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
    - `timestamp` string: The timestamp for when the attempt failed. <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.dev/fourthline/apis/webhooks.md) - [All operations](https://skmtc.dev/fourthline/apis/webhooks/llms.txt) - [OpenAPI document](https://skmtc.dev/fourthline/apis/webhooks/revisions/4df6bbbf587c?raw)