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

# Get signature status

`GET /v1/signatures/{signatureId}`

## Request

- Base URL: `https://api.ext-sandbox.fourthline.com`
- URL: `https://api.ext-sandbox.fourthline.com/v1/signatures/{signatureId}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://example.com/token`

Use this endpoint to get the <a href="https://docs.fourthline.com/docs/qes-statuses">status</a> of a signature flow. <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](ref:create-access-token) response.

## Response `200`

Signature status returned

- union
  - object
    - `status` string, required: The [signature status](https://docs.fourthline.com/docs/qes-statuses).
    - `statusCode` integer: The signature [status code](https://docs.fourthline.com/docs/qes-statuses#status-codes).
  - object
    - `status` string: The [signature status](https://docs.fourthline.com/docs/qes-statuses).
    - `statusCode` integer: The signature [status code](https://docs.fourthline.com/docs/qes-statuses#status-codes).
  - object
    - `status` string: The [signature status](https://docs.fourthline.com/docs/qes-statuses).
    - `statusCodes` integer[]: An array of all error [status codes](https://docs.fourthline.com/docs/qes-statuses#status-codes) thrown.
    - `errorCodes` object[]: An array of objects, containing information about each error.
      - `attemptId` string: The unique identifier for the attempt that threw the error.
      - `timestamp` string: The timestamp for when the error was thrown. <br /><br />Format: ISO 8601 UTC date and time
    - `statusCode` integer: The highest number error [status code](https://docs.fourthline.com/docs/qes-statuses#status-codes) thrown.

## Other responses

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

---

[API](https://skmtc.dev/fourthline/apis/fourthline-apis.md) - [All operations](https://skmtc.dev/fourthline/apis/fourthline-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/fourthline/apis/fourthline-apis/revisions/87907b6e3164?raw)