import React, { useState } from 'react'; export const Tab = ({ children }) => { return

{children}

; }; export const Tabs = ({ children }) => { const [activeTab, setActiveTab] = useState(0); return (

{children && children[activeTab]}

); }; To test Fourthline's API using Postman, copy the relevant raw JSON collection below, and then import it into Postman. Hover over the top-right corner of the code block and click the **Copy** button:

## Identity Verification ### European, Italian, and Spanish solutions ```json App Drop-in { "info":{ "_postman_id":"2ad8dac8-1a31-44a4-a880-c60a7b1cf301", "name":"Identity Verification: App Drop-in", "schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id":"27570928" }, "item":[ { "name":"Create access token", "request":{ "method":"POST", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"raw", "raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"\",\n \"client_secret\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/oauth2/token", "host":[ "{{baseUrl}}" ], "path":[ "v1", "oauth2", "token" ] }, "description":"Use this endpoint to create an access token valid for **1 hour** to authenticate requests to our API.

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"Use this endpoint to create an App Drop-in or Web SDK session for a workflow." }, "response":[ { "name":"200", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"target\": \"Mobile\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/workflows/:workflowId/validationcode", "host":[ "{{baseUrl}}" ], "path":[ "v1", "workflows", ":workflowId", "validationcode" ], "variable":[ { "key":"workflowId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"validationCode\": \"\",\n \"expiryDateTime\": \"\"\n}" }, { "name":"400", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"target\": \"Mobile\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/workflows/:workflowId/validationcode", "host":[ "{{baseUrl}}" ], "path":[ "v1", "workflows", ":workflowId", "validationcode" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\",\n \"errors\": [\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n },\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n }\n ]\n}" }, { "name":"401", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"target\": \"Mobile\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/workflows/:workflowId/validationcode", "host":[ "{{baseUrl}}" ], "path":[ "v1", "workflows", ":workflowId", "validationcode" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Unauthorized", "code":401, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"error\": \"\",\n \"error_description\": \"\"\n}" }, { "name":"404", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"target\": \"Mobile\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/workflows/:workflowId/validationcode", "host":[ "{{baseUrl}}" ], "path":[ "v1", "workflows", ":workflowId", "validationcode" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"title\": \"\",\n \"status\": \"\"\n}" }, { "name":"500", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"target\": \"Mobile\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/workflows/:workflowId/validationcode", "host":[ "{{baseUrl}}" ], "path":[ "v1", "workflows", ":workflowId", "validationcode" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Internal Server Error", "code":500, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"title\": \"\",\n \"status\": \"\",\n \"detail\": \"\"\n}" } ] }, { "name":"Get case status", "request":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"application/json" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "verificationresult" ], "variable":[ { "key":"verificationId", "value":"", "description":"(Required) The `workflowId` returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"Use this endpoint to get the [status](https://docs.fourthline.com/docs/idv-statuses) of an Identity Verification case.

**Tip**: To receive status updates automatically, set up a [webhook](https://docs.fourthline.com/docs/webhooks)." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "verificationresult" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"verificationId\": \"\",\n \"verificationStatus\": \"\",\n \"dataValidationError\": {}\n}" } ] }, { "name":"Get CDD PDF", "request":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"text/plain" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":workflowId", "getpdfresult" ], "variable":[ { "key":"workflowId", "value":"", "description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"Use this endpoint to download the [CDD Report](https://docs.fourthline.com/docs/reports) in PDF format." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":workflowId", "getpdfresult" ], "variable":[ { "key":"workflowId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] }, { "name":"Get CDD zipfile", "request":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"text/plain" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/reports", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "reports" ], "variable":[ { "key":"verificationId", "value":"", "description":"(Required) The `workflowId` returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"Use this endpoint to download a [CDD zipfile](https://docs.fourthline.com/docs/reports#identity-verification) containing the PDF CDD Report, all IDENTITY DATA in an XML file including any Fourthline corrections, and all supporting identity files.

**Note**: We **do not** convert media files we receive, so they are returned in the original format." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/reports", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "reports" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] } ], "auth":{ "type":"oauth2" }, "variable":[ { "key":"baseUrl", "value":"https://api.ext-sandbox.fourthline.com" } ] } ``` ```json Web SDK { "info":{ "_postman_id":"653c734a-7c06-4f86-8ec7-d271d8005cae", "name":"Identity Verification: Web SDK", "schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id":"27570928" }, "item":[ { "name":"Create access token", "request":{ "method":"POST", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"raw", "raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"\",\n \"client_secret\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/oauth2/token", "host":[ "{{baseUrl}}" ], "path":[ "v1", "oauth2", "token" ] }, "description":"Use this endpoint to create an access token valid for **1 hour** to authenticate requests to our API.

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"**Web SDK and API-only integration**:Use this endpoint to upload a client’s PERSONAL DATA for an Identity Verification case.

**Tip**: To update already uploaded data, make another request with the **same** `verificationId`." }, "response":[ { "name":"200", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"nationality\": \"\",\n \"gender\": \"Female\",\n \"birthDate\": \"\",\n \"placeOfBirth\": \"\",\n \"initials\": \"\",\n \"middleName\": \"\",\n \"countryOfBirth\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"streetNumber\": \"\",\n \"postalCode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"streetNumberPrefix\": \"\",\n \"streetNumberSuffix\": \"\",\n \"region\": \"\"\n },\n \"emailAndPhone\": {\n \"email\": \"\",\n \"mobile\": \"\",\n \"phone\": \"\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"\",\n \"tin\": \"\",\n \"usPerson\": \"\",\n \"usTin\": \"\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"\",\n \"product\": \"\",\n \"sector\": \"\",\n \"sourceOfIncome\": \"\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"\",\n \"browserVersion\": \"\",\n \"ipAddress\": \"\",\n \"language\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"model\": \"\",\n \"osCompromised\": \"\",\n \"osVersion\": \"\",\n \"region\": \"\",\n \"sdkVersion\": \"\",\n \"analyticsId\": \"\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"\",\n \"FirstName\": \"\",\n \"LastName\": \"\",\n \"Nationality\": \"\",\n \"PlaceOfBirth\": \"\"\n }\n }", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdata", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdata" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"400", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"nationality\": \"\",\n \"gender\": \"Female\",\n \"birthDate\": \"\",\n \"placeOfBirth\": \"\",\n \"initials\": \"\",\n \"middleName\": \"\",\n \"countryOfBirth\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"streetNumber\": \"\",\n \"postalCode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"streetNumberPrefix\": \"\",\n \"streetNumberSuffix\": \"\",\n \"region\": \"\"\n },\n \"emailAndPhone\": {\n \"email\": \"\",\n \"mobile\": \"\",\n \"phone\": \"\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"\",\n \"tin\": \"\",\n \"usPerson\": \"\",\n \"usTin\": \"\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"\",\n \"product\": \"\",\n \"sector\": \"\",\n \"sourceOfIncome\": \"\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"\",\n \"browserVersion\": \"\",\n \"ipAddress\": \"\",\n \"language\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"model\": \"\",\n \"osCompromised\": \"\",\n \"osVersion\": \"\",\n \"region\": \"\",\n \"sdkVersion\": \"\",\n \"analyticsId\": \"\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"\",\n \"FirstName\": \"\",\n \"LastName\": \"\",\n \"Nationality\": \"\",\n \"PlaceOfBirth\": \"\"\n }\n }", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdata", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdata" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\",\n \"errors\": [\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n },\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n }\n ]\n}" }, { "name":"422", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"nationality\": \"\",\n \"gender\": \"Female\",\n \"birthDate\": \"\",\n \"placeOfBirth\": \"\",\n \"initials\": \"\",\n \"middleName\": \"\",\n \"countryOfBirth\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"streetNumber\": \"\",\n \"postalCode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"streetNumberPrefix\": \"\",\n \"streetNumberSuffix\": \"\",\n \"region\": \"\"\n },\n \"emailAndPhone\": {\n \"email\": \"\",\n \"mobile\": \"\",\n \"phone\": \"\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"\",\n \"tin\": \"\",\n \"usPerson\": \"\",\n \"usTin\": \"\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"\",\n \"product\": \"\",\n \"sector\": \"\",\n \"sourceOfIncome\": \"\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"\",\n \"browserVersion\": \"\",\n \"ipAddress\": \"\",\n \"language\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"model\": \"\",\n \"osCompromised\": \"\",\n \"osVersion\": \"\",\n \"region\": \"\",\n \"sdkVersion\": \"\",\n \"analyticsId\": \"\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"\",\n \"FirstName\": \"\",\n \"LastName\": \"\",\n \"Nationality\": \"\",\n \"PlaceOfBirth\": \"\"\n }\n }", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdata", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdata" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Unprocessable Entity (WebDAV) (RFC 4918)", "code":422, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] }, { "name":"Create SDK session", "request":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"raw", "raw":"{\n \"target\": \"Mobile\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/workflows/:workflowId/validationcode", "host":[ "{{baseUrl}}" ], "path":[ "v1", "workflows", ":workflowId", "validationcode" ], "variable":[ { "key":"workflowId", "value":"", "description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: To receive status updates automatically, set up a [webhook](https://docs.fourthline.com/docs/webhooks)." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "verificationresult" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"verificationId\": \"\",\n \"verificationStatus\": \"\",\n \"dataValidationError\": {}\n}" } ] }, { "name":"Get CDD PDF", "request":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"text/plain" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":workflowId", "getpdfresult" ], "variable":[ { "key":"workflowId", "value":"", "description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Note**: We **do not** convert media files we receive, so they are returned in the original format." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/reports", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "reports" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] } ], "auth":{ "type":"oauth2" }, "variable":[ { "key":"baseUrl", "value":"https://api.ext-sandbox.fourthline.com" } ] } ``` ```json API integration { "info":{ "_postman_id":"1abec252-00a8-4c4c-8573-7caee6bf171a", "name":"Identity Verification: API integration", "schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id":"27570928" }, "item":[ { "name":"Create access token", "request":{ "method":"POST", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"raw", "raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"\",\n \"client_secret\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/oauth2/token", "host":[ "{{baseUrl}}" ], "path":[ "v1", "oauth2", "token" ] }, "description":"Use this endpoint to create an access token valid for **1 hour** to authenticate requests to our API.

**Tip**: To update already uploaded data, make another request with the **same** `verificationId`." }, "response":[ { "name":"200", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"nationality\": \"\",\n \"gender\": \"Female\",\n \"birthDate\": \"\",\n \"placeOfBirth\": \"\",\n \"initials\": \"\",\n \"middleName\": \"\",\n \"countryOfBirth\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"streetNumber\": \"\",\n \"postalCode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"streetNumberPrefix\": \"\",\n \"streetNumberSuffix\": \"\",\n \"region\": \"\"\n },\n \"emailAndPhone\": {\n \"email\": \"\",\n \"mobile\": \"\",\n \"phone\": \"\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"\",\n \"tin\": \"\",\n \"usPerson\": \"\",\n \"usTin\": \"\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"\",\n \"product\": \"\",\n \"sector\": \"\",\n \"sourceOfIncome\": \"\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"\",\n \"browserVersion\": \"\",\n \"ipAddress\": \"\",\n \"language\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"model\": \"\",\n \"osCompromised\": \"\",\n \"osVersion\": \"\",\n \"region\": \"\",\n \"sdkVersion\": \"\",\n \"analyticsId\": \"\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"\",\n \"FirstName\": \"\",\n \"LastName\": \"\",\n \"Nationality\": \"\",\n \"PlaceOfBirth\": \"\"\n }\n }", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdata", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdata" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"400", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"nationality\": \"\",\n \"gender\": \"Female\",\n \"birthDate\": \"\",\n \"placeOfBirth\": \"\",\n \"initials\": \"\",\n \"middleName\": \"\",\n \"countryOfBirth\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"streetNumber\": \"\",\n \"postalCode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"streetNumberPrefix\": \"\",\n \"streetNumberSuffix\": \"\",\n \"region\": \"\"\n },\n \"emailAndPhone\": {\n \"email\": \"\",\n \"mobile\": \"\",\n \"phone\": \"\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"\",\n \"tin\": \"\",\n \"usPerson\": \"\",\n \"usTin\": \"\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"\",\n \"product\": \"\",\n \"sector\": \"\",\n \"sourceOfIncome\": \"\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"\",\n \"browserVersion\": \"\",\n \"ipAddress\": \"\",\n \"language\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"model\": \"\",\n \"osCompromised\": \"\",\n \"osVersion\": \"\",\n \"region\": \"\",\n \"sdkVersion\": \"\",\n \"analyticsId\": \"\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"\",\n \"FirstName\": \"\",\n \"LastName\": \"\",\n \"Nationality\": \"\",\n \"PlaceOfBirth\": \"\"\n }\n }", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdata", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdata" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\",\n \"errors\": [\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n },\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n }\n ]\n}" }, { "name":"422", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"nationality\": \"\",\n \"gender\": \"Female\",\n \"birthDate\": \"\",\n \"placeOfBirth\": \"\",\n \"initials\": \"\",\n \"middleName\": \"\",\n \"countryOfBirth\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"streetNumber\": \"\",\n \"postalCode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"streetNumberPrefix\": \"\",\n \"streetNumberSuffix\": \"\",\n \"region\": \"\"\n },\n \"emailAndPhone\": {\n \"email\": \"\",\n \"mobile\": \"\",\n \"phone\": \"\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"\",\n \"tin\": \"\",\n \"usPerson\": \"\",\n \"usTin\": \"\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"\",\n \"product\": \"\",\n \"sector\": \"\",\n \"sourceOfIncome\": \"\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"\",\n \"browserVersion\": \"\",\n \"ipAddress\": \"\",\n \"language\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"model\": \"\",\n \"osCompromised\": \"\",\n \"osVersion\": \"\",\n \"region\": \"\",\n \"sdkVersion\": \"\",\n \"analyticsId\": \"\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"\",\n \"FirstName\": \"\",\n \"LastName\": \"\",\n \"Nationality\": \"\",\n \"PlaceOfBirth\": \"\"\n }\n }", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdata", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdata" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Unprocessable Entity (WebDAV) (RFC 4918)", "code":422, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] }, { "name":"Upload identity files", "request":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"Files", "value":"", "description":"(Required) Select the files to attach." }, { "key":"DocumentType", "value":"Selfie", "description":"(Required) The identity document data." }, { "key":"DocumentNumber", "value":"", "description":"(Required) The identity document data." }, { "key":"IsPrimaryDocument", "value":"true", "description":"(Required) The identity document data." }, { "key":"IssueDate", "value":"", "description":"(Required) The identity document data." }, { "key":"ExpirationDate", "value":"", "description":"(Required) The identity document data." }, { "key":"OriginTypeOs", "value":"", "description":"(Required) The identity document data." }, { "key":"KycFiles", "value":"[object Object],[object Object]", "description":"(Required) The identity document data." }, { "key":"NfcDataGroups", "value":"[object Object]", "description":"(Required) The identity document data." } ] }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdocument", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdocument" ], "variable":[ { "key":"verificationId", "value":"", "description":"(Required) The `workflowId` returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"**API-only integration**: Use this endpoint to upload the client’s identity document(s) and IDENTITY FILES for an Identity Verification case.

**Tip**: For detailed guidance on this request, including required files per document type, see the [User guide](https://docs.fourthline.com/docs/idv-integration-api#user-guide)." }, "response":[ { "name":"200", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"Files", "value":"", "description":"(Required) Select the files to attach." }, { "key":"DocumentType", "value":"Selfie", "description":"(Required) The identity document data." }, { "key":"DocumentNumber", "value":"", "description":"(Required) The identity document data." }, { "key":"IsPrimaryDocument", "value":"true", "description":"(Required) The identity document data." }, { "key":"IssueDate", "value":"", "description":"(Required) The identity document data." }, { "key":"ExpirationDate", "value":"", "description":"(Required) The identity document data." }, { "key":"OriginTypeOs", "value":"", "description":"(Required) The identity document data." }, { "key":"KycFiles", "value":"[object Object],[object Object]", "description":"(Required) The identity document data." }, { "key":"NfcDataGroups", "value":"[object Object]", "description":"(Required) The identity document data." } ] }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdocument", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdocument" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"400", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"Files", "value":"", "description":"(Required) Select the files to attach." }, { "key":"DocumentType", "value":"Selfie", "description":"(Required) The identity document data." }, { "key":"DocumentNumber", "value":"", "description":"(Required) The identity document data." }, { "key":"IsPrimaryDocument", "value":"true", "description":"(Required) The identity document data." }, { "key":"IssueDate", "value":"", "description":"(Required) The identity document data." }, { "key":"ExpirationDate", "value":"", "description":"(Required) The identity document data." }, { "key":"OriginTypeOs", "value":"", "description":"(Required) The identity document data." }, { "key":"KycFiles", "value":"[object Object],[object Object]", "description":"(Required) The identity document data." }, { "key":"NfcDataGroups", "value":"[object Object]", "description":"(Required) The identity document data." } ] }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdocument", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdocument" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\",\n \"errors\": [\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n },\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n }\n ]\n}" }, { "name":"422", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"Files", "value":"", "description":"(Required) Select the files to attach." }, { "key":"DocumentType", "value":"Selfie", "description":"(Required) The identity document data." }, { "key":"DocumentNumber", "value":"", "description":"(Required) The identity document data." }, { "key":"IsPrimaryDocument", "value":"true", "description":"(Required) The identity document data." }, { "key":"IssueDate", "value":"", "description":"(Required) The identity document data." }, { "key":"ExpirationDate", "value":"", "description":"(Required) The identity document data." }, { "key":"OriginTypeOs", "value":"", "description":"(Required) The identity document data." }, { "key":"KycFiles", "value":"[object Object],[object Object]", "description":"(Required) The identity document data." }, { "key":"NfcDataGroups", "value":"[object Object]", "description":"(Required) The identity document data." } ] }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdocument", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdocument" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Unprocessable Entity (WebDAV) (RFC 4918)", "code":422, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\"\n}" } ] }, { "name":"Start case processing", "request":{ "method":"POST", "header":[ { "key":"Accept", "value":"application/json" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycstart", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycstart" ], "variable":[ { "key":"verificationId", "value":"", "description":"(Required) The `workflowId` returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"**API-only integration**: After uploading the [identity data](doc:upload-identity-data) and [identity files](doc:upload-identity-files), use this endpoint to trigger case processing." }, "response":[ { "name":"200", "originalRequest":{ "method":"POST", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycstart", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycstart" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"400", "originalRequest":{ "method":"POST", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycstart", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycstart" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\",\n \"errors\": [\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n },\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n }\n ]\n}" }, { "name":"404", "originalRequest":{ "method":"POST", "header":[ { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycstart", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycstart" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" }, { "name":"422", "originalRequest":{ "method":"POST", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycstart", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycstart" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Unprocessable Entity (WebDAV) (RFC 4918)", "code":422, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"errors\": \"\"\n}" } ] }, { "name":"Get case status", "request":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"application/json" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "verificationresult" ], "variable":[ { "key":"verificationId", "value":"", "description":"(Required) The `workflowId` returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: To receive status updates automatically, set up a [webhook](https://docs.fourthline.com/docs/webhooks)." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "verificationresult" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"verificationId\": \"\",\n \"verificationStatus\": \"\",\n \"dataValidationError\": {}\n}" } ] }, { "name":"Get CDD PDF", "request":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"text/plain" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":workflowId", "getpdfresult" ], "variable":[ { "key":"workflowId", "value":"", "description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Note**: We **do not** convert media files we receive, so they are returned in the original format." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/reports", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "reports" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] } ], "auth":{ "type":"oauth2" }, "variable":[ { "key":"baseUrl", "value":"https://api.ext-sandbox.fourthline.com" } ] } ``` ### French solution ```json App Drop-in { "info":{ "_postman_id":"0fe761b3-c319-4ce8-9a6b-20760be821ff", "name":"French Solution: App Drop-in", "schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id":"27570928" }, "item":[ { "name":"Create access token", "request":{ "method":"POST", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"raw", "raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"\",\n \"client_secret\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/oauth2/token", "host":[ "{{baseUrl}}" ], "path":[ "v1", "oauth2", "token" ] }, "description":"Use this endpoint to create an access token valid for **1 hour** to authenticate requests to our API.

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"Use this endpoint for Qualified Electronic Signature flows to upload the document(s) to sign." }, "response":[ { "name":"202", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Accepted", "code":202, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"400", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"traceId\": \"\",\n \"errors\": {\n \"documentsToSign\": [\n \"\",\n \"\"\n ]\n }\n}" }, { "name":"404", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\"\n}" }, { "name":"409", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Conflict", "code":409, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\"\n}" }, { "name":"422", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Unprocessable Entity (WebDAV) (RFC 4918)", "code":422, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\"\n}" } ] }, { "name":"Upload mobile phone number", "request":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"raw", "raw":"{\n \"mobilePhoneNumber\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/data", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "data" ], "variable":[ { "key":"workflowId", "value":"", "description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: To receive status updates automatically, set up a [webhook](https://docs.fourthline.com/docs/webhooks)." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "verificationresult" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"verificationId\": \"\",\n \"verificationStatus\": \"\",\n \"dataValidationError\": {}\n}" } ] }, { "name":"Get CDD PDF", "request":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"text/plain" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":workflowId", "getpdfresult" ], "variable":[ { "key":"workflowId", "value":"", "description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"Use this endpoint to get the [status](https://docs.fourthline.com/docs/qes-statuses) of a signature flow.

**Tip**: To receive status updates automatically, set up a [webhook](https://docs.fourthline.com/docs/webhooks)." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"statusCode\": \"\"\n}" }, { "name":"400", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"traceId\": \"\",\n \"errors\": {\n \"signatureId\": [\n \"\",\n \"\"\n ]\n }\n}" }, { "name":"404", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"detail\": \"\",\n \"traceId\": \"\"\n}" } ] }, { "name":"Get signed documents", "request":{ "method":"GET", "header":[ { "key":"Accept", "value":"text/plain" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/signedDocuments/:documentId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "signedDocuments", ":documentId" ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) The `workflowId` returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: Use this as the case reference number for any questions." }, { "key":"documentId", "value":"", "description":"(Required) Your unique identifier for the signed document that you passed in the [Upload documents to sign](doc:upload-documents-to-sign) request (`documentId`)." } ] }, "description":"Use this endpoint to download the signed documents when the [signature status](https://docs.fourthline.com/docs/qes-statuses) changes to `signed`." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/signedDocuments/:documentId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "signedDocuments", ":documentId" ], "variable":[ { "key":"signatureId" }, { "key":"documentId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{\n \"examples\": {\n \"OK\": {\n \"value\": \"HTTP/1.1 200 OK\\nDate: Thu, 09 Jun 2022 12:49:03 GMT\\nContent-Type: application/pdf\\nTransfer-Encoding: chunked\\nConnection: close\\nContent-Disposition: attachment; filename=agreement1.pdf; filename*=UTF-8''agreement1.pdf\\napi-supported-versions: 1.0\\n{{binary content of the signed document}}\"\n }\n }\n}" }, { "name":"400", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/signedDocuments/:documentId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "signedDocuments", ":documentId" ], "variable":[ { "key":"signatureId" }, { "key":"documentId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\",\n \"signatureStatus\": \"\"\n}" }, { "name":"404", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/signedDocuments/:documentId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "signedDocuments", ":documentId" ], "variable":[ { "key":"signatureId" }, { "key":"documentId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"detail\": \"\",\n \"traceId\": \"\"\n}" } ] }, { "name":"Get InfoCert contract", "request":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) Our unique identifier for the signature returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`" } ] }, "description":"If you have the [fallback QTSP](https://docs.fourthline.com/docs/qes-integration#qtsps) option configured, when the signature status changes to `signed`, use this endpoint to check if an InfoCert contract was generated to share with the client." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"204", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId" } ] } }, "status":"No Content", "code":204, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"400", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"404", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] }, { "name":"Test signature flow", "request":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"text/plain" } ], "body":{ "mode":"raw", "raw":"{\n \"deviceMetaData\": {\n \"language\": \"\",\n \"model\": \"\",\n \"region\": \"\",\n \"ipAddress\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"\",\n \"verificationId\": \"\"\n },\n \"mobilePhoneNumber\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/testendpoint/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "testendpoint", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) Our unique identifier for the signature, returned in the [Create signature](doc:create-a-sign-request).
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`" } ] }, "description":"**Sandbox environment only**: Use this endpoint to start the signature flow for a test signature with a target status, using any successfully completed `verificationId`." }, "response":[ { "name":"202", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"deviceMetaData\": {\n \"language\": \"\",\n \"model\": \"\",\n \"region\": \"\",\n \"ipAddress\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"\",\n \"verificationId\": \"\"\n },\n \"mobilePhoneNumber\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/testendpoint/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "testendpoint", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Accepted", "code":202, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] }, { "name":"Get test passcode", "request":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) The `workflowId` returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`" } ] }, "description":"**Sandbox environment only**: Use this endpoint to get a one-time passcode to confirm a test signature, without requiring a valid mobile phone number.
The signature status must be `confirmation_required`.
To automate testing the signature flow, in the [Upload mobile phone number](doc:upload-mobile-phone-number) request, provide a dummy mobile phone number in the following format: +39 111111234567. You can change the digits 234567 as required." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"otp\": \"\"\n}" }, { "name":"400", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\",\n \"signatureStatus\": \"\"\n}" }, { "name":"404", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\"\n}" }, { "name":"503", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Service Unavailable", "code":503, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\"\n}" } ] } ], "auth":{ "type":"oauth2" }, "variable":[ { "key":"baseUrl", "value":"https://api.ext-sandbox.fourthline.com" } ] } ``` ```json Web SDK { "info":{ "_postman_id":"518f3586-7448-45bb-a66f-487ae536d07a", "name":"French Solution: Web SDK", "schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id":"27570928" }, "item":[ { "name":"Create access token", "request":{ "method":"POST", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"raw", "raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"\",\n \"client_secret\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/oauth2/token", "host":[ "{{baseUrl}}" ], "path":[ "v1", "oauth2", "token" ] }, "description":"Use this endpoint to create an access token valid for **1 hour** to authenticate requests to our API.

**Tip**: To update already uploaded data, make another request with the **same** `verificationId`." }, "response":[ { "name":"200", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"nationality\": \"\",\n \"gender\": \"Female\",\n \"birthDate\": \"\",\n \"placeOfBirth\": \"\",\n \"initials\": \"\",\n \"middleName\": \"\",\n \"countryOfBirth\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"streetNumber\": \"\",\n \"postalCode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"streetNumberPrefix\": \"\",\n \"streetNumberSuffix\": \"\",\n \"region\": \"\"\n },\n \"emailAndPhone\": {\n \"email\": \"\",\n \"mobile\": \"\",\n \"phone\": \"\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"\",\n \"tin\": \"\",\n \"usPerson\": \"\",\n \"usTin\": \"\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"\",\n \"product\": \"\",\n \"sector\": \"\",\n \"sourceOfIncome\": \"\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"\",\n \"browserVersion\": \"\",\n \"ipAddress\": \"\",\n \"language\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"model\": \"\",\n \"osCompromised\": \"\",\n \"osVersion\": \"\",\n \"region\": \"\",\n \"sdkVersion\": \"\",\n \"analyticsId\": \"\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"\",\n \"FirstName\": \"\",\n \"LastName\": \"\",\n \"Nationality\": \"\",\n \"PlaceOfBirth\": \"\"\n }\n }", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdata", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdata" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"400", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"nationality\": \"\",\n \"gender\": \"Female\",\n \"birthDate\": \"\",\n \"placeOfBirth\": \"\",\n \"initials\": \"\",\n \"middleName\": \"\",\n \"countryOfBirth\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"streetNumber\": \"\",\n \"postalCode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"streetNumberPrefix\": \"\",\n \"streetNumberSuffix\": \"\",\n \"region\": \"\"\n },\n \"emailAndPhone\": {\n \"email\": \"\",\n \"mobile\": \"\",\n \"phone\": \"\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"\",\n \"tin\": \"\",\n \"usPerson\": \"\",\n \"usTin\": \"\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"\",\n \"product\": \"\",\n \"sector\": \"\",\n \"sourceOfIncome\": \"\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"\",\n \"browserVersion\": \"\",\n \"ipAddress\": \"\",\n \"language\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"model\": \"\",\n \"osCompromised\": \"\",\n \"osVersion\": \"\",\n \"region\": \"\",\n \"sdkVersion\": \"\",\n \"analyticsId\": \"\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"\",\n \"FirstName\": \"\",\n \"LastName\": \"\",\n \"Nationality\": \"\",\n \"PlaceOfBirth\": \"\"\n }\n }", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdata", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdata" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\",\n \"errors\": [\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n },\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n }\n ]\n}" }, { "name":"422", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"nationality\": \"\",\n \"gender\": \"Female\",\n \"birthDate\": \"\",\n \"placeOfBirth\": \"\",\n \"initials\": \"\",\n \"middleName\": \"\",\n \"countryOfBirth\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"streetNumber\": \"\",\n \"postalCode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"streetNumberPrefix\": \"\",\n \"streetNumberSuffix\": \"\",\n \"region\": \"\"\n },\n \"emailAndPhone\": {\n \"email\": \"\",\n \"mobile\": \"\",\n \"phone\": \"\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"\",\n \"tin\": \"\",\n \"usPerson\": \"\",\n \"usTin\": \"\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"\",\n \"product\": \"\",\n \"sector\": \"\",\n \"sourceOfIncome\": \"\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"\",\n \"browserVersion\": \"\",\n \"ipAddress\": \"\",\n \"language\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"model\": \"\",\n \"osCompromised\": \"\",\n \"osVersion\": \"\",\n \"region\": \"\",\n \"sdkVersion\": \"\",\n \"analyticsId\": \"\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"\",\n \"FirstName\": \"\",\n \"LastName\": \"\",\n \"Nationality\": \"\",\n \"PlaceOfBirth\": \"\"\n }\n }", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdata", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdata" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Unprocessable Entity (WebDAV) (RFC 4918)", "code":422, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] }, { "name":"Upload documents to sign", "request":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"traceId\": \"\",\n \"errors\": {\n \"documentsToSign\": [\n \"\",\n \"\"\n ]\n }\n}" }, { "name":"404", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\"\n}" }, { "name":"409", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Conflict", "code":409, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\"\n}" }, { "name":"422", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Unprocessable Entity (WebDAV) (RFC 4918)", "code":422, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\"\n}" } ] }, { "name":"Upload mobile phone number", "request":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"raw", "raw":"{\n \"mobilePhoneNumber\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/data", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "data" ], "variable":[ { "key":"workflowId", "value":"", "description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: To receive status updates automatically, set up a [webhook](https://docs.fourthline.com/docs/webhooks)." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "verificationresult" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"verificationId\": \"\",\n \"verificationStatus\": \"\",\n \"dataValidationError\": {}\n}" } ] }, { "name":"Get CDD PDF", "request":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"text/plain" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":workflowId", "getpdfresult" ], "variable":[ { "key":"workflowId", "value":"", "description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"Use this endpoint to get the [status](https://docs.fourthline.com/docs/qes-statuses) of a signature flow.

**Tip**: To receive status updates automatically, set up a [webhook](https://docs.fourthline.com/docs/webhooks)." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"statusCode\": \"\"\n}" }, { "name":"400", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"traceId\": \"\",\n \"errors\": {\n \"signatureId\": [\n \"\",\n \"\"\n ]\n }\n}" }, { "name":"404", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"detail\": \"\",\n \"traceId\": \"\"\n}" } ] }, { "name":"Get signed documents", "request":{ "method":"GET", "header":[ { "key":"Accept", "value":"text/plain" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/signedDocuments/:documentId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "signedDocuments", ":documentId" ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) The `workflowId` returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: Use this as the case reference number for any questions." }, { "key":"documentId", "value":"", "description":"(Required) Your unique identifier for the signed document that you passed in the [Upload documents to sign](doc:upload-documents-to-sign) request (`documentId`)." } ] }, "description":"Use this endpoint to download the signed documents when the [signature status](https://docs.fourthline.com/docs/qes-statuses) changes to `signed`." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/signedDocuments/:documentId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "signedDocuments", ":documentId" ], "variable":[ { "key":"signatureId" }, { "key":"documentId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{\n \"examples\": {\n \"OK\": {\n \"value\": \"HTTP/1.1 200 OK\\nDate: Thu, 09 Jun 2022 12:49:03 GMT\\nContent-Type: application/pdf\\nTransfer-Encoding: chunked\\nConnection: close\\nContent-Disposition: attachment; filename=agreement1.pdf; filename*=UTF-8''agreement1.pdf\\napi-supported-versions: 1.0\\n{{binary content of the signed document}}\"\n }\n }\n}" }, { "name":"400", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/signedDocuments/:documentId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "signedDocuments", ":documentId" ], "variable":[ { "key":"signatureId" }, { "key":"documentId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\",\n \"signatureStatus\": \"\"\n}" }, { "name":"404", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/signedDocuments/:documentId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "signedDocuments", ":documentId" ], "variable":[ { "key":"signatureId" }, { "key":"documentId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"detail\": \"\",\n \"traceId\": \"\"\n}" } ] }, { "name":"Get InfoCert contract", "request":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) Our unique identifier for the signature returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`" } ] }, "description":"If you have the [fallback QTSP](https://docs.fourthline.com/docs/qes-integration#qtsps) option configured, when the signature status changes to `signed`, use this endpoint to check if an InfoCert contract was generated to share with the client." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"204", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId" } ] } }, "status":"No Content", "code":204, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"400", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"404", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] }, { "name":"Test signature flow", "request":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"text/plain" } ], "body":{ "mode":"raw", "raw":"{\n \"deviceMetaData\": {\n \"language\": \"\",\n \"model\": \"\",\n \"region\": \"\",\n \"ipAddress\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"\",\n \"verificationId\": \"\"\n },\n \"mobilePhoneNumber\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/testendpoint/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "testendpoint", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) Our unique identifier for the signature, returned in the [Create signature](doc:create-a-sign-request).
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`" } ] }, "description":"**Sandbox environment only**: Use this endpoint to start the signature flow for a test signature with a target status, using any successfully completed `verificationId`." }, "response":[ { "name":"202", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"deviceMetaData\": {\n \"language\": \"\",\n \"model\": \"\",\n \"region\": \"\",\n \"ipAddress\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"\",\n \"verificationId\": \"\"\n },\n \"mobilePhoneNumber\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/testendpoint/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "testendpoint", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Accepted", "code":202, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] }, { "name":"Get test passcode", "request":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) The `workflowId` returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`" } ] }, "description":"**Sandbox environment only**: Use this endpoint to get a one-time passcode to confirm a test signature, without requiring a valid mobile phone number.
The signature status must be `confirmation_required`.
To automate testing the signature flow, in the [Upload mobile phone number](doc:upload-mobile-phone-number) request, provide a dummy mobile phone number in the following format: +39 111111234567. You can change the digits 234567 as required." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"otp\": \"\"\n}" }, { "name":"400", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\",\n \"signatureStatus\": \"\"\n}" }, { "name":"404", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\"\n}" }, { "name":"503", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Service Unavailable", "code":503, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\"\n}" } ] } ], "auth":{ "type":"oauth2" }, "variable":[ { "key":"baseUrl", "value":"https://api.ext-sandbox.fourthline.com" } ] } ``` ```json API integration { "info":{ "_postman_id":"6c668fed-3f43-4492-9993-e5d85d851df0", "name":"French Solution: API integration", "schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id":"27570928" }, "item":[ { "name":"Create access token", "request":{ "method":"POST", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"raw", "raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"\",\n \"client_secret\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/oauth2/token", "host":[ "{{baseUrl}}" ], "path":[ "v1", "oauth2", "token" ] }, "description":"Use this endpoint to create an access token valid for **1 hour** to authenticate requests to our API.

**Tip**: To update already uploaded data, make another request with the **same** `verificationId`." }, "response":[ { "name":"200", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"nationality\": \"\",\n \"gender\": \"Female\",\n \"birthDate\": \"\",\n \"placeOfBirth\": \"\",\n \"initials\": \"\",\n \"middleName\": \"\",\n \"countryOfBirth\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"streetNumber\": \"\",\n \"postalCode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"streetNumberPrefix\": \"\",\n \"streetNumberSuffix\": \"\",\n \"region\": \"\"\n },\n \"emailAndPhone\": {\n \"email\": \"\",\n \"mobile\": \"\",\n \"phone\": \"\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"\",\n \"tin\": \"\",\n \"usPerson\": \"\",\n \"usTin\": \"\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"\",\n \"product\": \"\",\n \"sector\": \"\",\n \"sourceOfIncome\": \"\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"\",\n \"browserVersion\": \"\",\n \"ipAddress\": \"\",\n \"language\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"model\": \"\",\n \"osCompromised\": \"\",\n \"osVersion\": \"\",\n \"region\": \"\",\n \"sdkVersion\": \"\",\n \"analyticsId\": \"\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"\",\n \"FirstName\": \"\",\n \"LastName\": \"\",\n \"Nationality\": \"\",\n \"PlaceOfBirth\": \"\"\n }\n }", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdata", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdata" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"400", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"nationality\": \"\",\n \"gender\": \"Female\",\n \"birthDate\": \"\",\n \"placeOfBirth\": \"\",\n \"initials\": \"\",\n \"middleName\": \"\",\n \"countryOfBirth\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"streetNumber\": \"\",\n \"postalCode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"streetNumberPrefix\": \"\",\n \"streetNumberSuffix\": \"\",\n \"region\": \"\"\n },\n \"emailAndPhone\": {\n \"email\": \"\",\n \"mobile\": \"\",\n \"phone\": \"\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"\",\n \"tin\": \"\",\n \"usPerson\": \"\",\n \"usTin\": \"\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"\",\n \"product\": \"\",\n \"sector\": \"\",\n \"sourceOfIncome\": \"\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"\",\n \"browserVersion\": \"\",\n \"ipAddress\": \"\",\n \"language\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"model\": \"\",\n \"osCompromised\": \"\",\n \"osVersion\": \"\",\n \"region\": \"\",\n \"sdkVersion\": \"\",\n \"analyticsId\": \"\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"\",\n \"FirstName\": \"\",\n \"LastName\": \"\",\n \"Nationality\": \"\",\n \"PlaceOfBirth\": \"\"\n }\n }", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdata", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdata" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\",\n \"errors\": [\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n },\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n }\n ]\n}" }, { "name":"422", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"nationality\": \"\",\n \"gender\": \"Female\",\n \"birthDate\": \"\",\n \"placeOfBirth\": \"\",\n \"initials\": \"\",\n \"middleName\": \"\",\n \"countryOfBirth\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"streetNumber\": \"\",\n \"postalCode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"streetNumberPrefix\": \"\",\n \"streetNumberSuffix\": \"\",\n \"region\": \"\"\n },\n \"emailAndPhone\": {\n \"email\": \"\",\n \"mobile\": \"\",\n \"phone\": \"\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"\",\n \"tin\": \"\",\n \"usPerson\": \"\",\n \"usTin\": \"\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"\": \"yes\",\n \"placeOfWork\": \"\",\n \"product\": \"\",\n \"sector\": \"\",\n \"sourceOfIncome\": \"\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"\",\n \"browserVersion\": \"\",\n \"ipAddress\": \"\",\n \"language\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"model\": \"\",\n \"osCompromised\": \"\",\n \"osVersion\": \"\",\n \"region\": \"\",\n \"sdkVersion\": \"\",\n \"analyticsId\": \"\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"\",\n \"FirstName\": \"\",\n \"LastName\": \"\",\n \"Nationality\": \"\",\n \"PlaceOfBirth\": \"\"\n }\n }", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdata", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdata" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Unprocessable Entity (WebDAV) (RFC 4918)", "code":422, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] }, { "name":"Upload identity files", "request":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"Files", "value":"", "description":"(Required) Select the files to attach." }, { "key":"DocumentType", "value":"Selfie", "description":"(Required) The identity document data." }, { "key":"DocumentNumber", "value":"", "description":"(Required) The identity document data." }, { "key":"IsPrimaryDocument", "value":"true", "description":"(Required) The identity document data." }, { "key":"IssueDate", "value":"", "description":"(Required) The identity document data." }, { "key":"ExpirationDate", "value":"", "description":"(Required) The identity document data." }, { "key":"OriginTypeOs", "value":"", "description":"(Required) The identity document data." }, { "key":"KycFiles", "value":"[object Object],[object Object]", "description":"(Required) The identity document data." }, { "key":"NfcDataGroups", "value":"[object Object]", "description":"(Required) The identity document data." } ] }, "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdocument", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycdocument" ], "variable":[ { "key":"verificationId", "value":"", "description":"(Required) The `workflowId` returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"**API-only integration**: After uploading the [identity data](doc:upload-identity-data) and [identity files](doc:upload-identity-files), use this endpoint to trigger case processing." }, "response":[ { "name":"200", "originalRequest":{ "method":"POST", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycstart", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycstart" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"400", "originalRequest":{ "method":"POST", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycstart", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycstart" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\",\n \"errors\": [\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n },\n {\n \"code\": \"\",\n \"property\": \"\",\n \"message\": \"\"\n }\n ]\n}" }, { "name":"404", "originalRequest":{ "method":"POST", "header":[ { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycstart", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycstart" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" }, { "name":"422", "originalRequest":{ "method":"POST", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/kycstart", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "kycstart" ], "variable":[ { "key":"verificationId" } ] } }, "status":"Unprocessable Entity (WebDAV) (RFC 4918)", "code":422, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"errors\": \"\"\n}" } ] }, { "name":"Upload documents to sign", "request":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"traceId\": \"\",\n \"errors\": {\n \"documentsToSign\": [\n \"\",\n \"\"\n ]\n }\n}" }, { "name":"404", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\"\n}" }, { "name":"409", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Conflict", "code":409, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\"\n}" }, { "name":"422", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Unprocessable Entity (WebDAV) (RFC 4918)", "code":422, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\"\n}" } ] }, { "name":"Upload mobile phone number", "request":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"raw", "raw":"{\n \"mobilePhoneNumber\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/data", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "data" ], "variable":[ { "key":"workflowId", "value":"", "description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"Use this endpoint for Qualified Electronic Signature flows to upload the client’s mobile phone number for the [signature confirmation step](https://docs.fourthline.com/docs/qes-overview#signature-confirmation)." }, "response":[ { "name":"202", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"mobilePhoneNumber\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/data", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "data" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Accepted", "code":202, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"400", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"mobilePhoneNumber\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/data", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "data" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"traceId\": \"\",\n \"errors\": {\n \"MobilePhoneNumber\": [\n \"\",\n \"\"\n ]\n }\n}" }, { "name":"404", "originalRequest":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"mobilePhoneNumber\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/data", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "data" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\"\n}" } ] }, { "name":"Upload selfie", "request":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"selfie", "value":"", "description":"(Required) The client’s new selfie.
Format:
• JPEG image
• PNG image" } ] }, "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/selfie", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "selfie" ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) Our unique identifier for the signature returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`" } ] }, "description":"**API-only integration**: If the [signature status](https://docs.fourthline.com/docs/qes-statuses) changes to `selfie_required`, use this endpoint to upload the client’s selfie." }, "response":[ { "name":"200", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"selfie", "value":"", "description":"(Required) The client’s new selfie.
Format:
• JPEG image
• PNG image" } ] }, "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/selfie", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "selfie" ], "variable":[ { "key":"signatureId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"400", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"selfie", "value":"", "description":"(Required) The client’s new selfie.
Format:
• JPEG image
• PNG image" } ] }, "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/selfie", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "selfie" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\",\n \"signatureStatus\": \"\"\n}" }, { "name":"404", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"selfie", "value":"", "description":"(Required) The client’s new selfie.
Format:
• JPEG image
• PNG image" } ] }, "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/selfie", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "selfie" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\"\n}" }, { "name":"422", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"selfie", "value":"", "description":"(Required) The client’s new selfie.
Format:
• JPEG image
• PNG image" } ] }, "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/selfie", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "selfie" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Unprocessable Entity (WebDAV) (RFC 4918)", "code":422, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"detail\": \"\",\n \"traceId\": \"\"\n}" }, { "name":"500", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"selfie", "value":"", "description":"(Required) The client’s new selfie.
Format:
• JPEG image
• PNG image" } ] }, "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/selfie", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "selfie" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Internal Server Error", "code":500, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" } ] }, { "name":"Get signature details", "request":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/details?lang=it", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "details" ], "query":[ { "key":"lang", "value":"it", "description":"The language of the QTSP legal conditions.
Format: ISO 639-1 alpha-2
Enum:
• `de`: German
• `en`: English (default)
• `es`: Spanish
• `fr`: French
• `it`: Italian
• `pl`: Polish
• `ro`: Romanian" } ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) Our unique identifier for the signature returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`" } ] }, "description":"**API-only integration**: When the [signature status](https://docs.fourthline.com/docs/qes-statuses) changes to `user_consent_required`, 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." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/details?lang=it", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "details" ], "query":[ { "key":"lang", "value":"it", "description":"The language of the QTSP legal conditions.
Format: ISO 639-1 alpha-2
Enum:
• `de`: German
• `en`: English (default)
• `es`: Spanish
• `fr`: French
• `it`: Italian
• `pl`: Polish
• `ro`: Romanian" } ], "variable":[ { "key":"signatureId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"clientId\": \"\",\n \"verificationId\": \"\",\n \"mobilePhoneNumber\": \"\",\n \"documentsToSign\": [\n {\n \"id\": \"\",\n \"fileName\": \"\",\n \"displayName\": \"\"\n },\n {\n \"id\": \"\",\n \"fileName\": \"\",\n \"displayName\": \"\"\n }\n ],\n \"legalDocuments\": [\n {\n \"displayName\": \"\",\n \"id\": \"\",\n \"url\": \"\",\n \"version\": \"\"\n },\n {\n \"displayName\": \"\",\n \"id\": \"\",\n \"url\": \"\",\n \"version\": \"\"\n }\n ],\n \"otpSettings\": [\n {\n \"validation\": \"\",\n \"version\": \"\"\n },\n {\n \"validation\": \"\",\n \"version\": \"\"\n }\n ]\n}" }, { "name":"400", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/details?lang=it", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "details" ], "query":[ { "key":"lang", "value":"it", "description":"The language of the QTSP legal conditions.
Format: ISO 639-1 alpha-2
Enum:
• `de`: German
• `en`: English (default)
• `es`: Spanish
• `fr`: French
• `it`: Italian
• `pl`: Polish
• `ro`: Romanian" } ], "variable":[ { "key":"signatureId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"traceId\": \"\",\n \"errors\": {\n \"signatureId\": [\n \"\",\n \"\"\n ]\n }\n}" }, { "name":"404", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/details?lang=it", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "details" ], "query":[ { "key":"lang", "value":"it", "description":"The language of the QTSP legal conditions.
Format: ISO 639-1 alpha-2
Enum:
• `de`: German
• `en`: English (default)
• `es`: Spanish
• `fr`: French
• `it`: Italian
• `pl`: Polish
• `ro`: Romanian" } ], "variable":[ { "key":"signatureId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"detail\": \"\",\n \"traceId\": \" ### German solution ```json App Drop-in { "info":{ "_postman_id":"51e08d92-6245-43fe-a16a-809970a15c1a", "name":"German Solution: App Drop-in", "schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id":"27570928" }, "item":[ { "name":"Create access token", "request":{ "method":"POST", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"raw", "raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"\",\n \"client_secret\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/oauth2/token", "host":[ "{{baseUrl}}" ], "path":[ "v1", "oauth2", "token" ] }, "description":"Use this endpoint to create an access token valid for **1 hour** to authenticate requests to our API.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"traceId\": \"\",\n \"errors\": {\n \"documentsToSign\": [\n \"\",\n \"\"\n ]\n }\n}" }, { "name":"404", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\"\n}" }, { "name":"409", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Conflict", "code":409, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\"\n}" }, { "name":"422", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/x-www-form-urlencoded" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"urlencoded", "urlencoded":[ { "key":"documentsToSign", "value":"[object Object]", "description":"(Required) An array of form data objects, one for each uploaded document to sign.

**Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored.

**Required** headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json" }, { "key":"files", "value":"", "description":"(Required) An array of form data files, one for each document to sign.
**Required** headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`)
Content-Type: application/pdf" } ] }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "documentsToSign" ], "variable":[ { "key":"workflowId" } ] } }, "status":"Unprocessable Entity (WebDAV) (RFC 4918)", "code":422, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"message\": \"\",\n \"code\": \"\"\n}" } ] }, { "name":"Upload mobile phone number", "request":{ "method":"PUT", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"raw", "raw":"{\n \"mobilePhoneNumber\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/data", "host":[ "{{baseUrl}}" ], "path":[ "v1", "onboarding", "signatures", ":workflowId", "data" ], "variable":[ { "key":"workflowId", "value":"", "description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: To receive status updates automatically, set up a [webhook](https://docs.fourthline.com/docs/webhooks)." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":verificationId", "verificationresult" ], "variable":[ { "key":"verificationId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"verificationId\": \"\",\n \"verificationStatus\": \"\",\n \"dataValidationError\": {}\n}" } ] }, { "name":"Get CDD PDF", "request":{ "method":"GET", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Accept", "value":"text/plain" } ], "url":{ "raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult", "host":[ "{{baseUrl}}" ], "path":[ "v1", "verifications", ":workflowId", "getpdfresult" ], "variable":[ { "key":"workflowId", "value":"", "description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"Use this endpoint to check the [status](https://docs.fourthline.com/docs/bav-statuses) of a Bank Account Verification reference payment.

**Tip**: Use this as the case reference number for any questions." } ] }, "description":"Use this endpoint to get the [status](https://docs.fourthline.com/docs/qes-statuses) of a signature flow.

**Tip**: To receive status updates automatically, set up a [webhook](https://docs.fourthline.com/docs/webhooks)." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"statusCode\": \"\"\n}" }, { "name":"400", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"traceId\": \"\",\n \"errors\": {\n \"signatureId\": [\n \"\",\n \"\"\n ]\n }\n}" }, { "name":"404", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"detail\": \"\",\n \"traceId\": \"\"\n}" } ] }, { "name":"Get signed documents", "request":{ "method":"GET", "header":[ { "key":"Accept", "value":"text/plain" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/signedDocuments/:documentId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "signedDocuments", ":documentId" ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) The `workflowId` returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`

**Tip**: Use this as the case reference number for any questions." }, { "key":"documentId", "value":"", "description":"(Required) Your unique identifier for the signed document that you passed in the [Upload documents to sign](doc:upload-documents-to-sign) request (`documentId`)." } ] }, "description":"Use this endpoint to download the signed documents when the [signature status](https://docs.fourthline.com/docs/qes-statuses) changes to `signed`." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/signedDocuments/:documentId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "signedDocuments", ":documentId" ], "variable":[ { "key":"signatureId" }, { "key":"documentId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{\n \"examples\": {\n \"OK\": {\n \"value\": \"HTTP/1.1 200 OK\\nDate: Thu, 09 Jun 2022 12:49:03 GMT\\nContent-Type: application/pdf\\nTransfer-Encoding: chunked\\nConnection: close\\nContent-Disposition: attachment; filename=agreement1.pdf; filename*=UTF-8''agreement1.pdf\\napi-supported-versions: 1.0\\n{{binary content of the signed document}}\"\n }\n }\n}" }, { "name":"400", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/signedDocuments/:documentId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "signedDocuments", ":documentId" ], "variable":[ { "key":"signatureId" }, { "key":"documentId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\",\n \"signatureStatus\": \"\"\n}" }, { "name":"404", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/signedDocuments/:documentId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "signedDocuments", ":documentId" ], "variable":[ { "key":"signatureId" }, { "key":"documentId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"detail\": \"\",\n \"traceId\": \"\"\n}" } ] }, { "name":"Get InfoCert contract", "request":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) Our unique identifier for the signature returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`" } ] }, "description":"If you have the [fallback QTSP](https://docs.fourthline.com/docs/qes-integration#qtsps) option configured, when the signature status changes to `signed`, use this endpoint to check if an InfoCert contract was generated to share with the client." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"204", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId" } ] } }, "status":"No Content", "code":204, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"400", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{}" }, { "name":"404", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/qtspAgreement", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "qtspAgreement" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] }, { "name":"Test signature flow", "request":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"text/plain" } ], "body":{ "mode":"raw", "raw":"{\n \"deviceMetaData\": {\n \"language\": \"\",\n \"model\": \"\",\n \"region\": \"\",\n \"ipAddress\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"\",\n \"verificationId\": \"\"\n },\n \"mobilePhoneNumber\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/testendpoint/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "testendpoint", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) Our unique identifier for the signature, returned in the [Create signature](doc:create-a-sign-request).
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`" } ] }, "description":"**Sandbox environment only**: Use this endpoint to start the signature flow for a test signature with a target status, using any successfully completed `verificationId`." }, "response":[ { "name":"202", "originalRequest":{ "method":"POST", "header":[ { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"text/plain" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "body":{ "mode":"raw", "raw":"{\n \"deviceMetaData\": {\n \"language\": \"\",\n \"model\": \"\",\n \"region\": \"\",\n \"ipAddress\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"\",\n \"verificationId\": \"\"\n },\n \"mobilePhoneNumber\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/testendpoint/signatures/:signatureId", "host":[ "{{baseUrl}}" ], "path":[ "v1", "testendpoint", "signatures", ":signatureId" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Accepted", "code":202, "_postman_previewlanguage":"text", "header":[ { "key":"Content-Type", "value":"text/plain" } ], "cookie":[ ], "body":"{}" } ] }, { "name":"Get test passcode", "request":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId", "value":"", "description":"(Required) The `workflowId` returned in the [Create workflow](doc:create-workflow) response.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`" } ] }, "description":"**Sandbox environment only**: Use this endpoint to get a one-time passcode to confirm a test signature, without requiring a valid mobile phone number.
The signature status must be `confirmation_required`.
To automate testing the signature flow, in the [Upload mobile phone number](doc:upload-mobile-phone-number) request, provide a dummy mobile phone number in the following format: +39 111111234567. You can change the digits 234567 as required." }, "response":[ { "name":"200", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId" } ] } }, "status":"OK", "code":200, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"otp\": \"\"\n}" }, { "name":"400", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Bad Request", "code":400, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\",\n \"signatureStatus\": \"\"\n}" }, { "name":"404", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Not Found", "code":404, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\"\n}" }, { "name":"503", "originalRequest":{ "method":"GET", "header":[ { "key":"Accept", "value":"application/json" }, { "description":"Added as a part of security scheme: oauth2", "key":"Authorization", "value":"" } ], "url":{ "raw":"{{baseUrl}}/v1/signatures/:signatureId/otp", "host":[ "{{baseUrl}}" ], "path":[ "v1", "signatures", ":signatureId", "otp" ], "variable":[ { "key":"signatureId" } ] } }, "status":"Service Unavailable", "code":503, "_postman_previewlanguage":"json", "header":[ { "key":"Content-Type", "value":"application/json" } ], "cookie":[ ], "body":"{\n \"status\": \"\",\n \"detail\": \"\"\n}" } ] } ], "auth":{ "type":"oauth2" }, "variable":[ { "key":"baseUrl", "value":"https://api.ext-sandbox.fourthline.com" } ] } ``` ```json Web SDK { "info":{ "_postman_id":"97d89a25-815f-4202-b29e-9e4dff97ccfe", "name":"German Solution: Web SDK", "schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id":"27570928" }, "item":[ { "name":"Create access token", "request":{ "method":"POST", "header":[ { "description":"To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to `no-cache`.", "key":"Cache-Control", "value":"" }, { "key":"Content-Type", "value":"application/json" }, { "key":"Accept", "value":"application/json" } ], "body":{ "mode":"raw", "raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"\",\n \"client_secret\": \"\"\n}", "options":{ "raw":{ "headerFamily":"json", "language":"json" } } }, "url":{ "raw":"{{baseUrl}}/v1/oauth2/token", "host":[ "{{baseUrl}}" ], "path":[ "v1", "oauth2", "token" ] }, "description":"Use this endpoint to create an access token valid for **1 hour** to authenticate requests to our API.