---
title: "Get signature details"
method: GET
path: "/v1/signatures/{signatureId}/details"
tags: ["Qualified Electronic Signature"]
---

# Get signature details

`GET /v1/signatures/{signatureId}/details`

Use this endpoint to get the details of the documents to sign, [QTSP legal conditions](https://docs.fourthline.com/docs/qes-integration#legal-conditions), and the number of one-time passcode digits. <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.

## Path parameters

- `signatureId` 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.

## Response `200`

Signature details returned

- union
  - object
    - `clientId` string — Our unique identifier for the client, returned in your first [Create workflow](https://docs.fourthline.com/reference/create-workflow) request for this client. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
    - `verificationId` string — Our unique identifier for the signature, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
    - `mobilePhoneNumber` string — The client’s mobile phone number, which you have ensured is valid. <br /><br />Format: +{prefixNumber} {phoneNumber} <br /><img src="https://files.readme.io/ad2486a-Inline_Note.svg" align="left"/> **Notes**: <br />• Always include a **space** between the prefix and phone number. <br />• The prefix can contain a maximum of **4** digits. <br /><br />Example: `+31 612345678`
    - `legalDocuments` object[] — The [QTSP legal conditions](https://docs.fourthline.com/docs/qes-integration#legal-conditions) you need to display on the **Document approval** screen in your frontend for the client to review and accept.
      - `displayName` string — The legal conditions document title to display in the user interface.
      - `id` string — 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 — The URL where the legal conditions document is stored.
      - `version` integer — The version of the legal conditions document. <br /><br />Format: int32
    - `otpSettings` object[] — Information about the one-time passcode.
      - `validation` string — The type of validation of the one-time passcode.
      - `version` integer — The number of digits in the one-time passcode: <br />• Namirial: 6 <br />• InfoCert: 8
  - object
    - `clientId` string — Our unique identifier for the client, returned in your first [Create workflow](https://docs.fourthline.com/reference/create-workflow) request for this client. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
    - `verificationId` string — Our unique identifier for the signature, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
    - `mobilePhoneNumber` string — The client’s mobile phone number, which you have ensured is valid. <br /><br />Format: +{prefixNumber} {phoneNumber} <br /><img src="https://files.readme.io/ad2486a-Inline_Note.svg" align="left"/> **Notes**: <br />• Always include a **space** between the prefix and phone number. <br />• The prefix can contain a maximum of **4** digits. <br /><br />Example: `+31 612345678`
    - `legalDocuments` object[] — The [QTSP legal conditions](https://docs.fourthline.com/docs/qes-integration#legal-conditions) you need to display on the **Document approval** screen in your frontend for the client to review and accept.
      - `displayName` string — The legal conditions document title to display in the user interface.
      - `id` string — 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 — The URL where the legal conditions document is stored.
      - `version` integer — The version of the legal conditions document. <br /><br />Format: int32
    - `clauses` object[] — The InfoCert legal clauses to display on the **Document approval** screen in your frontend for the client to accept.
      - `id` string — The unique identifier for the legal clause.
      - `text` string — The text to display along with an acceptance checkbox for the client to check.
      - `version` integer — The version of the legal clause.
    - `otpSettings` object[] — Information about the one-time passcode.
      - `validation` string — The type of validation of the one-time passcode.
      - `version` integer — The number of digits in the one-time passcode: <br />• Namirial: 6 <br />• InfoCert: 8

## Other responses

- `400` — Invalid request parameters
- `404` — Signature not found

---

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