---
title: "Test signature flow"
method: POST
path: "/v1/testendpoint/signatures/{signatureId}"
tags: ["Qualified Electronic Signature"]
---

# Test signature flow

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

**Sandbox environment only**: Use this endpoint to start the signature flow for a test signature with a target status, using any successfully completed `verificationId`. <br /><br /><img src="https://files.readme.io/310d4d3-Inline_Caution.svg" align="left" alt="Important" /> **Important:** <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.

## Request body

- object
  - `deviceMetaData` object, required — The metadata from the client’s device.
    - `language` string, required — The language of the client’s device. <br /><br />Format: ISO 3166-1 alpha-2 <br /><br />Example: `NL`
    - `region` string — The country code of the client’s device geolocation. <br /><br />Format: ISO 3166-1 alpha-2, e.g. `IT` **or** ISO 3166-1 alpha-3, e.g. `ITA`
    - `model` string, required — The model of the client’s device. <br /><br /><img src="https://files.readme.io/8eb9022-Inline_Tip.svg" align="left"/> **Tip:** **Required** for workflows that include Qualified Electronic Signature, so that we can check it matches the client’s Identity Verification case. <br /><br />Example: OnePlus Nord CE 5G
    - `ipAddress` string — The IP address of the client’s device. <br /><br />Example: 185.128.27.102
    - `latitude` string — The latitude of the client’s device geolocation <br /><br />Format: Float between -90 and 90 <br /><br />Example: 45.464664
    - `longitude` string — The longitude of the client’s device geolocation. <br /><br />Format: Float between -180 and 180 <br /><br />Example: 9.188540
  - `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`
  - `expectation` object, required — The test outcome for the signature flow.
    - `status` 'pending' | 'user_consent_required' | 'kyc_required' | 'selfie_required' | 'rejected', required — The status you want to set for the signature flow.
    - `statusCode` integer — The status code you want to set for the signature flow.
    - `verificationId` string — The unique identifier for the Identity Verification case. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` <br /><br /><img src="https://files.readme.io/8eb9022-Inline_Tip.svg" align="left"/>**Tip:** This is the **same** value as the `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response.

## Response `202`

Request accepted for processing; response body is empty

---

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