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

# Test signature flow

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

## Request

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

**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](ref: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', 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](ref:create-workflow) response.

## Response `202`

Request accepted for processing; response body is empty

## Changes

- **2026-11-03** `87907b6e3164`: 1 breaking
  - removed the enum value `rejected` of the request property `expectation/status`

[Operation history](https://skmtc.dev/fourthline/apis/fourthline-apis/changes/v1/testendpoint/signatures/:signatureId/post.md)

---

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