---
title: "Approve documents to sign"
method: POST
path: "/v1/signatures/{signatureId}/authorize"
tags: ["Qualified Electronic Signature"]
---

# Approve documents to sign

`POST /v1/signatures/{signatureId}/authorize`

When the [signature status](https://docs.fourthline.com/docs/qes-statuses) changes to `user_consent_required` and **after** making the [Get signature details](https://docs.fourthline.com/reference/get-signature-details) request, use this endpoint to confirm that the client has approved the documents to sign and accepted the QTSP legal conditions. <br /><br /><img src="https://files.readme.io/310d4d3-Inline_Caution.svg" align="left" alt="Important" /> **Important:** <br />• Before using this endpoint, see the <a href="https://docs.fourthline.com/docs/qes-integration">integration guide</a>. <br />• <code>signatureId</code> and <code>workflowId</code> are string identifiers that can be used interchangeably.<br /><img src="https://files.readme.io/8eb9022-Inline_Tip.svg" align="left"/> **Tip:** When testing this endpoint, you must use a **real** ID document with an <Glossary><Glossary>MRZ</Glossary> or <Glossary><Glossary>VIZ</Glossary>.

## Path parameters

- `signatureId` string, required

## Query parameters

- `lang` 'cs' | 'de' | 'en' | 'es' | 'fi' | 'fr' | 'it' | 'nl' | 'pl' | 'sk'

## 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
  - `authorizedDocuments` object[], required — The documents to sign approved by the client.
    - `documentId` string, required — The unique identifier for the document to sign you passed in the [Upload documents to sign](https://docs.fourthline.com/reference/upload-documents-to-sign) request. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
    - `documentHash` string, required — The SHA-256 hash of the document to sign.
  - `legalDocumentsAccepted` object[], required — The QTSP legal conditions accepted by the client.
    - `id` string, required — The unique identifier of the legal conditions document, returned in the [Get signature details](https://docs.fourthline.com/reference/get-signature-details) response.
    - `url` string, required — The URL where the legal conditions document is stored.
    - `version` integer, required — The version of the legal conditions document. <br /><br />Format: int32

## Response `202`

Document approval accepted

- object
  - `attemptId` string — The unique identifier for this document approval attempt.

## Other responses

- `400` — Invalid request parameters
- `404` — Signature not found
- `409` — Conflict
- `429` — Retry attempts exceeded

---

[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)