Postman Collections
Developer tools
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
{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create workflow",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
},
"description":"Use this endpoint to create a workflow."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"workflowId\": \"<string>\",\n \"clientId\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\n}"
},
{
"name":"401",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Unauthorized",
"code":401,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error\": \"<string>\",\n \"error_description\": \"<string>\"\n}"
},
{
"name":"403",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Forbidden",
"code":403,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"500",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Internal Server Error",
"code":500,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"expiryDateTime\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"error_description\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"verificationresult"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"verificationStatus\": \"<string>\",\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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":workflowId",
"getpdfresult"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/reports",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"reports"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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 GLOSSARY:IDENTITY DATA in an XML file including any Fourthline corrections, and all supporting identity files. <br><br><img src=\"https://files.readme.io/ad2486a-Inline_Note.svg\" align=\"left\"/> **Note**: We **don’t** 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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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"
}
]
}
{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create workflow",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
},
"description":"Use this endpoint to create a workflow."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"workflowId\": \"<string>\",\n \"clientId\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\n}"
},
{
"name":"401",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Unauthorized",
"code":401,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error\": \"<string>\",\n \"error_description\": \"<string>\"\n}"
},
{
"name":"403",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Forbidden",
"code":403,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"500",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Internal Server Error",
"code":500,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"name":"Upload identity data",
"request":{
"method":"PUT",
"header":[
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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 GLOSSARY:PERSONAL DATA for an Identity Verification case. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"expiryDateTime\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"error_description\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"verificationresult"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"verificationStatus\": \"<string>\",\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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":workflowId",
"getpdfresult"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/reports",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"reports"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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 GLOSSARY:IDENTITY DATA in an XML file including any Fourthline corrections, and all supporting identity files. <br><br><img src=\"https://files.readme.io/ad2486a-Inline_Note.svg\" align=\"left\"/> **Note**: We **don’t** 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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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"
}
]
}
{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create workflow",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
},
"description":"Use this endpoint to create a workflow."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"workflowId\": \"<string>\",\n \"clientId\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\n}"
},
{
"name":"401",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Unauthorized",
"code":401,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error\": \"<string>\",\n \"error_description\": \"<string>\"\n}"
},
{
"name":"403",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Forbidden",
"code":403,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"500",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Internal Server Error",
"code":500,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"name":"Upload identity data",
"request":{
"method":"PUT",
"header":[
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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 GLOSSARY:PERSONAL DATA for an Identity Verification case. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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":"<string>",
"description":"(Required) Select the files to attach."
},
{
"key":"DocumentType",
"value":"Selfie",
"description":"(Required) The ID document data."
},
{
"key":"DocumentNumber",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"IsPrimaryDocument",
"value":"true",
"description":"(Required) The ID document data."
},
{
"key":"IssueDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"ExpirationDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"OriginTypeOs",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"KycFiles",
"value":"[object Object],[object Object]",
"description":"(Required) The ID document data."
},
{
"key":"NfcDataGroups",
"value":"[object Object]",
"description":"(Required) The ID document data."
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdocument",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"kycdocument"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
}
]
},
"description":"**API-only integration**: Use this endpoint to upload the client’s ID document(s) and GLOSSARY:IDENTITY FILES for an Identity Verification case. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/>**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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"Files",
"value":"<string>",
"description":"(Required) Select the files to attach."
},
{
"key":"DocumentType",
"value":"Selfie",
"description":"(Required) The ID document data."
},
{
"key":"DocumentNumber",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"IsPrimaryDocument",
"value":"true",
"description":"(Required) The ID document data."
},
{
"key":"IssueDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"ExpirationDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"OriginTypeOs",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"KycFiles",
"value":"[object Object],[object Object]",
"description":"(Required) The ID document data."
},
{
"key":"NfcDataGroups",
"value":"[object Object]",
"description":"(Required) The ID 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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"Files",
"value":"<string>",
"description":"(Required) Select the files to attach."
},
{
"key":"DocumentType",
"value":"Selfie",
"description":"(Required) The ID document data."
},
{
"key":"DocumentNumber",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"IsPrimaryDocument",
"value":"true",
"description":"(Required) The ID document data."
},
{
"key":"IssueDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"ExpirationDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"OriginTypeOs",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"KycFiles",
"value":"[object Object],[object Object]",
"description":"(Required) The ID document data."
},
{
"key":"NfcDataGroups",
"value":"[object Object]",
"description":"(Required) The ID 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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"Files",
"value":"<string>",
"description":"(Required) Select the files to attach."
},
{
"key":"DocumentType",
"value":"Selfie",
"description":"(Required) The ID document data."
},
{
"key":"DocumentNumber",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"IsPrimaryDocument",
"value":"true",
"description":"(Required) The ID document data."
},
{
"key":"IssueDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"ExpirationDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"OriginTypeOs",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"KycFiles",
"value":"[object Object],[object Object]",
"description":"(Required) The ID document data."
},
{
"key":"NfcDataGroups",
"value":"[object Object]",
"description":"(Required) The ID 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\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
}
]
},
"description":"**API-only integration**: After uploading the [identity data](https://docs.fourthline.com/reference/upload-identity-data) and [identity files](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<string>\",\n \"code\": \"<string>\",\n \"errors\": [\n {\n \"code\": \"<string>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<string>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<string>\",\n \"errors\": \"<array>\"\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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"verificationresult"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"verificationStatus\": \"<string>\",\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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":workflowId",
"getpdfresult"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/reports",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"reports"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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 GLOSSARY:IDENTITY DATA in an XML file including any Fourthline corrections, and all supporting identity files. <br><br><img src=\"https://files.readme.io/ad2486a-Inline_Note.svg\" align=\"left\"/> **Note**: We **don’t** 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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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
{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create workflow",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
},
"description":"Use this endpoint to create a workflow."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"workflowId\": \"<string>\",\n \"clientId\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\n}"
},
{
"name":"401",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Unauthorized",
"code":401,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error\": \"<string>\",\n \"error_description\": \"<string>\"\n}"
},
{
"name":"403",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Forbidden",
"code":403,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"500",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Internal Server Error",
"code":500,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> Content-Type: application/pdf"
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"onboarding",
"signatures",
":workflowId",
"documentsToSign"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"documentsToSign\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"MobilePhoneNumber\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"expiryDateTime\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"error_description\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"verificationresult"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"verificationStatus\": \"<string>\",\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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":workflowId",
"getpdfresult"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/reports",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"reports"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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 GLOSSARY:IDENTITY DATA in an XML file including any Fourthline corrections, and all supporting identity files. <br><br><img src=\"https://files.readme.io/ad2486a-Inline_Note.svg\" align=\"left\"/> **Note**: We **don’t** 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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"{}"
}
]
},
{
"name":"Get signature status",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId"
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"statusCode\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"signatureId\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
},
{
"key":"documentId",
"value":"<string>",
"description":"(Required) Your unique identifier for the signed document that you passed in the [Upload documents to sign](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature, returned in the [Create signature](https://docs.fourthline.com/reference/create-a-sign-request). <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"deviceMetaData\": {\n \"language\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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. <br>The signature status must be `confirmation_required`. <br>To automate testing the signature flow, in the [Upload mobile phone number](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"503",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
}
],
"auth":{
"type":"oauth2"
},
"variable":[
{
"key":"baseUrl",
"value":"https://api.ext-sandbox.fourthline.com"
}
]
}
{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create workflow",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
},
"description":"Use this endpoint to create a workflow."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"workflowId\": \"<string>\",\n \"clientId\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\n}"
},
{
"name":"401",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Unauthorized",
"code":401,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error\": \"<string>\",\n \"error_description\": \"<string>\"\n}"
},
{
"name":"403",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Forbidden",
"code":403,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"500",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Internal Server Error",
"code":500,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"name":"Upload identity data",
"request":{
"method":"PUT",
"header":[
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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 GLOSSARY:PERSONAL DATA for an Identity Verification case. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> Content-Type: application/pdf"
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"onboarding",
"signatures",
":workflowId",
"documentsToSign"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"documentsToSign\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"MobilePhoneNumber\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"expiryDateTime\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"error_description\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"verificationresult"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"verificationStatus\": \"<string>\",\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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":workflowId",
"getpdfresult"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/reports",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"reports"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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 GLOSSARY:IDENTITY DATA in an XML file including any Fourthline corrections, and all supporting identity files. <br><br><img src=\"https://files.readme.io/ad2486a-Inline_Note.svg\" align=\"left\"/> **Note**: We **don’t** 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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"{}"
}
]
},
{
"name":"Get signature status",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId"
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"statusCode\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"signatureId\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
},
{
"key":"documentId",
"value":"<string>",
"description":"(Required) Your unique identifier for the signed document that you passed in the [Upload documents to sign](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature, returned in the [Create signature](https://docs.fourthline.com/reference/create-a-sign-request). <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"deviceMetaData\": {\n \"language\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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. <br>The signature status must be `confirmation_required`. <br>To automate testing the signature flow, in the [Upload mobile phone number](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"503",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
}
],
"auth":{
"type":"oauth2"
},
"variable":[
{
"key":"baseUrl",
"value":"https://api.ext-sandbox.fourthline.com"
}
]
}
{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create workflow",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
},
"description":"Use this endpoint to create a workflow."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"workflowId\": \"<string>\",\n \"clientId\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\n}"
},
{
"name":"401",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Unauthorized",
"code":401,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error\": \"<string>\",\n \"error_description\": \"<string>\"\n}"
},
{
"name":"403",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Forbidden",
"code":403,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"500",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Internal Server Error",
"code":500,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"name":"Upload identity data",
"request":{
"method":"PUT",
"header":[
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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 GLOSSARY:PERSONAL DATA for an Identity Verification case. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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":"<string>",
"description":"(Required) Select the files to attach."
},
{
"key":"DocumentType",
"value":"Selfie",
"description":"(Required) The ID document data."
},
{
"key":"DocumentNumber",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"IsPrimaryDocument",
"value":"true",
"description":"(Required) The ID document data."
},
{
"key":"IssueDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"ExpirationDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"OriginTypeOs",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"KycFiles",
"value":"[object Object],[object Object]",
"description":"(Required) The ID document data."
},
{
"key":"NfcDataGroups",
"value":"[object Object]",
"description":"(Required) The ID document data."
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/kycdocument",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"kycdocument"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
}
]
},
"description":"**API-only integration**: Use this endpoint to upload the client’s ID document(s) and GLOSSARY:IDENTITY FILES for an Identity Verification case. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/>**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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"Files",
"value":"<string>",
"description":"(Required) Select the files to attach."
},
{
"key":"DocumentType",
"value":"Selfie",
"description":"(Required) The ID document data."
},
{
"key":"DocumentNumber",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"IsPrimaryDocument",
"value":"true",
"description":"(Required) The ID document data."
},
{
"key":"IssueDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"ExpirationDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"OriginTypeOs",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"KycFiles",
"value":"[object Object],[object Object]",
"description":"(Required) The ID document data."
},
{
"key":"NfcDataGroups",
"value":"[object Object]",
"description":"(Required) The ID 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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"Files",
"value":"<string>",
"description":"(Required) Select the files to attach."
},
{
"key":"DocumentType",
"value":"Selfie",
"description":"(Required) The ID document data."
},
{
"key":"DocumentNumber",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"IsPrimaryDocument",
"value":"true",
"description":"(Required) The ID document data."
},
{
"key":"IssueDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"ExpirationDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"OriginTypeOs",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"KycFiles",
"value":"[object Object],[object Object]",
"description":"(Required) The ID document data."
},
{
"key":"NfcDataGroups",
"value":"[object Object]",
"description":"(Required) The ID 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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"Files",
"value":"<string>",
"description":"(Required) Select the files to attach."
},
{
"key":"DocumentType",
"value":"Selfie",
"description":"(Required) The ID document data."
},
{
"key":"DocumentNumber",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"IsPrimaryDocument",
"value":"true",
"description":"(Required) The ID document data."
},
{
"key":"IssueDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"ExpirationDate",
"value":"<date>",
"description":"(Required) The ID document data."
},
{
"key":"OriginTypeOs",
"value":"<string>",
"description":"(Required) The ID document data."
},
{
"key":"KycFiles",
"value":"[object Object],[object Object]",
"description":"(Required) The ID document data."
},
{
"key":"NfcDataGroups",
"value":"[object Object]",
"description":"(Required) The ID 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\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
}
]
},
"description":"**API-only integration**: After uploading the [identity data](https://docs.fourthline.com/reference/upload-identity-data) and [identity files](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<string>\",\n \"code\": \"<string>\",\n \"errors\": [\n {\n \"code\": \"<string>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<string>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<string>\",\n \"errors\": \"<array>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> Content-Type: application/pdf"
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"onboarding",
"signatures",
":workflowId",
"documentsToSign"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"documentsToSign\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"MobilePhoneNumber\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<integer>\",\n \"detail\": \"<string>\"\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":"<string>",
"description":"(Required) The client’s new selfie. <br>Format: <br>• JPEG image <br>• PNG image"
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/selfie",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"selfie"
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"selfie",
"value":"<string>",
"description":"(Required) The client’s new selfie. <br>Format: <br>• JPEG image <br>• 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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"selfie",
"value":"<string>",
"description":"(Required) The client’s new selfie. <br>Format: <br>• JPEG image <br>• 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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"selfie",
"value":"<string>",
"description":"(Required) The client’s new selfie. <br>Format: <br>• JPEG image <br>• 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\": \"<integer>\",\n \"detail\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"selfie",
"value":"<string>",
"description":"(Required) The client’s new selfie. <br>Format: <br>• JPEG image <br>• 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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"selfie",
"value":"<string>",
"description":"(Required) The client’s new selfie. <br>Format: <br>• JPEG image <br>• 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. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fr`: French <br> • `it`: Italian <br> • `pl`: Polish <br> • `ro`: Romanian"
}
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"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. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fr`: French <br> • `it`: Italian <br> • `pl`: Polish <br> • `ro`: Romanian"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"clientId\": \"<string>\",\n \"verificationId\": \"<string>\",\n \"mobilePhoneNumber\": \"<string>\",\n \"documentsToSign\": [\n {\n \"id\": \"<string>\",\n \"fileName\": \"<string>\",\n \"displayName\": \"<string>\"\n },\n {\n \"id\": \"<string>\",\n \"fileName\": \"<string>\",\n \"displayName\": \"<string>\"\n }\n ],\n \"legalDocuments\": [\n {\n \"displayName\": \"<string>\",\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"displayName\": \"<string>\",\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ],\n \"otpSettings\": [\n {\n \"validation\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"validation\": \"<string>\",\n \"version\": \"<integer>\"\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":"<token>"
}
],
"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. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fr`: French <br> • `it`: Italian <br> • `pl`: Polish <br> • `ro`: Romanian"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"type\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"signatureId\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"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. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fr`: French <br> • `it`: Italian <br> • `pl`: Polish <br> • `ro`: Romanian"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Not Found",
"code":404,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"type\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
}
]
},
{
"name":"Approve documents to sign",
"request":{
"method":"POST",
"header":[
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"authorizedDocuments\": [\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n },\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n }\n ],\n \"legalDocumentsAccepted\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/authorize?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"authorize"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"**API-only integration**: When the [signature status](https://docs.fourthline.com/docs/qes-statuses) changes to `user_consent_required` and **after** making the [Get signature details](https://docs.fourthline.com/reference/get-signature-details) request, use this endpoint to confirm that the client has approved the documents to sign and accepted the QTSP legal conditions. <br><br> <img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: When testing this endpoint, you must use a **real** ID document with an GLOSSARY:MRZ or GLOSSARY:VIZ."
},
"response":[
{
"name":"202",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"authorizedDocuments\": [\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n },\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n }\n ],\n \"legalDocumentsAccepted\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/authorize?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"authorize"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Accepted",
"code":202,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"attemptId\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"authorizedDocuments\": [\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n },\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n }\n ],\n \"legalDocumentsAccepted\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/authorize?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"authorize"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"authorizedDocuments\": [\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n },\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n }\n ],\n \"legalDocumentsAccepted\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/authorize?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"authorize"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Not Found",
"code":404,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"409",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"authorizedDocuments\": [\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n },\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n }\n ],\n \"legalDocumentsAccepted\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/authorize?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"authorize"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Conflict",
"code":409,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"type\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
},
{
"name":"429",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"authorizedDocuments\": [\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n },\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n }\n ],\n \"legalDocumentsAccepted\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/authorize?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"authorize"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Too Many Requests",
"code":429,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
}
]
},
{
"name":"Confirm signature",
"request":{
"method":"POST",
"header":[
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"otp\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/confirm",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"confirm"
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"**API-only integration**: When the [signature status](https://docs.fourthline.com/docs/qes-statuses) changes to `confirmation_required`, use this endpoint to validate the one-time passcode and confirm the signature."
},
"response":[
{
"name":"202",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"otp\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/confirm",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"confirm"
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Accepted",
"code":202,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"attemptId\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"otp\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/confirm",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"confirm"
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"409",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"otp\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/confirm",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"confirm"
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Conflict",
"code":409,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"type\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
},
{
"name":"422",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"otp\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/confirm",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"confirm"
],
"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\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
},
{
"name":"429",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"otp\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/confirm",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"confirm"
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Too Many Requests",
"code":429,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
}
]
},
{
"name":"Resend signature passcode",
"request":{
"method":"POST",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/resendOtp?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"resendOtp"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"**API-only integration**: If something went wrong entering the one-time passcode in the signature flow, use this endpoint to resend the passcode to the client."
},
"response":[
{
"name":"202",
"originalRequest":{
"method":"POST",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/resendOtp?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"resendOtp"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Accepted",
"code":202,
"_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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/resendOtp?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"resendOtp"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"POST",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/resendOtp?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"resendOtp"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Not Found",
"code":404,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"422",
"originalRequest":{
"method":"POST",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/resendOtp?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"resendOtp"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Unprocessable Entity (WebDAV) (RFC 4918)",
"code":422,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
},
{
"name":"429",
"originalRequest":{
"method":"POST",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/resendOtp?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"resendOtp"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Too Many Requests",
"code":429,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"verificationresult"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"verificationStatus\": \"<string>\",\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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":workflowId",
"getpdfresult"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/reports",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"reports"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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 GLOSSARY:IDENTITY DATA in an XML file including any Fourthline corrections, and all supporting identity files. <br><br><img src=\"https://files.readme.io/ad2486a-Inline_Note.svg\" align=\"left\"/> **Note**: We **don’t** 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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"{}"
}
]
},
{
"name":"Get signature status",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId"
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"statusCode\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"signatureId\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
},
{
"key":"documentId",
"value":"<string>",
"description":"(Required) Your unique identifier for the signed document that you passed in the [Upload documents to sign](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature, returned in the [Create signature](https://docs.fourthline.com/reference/create-a-sign-request). <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"deviceMetaData\": {\n \"language\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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. <br>The signature status must be `confirmation_required`. <br>To automate testing the signature flow, in the [Upload mobile phone number](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"503",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
}
],
"auth":{
"type":"oauth2"
},
"variable":[
{
"key":"baseUrl",
"value":"https://api.ext-sandbox.fourthline.com"
}
]
}
German solution
{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create workflow",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
},
"description":"Use this endpoint to create a workflow."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"workflowId\": \"<string>\",\n \"clientId\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\n}"
},
{
"name":"401",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Unauthorized",
"code":401,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error\": \"<string>\",\n \"error_description\": \"<string>\"\n}"
},
{
"name":"403",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Forbidden",
"code":403,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"500",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Internal Server Error",
"code":500,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> Content-Type: application/pdf"
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"onboarding",
"signatures",
":workflowId",
"documentsToSign"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"documentsToSign\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"MobilePhoneNumber\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"expiryDateTime\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"error_description\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"verificationresult"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"verificationStatus\": \"<string>\",\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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":workflowId",
"getpdfresult"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/reports",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"reports"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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 GLOSSARY:IDENTITY DATA in an XML file including any Fourthline corrections, and all supporting identity files. <br><br><img src=\"https://files.readme.io/ad2486a-Inline_Note.svg\" align=\"left\"/> **Note**: We **don’t** 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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"{}"
}
]
},
{
"name":"Get reference payment status",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/referencePayments/status/:paymentId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"referencePayments",
"status",
":paymentId"
],
"variable":[
{
"key":"paymentId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/referencePayments/status/:paymentId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"referencePayments",
"status",
":paymentId"
],
"variable":[
{
"key":"paymentId"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/referencePayments/status/:paymentId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"referencePayments",
"status",
":paymentId"
],
"variable":[
{
"key":"paymentId"
}
]
}
},
"status":"Not Found",
"code":404,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{}"
}
]
},
{
"name":"Get signature status",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId"
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"statusCode\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"signatureId\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
},
{
"key":"documentId",
"value":"<string>",
"description":"(Required) Your unique identifier for the signed document that you passed in the [Upload documents to sign](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature, returned in the [Create signature](https://docs.fourthline.com/reference/create-a-sign-request). <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"deviceMetaData\": {\n \"language\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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. <br>The signature status must be `confirmation_required`. <br>To automate testing the signature flow, in the [Upload mobile phone number](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"503",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
}
],
"auth":{
"type":"oauth2"
},
"variable":[
{
"key":"baseUrl",
"value":"https://api.ext-sandbox.fourthline.com"
}
]
}
{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create workflow",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
},
"description":"Use this endpoint to create a workflow."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"workflowId\": \"<string>\",\n \"clientId\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\n}"
},
{
"name":"401",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Unauthorized",
"code":401,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error\": \"<string>\",\n \"error_description\": \"<string>\"\n}"
},
{
"name":"403",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Forbidden",
"code":403,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"500",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Internal Server Error",
"code":500,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"name":"Upload identity data",
"request":{
"method":"PUT",
"header":[
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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 GLOSSARY:PERSONAL DATA for an Identity Verification case. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"M\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> Content-Type: application/pdf"
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"onboarding",
"signatures",
":workflowId",
"documentsToSign"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"documentsToSign\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"MobilePhoneNumber\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"expiryDateTime\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"error_description\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/verificationresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"verificationresult"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"verificationStatus\": \"<string>\",\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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":workflowId",
"getpdfresult"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/reports",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"reports"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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 GLOSSARY:IDENTITY DATA in an XML file including any Fourthline corrections, and all supporting identity files. <br><br><img src=\"https://files.readme.io/ad2486a-Inline_Note.svg\" align=\"left\"/> **Note**: We **don’t** 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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"{}"
}
]
},
{
"name":"Get reference payment status",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/referencePayments/status/:paymentId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"referencePayments",
"status",
":paymentId"
],
"variable":[
{
"key":"paymentId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/referencePayments/status/:paymentId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"referencePayments",
"status",
":paymentId"
],
"variable":[
{
"key":"paymentId"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/referencePayments/status/:paymentId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"referencePayments",
"status",
":paymentId"
],
"variable":[
{
"key":"paymentId"
}
]
}
},
"status":"Not Found",
"code":404,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{}"
}
]
},
{
"name":"Get signature status",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId"
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"statusCode\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"signatureId\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
},
{
"key":"documentId",
"value":"<string>",
"description":"(Required) Your unique identifier for the signed document that you passed in the [Upload documents to sign](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature, returned in the [Create signature](https://docs.fourthline.com/reference/create-a-sign-request). <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"deviceMetaData\": {\n \"language\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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. <br>The signature status must be `confirmation_required`. <br>To automate testing the signature flow, in the [Upload mobile phone number](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"503",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
}
],
"auth":{
"type":"oauth2"
},
"variable":[
{
"key":"baseUrl",
"value":"https://api.ext-sandbox.fourthline.com"
}
]
}
Qualified Electronic Signature
{
"info":{
"_postman_id":"51325510-b010-4713-95fa-0d276c0dc457",
"name":"Qualified Electronic Signature: App Drop-in & 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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create workflow",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
},
"description":"Use this endpoint to create a workflow."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"workflowId\": \"<string>\",\n \"clientId\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\n}"
},
{
"name":"401",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Unauthorized",
"code":401,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error\": \"<string>\",\n \"error_description\": \"<string>\"\n}"
},
{
"name":"403",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Forbidden",
"code":403,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"500",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Internal Server Error",
"code":500,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> Content-Type: application/pdf"
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"onboarding",
"signatures",
":workflowId",
"documentsToSign"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"documentsToSign\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"MobilePhoneNumber\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"expiryDateTime\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"error_description\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"name":"Get signature status",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId"
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"statusCode\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"signatureId\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
},
{
"key":"documentId",
"value":"<string>",
"description":"(Required) Your unique identifier for the signed document that you passed in the [Upload documents to sign](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature, returned in the [Create signature](https://docs.fourthline.com/reference/create-a-sign-request). <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"deviceMetaData\": {\n \"language\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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. <br>The signature status must be `confirmation_required`. <br>To automate testing the signature flow, in the [Upload mobile phone number](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"503",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
}
],
"auth":{
"type":"oauth2"
},
"variable":[
{
"key":"baseUrl",
"value":"https://api.ext-sandbox.fourthline.com"
}
]
}
{
"info":{
"_postman_id":"e764f20a-455d-42f3-927f-3635fbcbcd63",
"name":"Qualified Electronic Signature: 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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create workflow",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
},
"description":"Use this endpoint to create a workflow."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"workflowId\": \"<string>\",\n \"clientId\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\n}"
},
{
"name":"401",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Unauthorized",
"code":401,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error\": \"<string>\",\n \"error_description\": \"<string>\"\n}"
},
{
"name":"403",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Forbidden",
"code":403,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"500",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Internal Server Error",
"code":500,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> Content-Type: application/pdf"
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/onboarding/signatures/:workflowId/documentsToSign",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"onboarding",
"signatures",
":workflowId",
"documentsToSign"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"documentsToSign\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"documentsToSign",
"value":"[object Object]",
"description":"(Required) An array of form data objects, one for each uploaded document to sign. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: For each document, include an array in the `documentsToSign` object, or the file is ignored. <br><br>**Required** headers: <br> Content-Disposition: form-data; name=documentsToSign <br>Content-Type: application/json"
},
{
"key":"files",
"value":"<string>",
"description":"(Required) An array of form data files, one for each document to sign. <br> **Required** headers: <br> Content-Disposition: form-data; name=files; filename=filename.pdf (must match **1** filename in `documentsToSign`) <br> 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\": \"<string>\",\n \"code\": \"<integer>\"\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\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"MobilePhoneNumber\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"mobilePhoneNumber\": \"<string>\"\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\": \"<integer>\",\n \"detail\": \"<string>\"\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":"<string>",
"description":"(Required) The client’s new selfie. <br>Format: <br>• JPEG image <br>• PNG image"
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/selfie",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"selfie"
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"selfie",
"value":"<string>",
"description":"(Required) The client’s new selfie. <br>Format: <br>• JPEG image <br>• 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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"selfie",
"value":"<string>",
"description":"(Required) The client’s new selfie. <br>Format: <br>• JPEG image <br>• 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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"selfie",
"value":"<string>",
"description":"(Required) The client’s new selfie. <br>Format: <br>• JPEG image <br>• 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\": \"<integer>\",\n \"detail\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"selfie",
"value":"<string>",
"description":"(Required) The client’s new selfie. <br>Format: <br>• JPEG image <br>• 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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"selfie",
"value":"<string>",
"description":"(Required) The client’s new selfie. <br>Format: <br>• JPEG image <br>• 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. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fr`: French <br> • `it`: Italian <br> • `pl`: Polish <br> • `ro`: Romanian"
}
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"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. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fr`: French <br> • `it`: Italian <br> • `pl`: Polish <br> • `ro`: Romanian"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"clientId\": \"<string>\",\n \"verificationId\": \"<string>\",\n \"mobilePhoneNumber\": \"<string>\",\n \"documentsToSign\": [\n {\n \"id\": \"<string>\",\n \"fileName\": \"<string>\",\n \"displayName\": \"<string>\"\n },\n {\n \"id\": \"<string>\",\n \"fileName\": \"<string>\",\n \"displayName\": \"<string>\"\n }\n ],\n \"legalDocuments\": [\n {\n \"displayName\": \"<string>\",\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"displayName\": \"<string>\",\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ],\n \"otpSettings\": [\n {\n \"validation\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"validation\": \"<string>\",\n \"version\": \"<integer>\"\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":"<token>"
}
],
"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. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fr`: French <br> • `it`: Italian <br> • `pl`: Polish <br> • `ro`: Romanian"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"type\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"signatureId\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"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. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fr`: French <br> • `it`: Italian <br> • `pl`: Polish <br> • `ro`: Romanian"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Not Found",
"code":404,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"type\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
}
]
},
{
"name":"Approve documents to sign",
"request":{
"method":"POST",
"header":[
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"authorizedDocuments\": [\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n },\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n }\n ],\n \"legalDocumentsAccepted\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/authorize?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"authorize"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"**API-only integration**: When the [signature status](https://docs.fourthline.com/docs/qes-statuses) changes to `user_consent_required` and **after** making the [Get signature details](https://docs.fourthline.com/reference/get-signature-details) request, use this endpoint to confirm that the client has approved the documents to sign and accepted the QTSP legal conditions. <br><br> <img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: When testing this endpoint, you must use a **real** ID document with an GLOSSARY:MRZ or GLOSSARY:VIZ."
},
"response":[
{
"name":"202",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"authorizedDocuments\": [\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n },\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n }\n ],\n \"legalDocumentsAccepted\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/authorize?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"authorize"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Accepted",
"code":202,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"attemptId\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"authorizedDocuments\": [\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n },\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n }\n ],\n \"legalDocumentsAccepted\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/authorize?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"authorize"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"authorizedDocuments\": [\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n },\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n }\n ],\n \"legalDocumentsAccepted\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/authorize?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"authorize"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Not Found",
"code":404,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"409",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"authorizedDocuments\": [\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n },\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n }\n ],\n \"legalDocumentsAccepted\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/authorize?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"authorize"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Conflict",
"code":409,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"type\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
},
{
"name":"429",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"authorizedDocuments\": [\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n },\n {\n \"documentId\": \"<string>\",\n \"documentHash\": \"<string>\"\n }\n ],\n \"legalDocumentsAccepted\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n },\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"version\": \"<integer>\"\n }\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/authorize?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"authorize"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Too Many Requests",
"code":429,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
}
]
},
{
"name":"Confirm signature",
"request":{
"method":"POST",
"header":[
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"otp\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/confirm",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"confirm"
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"**API-only integration**: When the [signature status](https://docs.fourthline.com/docs/qes-statuses) changes to `confirmation_required`, use this endpoint to validate the one-time passcode and confirm the signature."
},
"response":[
{
"name":"202",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"otp\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/confirm",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"confirm"
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Accepted",
"code":202,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"attemptId\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"otp\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/confirm",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"confirm"
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"409",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"otp\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/confirm",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"confirm"
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Conflict",
"code":409,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"type\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
},
{
"name":"422",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"otp\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/confirm",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"confirm"
],
"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\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
},
{
"name":"429",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"otp\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/confirm",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"confirm"
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Too Many Requests",
"code":429,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
}
]
},
{
"name":"Resend signature passcode",
"request":{
"method":"POST",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/resendOtp?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"resendOtp"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"**API-only integration**: If something went wrong entering the one-time passcode in the signature flow, use this endpoint to resend the passcode to the client."
},
"response":[
{
"name":"202",
"originalRequest":{
"method":"POST",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/resendOtp?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"resendOtp"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Accepted",
"code":202,
"_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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/resendOtp?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"resendOtp"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"POST",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/resendOtp?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"resendOtp"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Not Found",
"code":404,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"422",
"originalRequest":{
"method":"POST",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/resendOtp?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"resendOtp"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Unprocessable Entity (WebDAV) (RFC 4918)",
"code":422,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
},
{
"name":"429",
"originalRequest":{
"method":"POST",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId/resendOtp?lang=it",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId",
"resendOtp"
],
"query":[
{
"key":"lang",
"value":"it",
"description":"The language of the SMS message containing the one-time passcode to confirm the signature. <br>Format: ISO 639-1 alpha-2 <br> Enum: <br> • `cs`: Czech <br> • `de`: German <br> • `en`: English (default) <br> • `es`: Spanish <br> • `fi`: Finnish <br> • `fr`: French <br> • `it`: Italian <br> • `nl`: Dutch <br> • `pl`: Polish <br> • `sk`: Slovak"
}
],
"variable":[
{
"key":"signatureId"
}
]
}
},
"status":"Too Many Requests",
"code":429,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\n}"
}
]
},
{
"name":"Get signature status",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/signatures/:signatureId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"signatures",
":signatureId"
],
"variable":[
{
"key":"signatureId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"statusCode\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\",\n \"errors\": {\n \"signatureId\": [\n \"<string>\",\n \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
},
{
"key":"documentId",
"value":"<string>",
"description":"(Required) Your unique identifier for the signed document that you passed in the [Upload documents to sign](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\",\n \"traceId\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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":"<token>"
}
],
"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\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) Our unique identifier for the signature, returned in the [Create signature](https://docs.fourthline.com/reference/create-a-sign-request). <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"deviceMetaData\": {\n \"language\": \"<string>\",\n \"model\": \"<string>\",\n \"region\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\"\n },\n \"expectation\": {\n \"status\": \"user_consent_required\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n \"mobilePhoneNumber\": \"<string>\"\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":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"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. <br>The signature status must be `confirmation_required`. <br>To automate testing the signature flow, in the [Upload mobile phone number](https://docs.fourthline.com/reference/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":"<token>"
}
],
"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\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\",\n \"signatureStatus\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"503",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
}
],
"auth":{
"type":"oauth2"
},
"variable":[
{
"key":"baseUrl",
"value":"https://api.ext-sandbox.fourthline.com"
}
]
}
Bank Account Verification
{
"info":{
"_postman_id":"cec73473-636a-421b-9621-6f5eaad35472",
"name":"Bank Account Verification",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create workflow",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
},
"description":"Use this endpoint to create a workflow."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"workflowId\": \"<string>\",\n \"clientId\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\n}"
},
{
"name":"401",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Unauthorized",
"code":401,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error\": \"<string>\",\n \"error_description\": \"<string>\"\n}"
},
{
"name":"403",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Forbidden",
"code":403,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
},
{
"name":"500",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"workflowName\": \"<string>\",\n \"providerClientId\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/workflows",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"workflows"
]
}
},
"status":"Internal Server Error",
"code":500,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"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":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"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\": \"<string>\",\n \"expiryDateTime\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"error_description\": \"<string>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\"\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":"<token>"
}
],
"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\": \"<string>\",\n \"status\": \"<integer>\",\n \"detail\": \"<string>\"\n}"
}
]
},
{
"name":"Get reference payment status",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/referencePayments/status/:paymentId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"referencePayments",
"status",
":paymentId"
],
"variable":[
{
"key":"paymentId",
"value":"<string>",
"description":"(Required) The `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/referencePayments/status/:paymentId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"referencePayments",
"status",
":paymentId"
],
"variable":[
{
"key":"paymentId"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<string>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/referencePayments/status/:paymentId",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"referencePayments",
"status",
":paymentId"
],
"variable":[
{
"key":"paymentId"
}
]
}
},
"status":"Not Found",
"code":404,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{}"
}
]
}
],
"auth":{
"type":"oauth2"
},
"variable":[
{
"key":"baseUrl",
"value":"https://api.ext-sandbox.fourthline.com"
}
]
}
AML Screening & Monitoring
{
"info":{
"_postman_id":"7396c775-c3fc-4ec3-be53-e90973748c04",
"name":"AML Screening & Monitoring",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create AML client",
"request":{
"method":"POST",
"header":[
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"providerClientId\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Male\",\n \"placeOfBirth\": \"<string>\",\n \"birthDate\": \"<string>\",\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"street\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumber\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"document\": {\n \"documentNumber\": \"<string>\"\n },\n \"contact\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n }\n },\n \"monitoringType\": \"2\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v2/clients",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"clients"
]
},
"description":"Use this endpoint to create an AML client profile."
},
"response":[
{
"name":"201",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"providerClientId\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Male\",\n \"placeOfBirth\": \"<string>\",\n \"birthDate\": \"<string>\",\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"street\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumber\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"document\": {\n \"documentNumber\": \"<string>\"\n },\n \"contact\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n }\n },\n \"monitoringType\": \"2\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v2/clients",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"clients"
]
}
},
"status":"Created",
"code":201,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"id\": \"<string>\",\n \"providerClientId\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"<string>\",\n \"countryOfBirth\": \"<string>\",\n \"placeOfBirth\": \"<string>\",\n \"birthDate\": \"<string>\"\n },\n \"address\": {\n \"city\": \"<string>\",\n \"country\": \"<string>\"\n },\n \"document\": {\n \"documentNumber\": \"<string>\"\n }\n },\n \"monitoringType\": \"<integer>\",\n \"creationUtcDateTime\": \"<string>\",\n \"updateUtcDateTime\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"providerClientId\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Male\",\n \"placeOfBirth\": \"<string>\",\n \"birthDate\": \"<string>\",\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"street\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumber\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"document\": {\n \"documentNumber\": \"<string>\"\n },\n \"contact\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n }\n },\n \"monitoringType\": \"2\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v2/clients",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"clients"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"errors\": {\n \"ClientData\": [\n \"<string>\",\n \"<string>\"\n ],\n \"ProviderClientId\": [\n \"<string>\",\n \"<string>\"\n ]\n },\n \"type\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\"\n}"
}
]
},
{
"name":"Start screening",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"clientIds\": [\n \"<string>\",\n \"<string>\"\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v2/WatchlistAutomation/StartSingleTimeMonitoring",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"WatchlistAutomation",
"StartSingleTimeMonitoring"
]
},
"description":"Use this endpoint to start a one-off screening for one or more AML clients (**once** per day only)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"clientIds\": [\n \"<string>\",\n \"<string>\"\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v2/WatchlistAutomation/StartSingleTimeMonitoring",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"WatchlistAutomation",
"StartSingleTimeMonitoring"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"clientSingleTimeScreeningStatuses\": [\n {\n \"clientId\": \"<string>\",\n \"singleTimeScreeningStatus\": \"<string>\"\n },\n {\n \"clientId\": \"<string>\",\n \"singleTimeScreeningStatus\": \"<string>\"\n }\n ]\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"clientIds\": [\n \"<string>\",\n \"<string>\"\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v2/WatchlistAutomation/StartSingleTimeMonitoring",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"WatchlistAutomation",
"StartSingleTimeMonitoring"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"errors\": {\n \"ClientIds\": [\n \"<string>\",\n \"<string>\"\n ]\n }\n}"
},
{
"name":"422",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"clientIds\": [\n \"<string>\",\n \"<string>\"\n ]\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v2/WatchlistAutomation/StartSingleTimeMonitoring",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"WatchlistAutomation",
"StartSingleTimeMonitoring"
]
}
},
"status":"Unprocessable Entity (WebDAV) (RFC 4918)",
"code":422,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\"\n}"
}
]
},
{
"name":"Get latest client hit",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v3/WatchlistAutomation/GetClientStatus/:clientId",
"host":[
"{{baseUrl}}"
],
"path":[
"v3",
"WatchlistAutomation",
"GetClientStatus",
":clientId"
],
"variable":[
{
"key":"clientId",
"value":"<string>",
"description":"(Required) Our unique identifier for the client returned in the [Create AML client](https://docs.fourthline.com/reference/create-aml-client) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"Use this endpoint to get the most recent hit for a specific AML 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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v3/WatchlistAutomation/GetClientStatus/:clientId",
"host":[
"{{baseUrl}}"
],
"path":[
"v3",
"WatchlistAutomation",
"GetClientStatus",
":clientId"
],
"variable":[
{
"key":"clientId"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"lastProcessedDate\": \"<string>\",\n \"clientId\": \"<string>\",\n \"latestHit\": {\n \"hitId\": \"<integer>\",\n \"result\": \"<string>\",\n \"hitKind\": \"<string>\",\n \"processStartDate\": \"<string>\",\n \"processEndDate\": \"<string>\",\n \"statusCode\": 0,\n \"verificationId\": \"<string>\"\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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v3/WatchlistAutomation/GetClientStatus/:clientId",
"host":[
"{{baseUrl}}"
],
"path":[
"v3",
"WatchlistAutomation",
"GetClientStatus",
":clientId"
],
"variable":[
{
"key":"clientId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"errors\": {\n \"clientData\": [\n \"<string>\",\n \"<string>\"\n ],\n \"type\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\"\n }\n}"
}
]
},
{
"name":"Get all client hits",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v3/WatchlistAutomation/GetClientHits/:clientId?hitResult=validating&hitKind=sanction&hitsSinceUtc=<date>&hitsUntilUtc=<date>",
"host":[
"{{baseUrl}}"
],
"path":[
"v3",
"WatchlistAutomation",
"GetClientHits",
":clientId"
],
"query":[
{
"key":"hitResult",
"value":"validating",
"description":"Filter hits by status. <br>Enum: <br>• `confirmed_hit` <br>• `false_positive` <br>• `null` <br>• `validating`"
},
{
"key":"hitKind",
"value":"sanction",
"description":"Filter hits by type of hit. <br>Enum: <br>• null <br>• `pep` <br>• `sanction`"
},
{
"key":"hitsSinceUtc",
"value":"<date>",
"description":"Filter hits by date. <br> Set the start date of the time frame you want to view hits for, including on this date. <br>Format: YYYY-MM-DD"
},
{
"key":"hitsUntilUtc",
"value":"<date>",
"description":"Filter hits by date. <br> Set the end date of the time frame you want to view hits for, including on this date. <br>Format: YYYY-MM-DD"
}
],
"variable":[
{
"key":"clientId",
"value":"<string>",
"description":"(Required) Our unique identifier for the client returned in the [Create AML client](https://docs.fourthline.com/reference/create-aml-client) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"Use this endpoint to get a list of all hits for a specific AML 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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v3/WatchlistAutomation/GetClientHits/:clientId?hitResult=validating&hitKind=sanction&hitsSinceUtc=<date>&hitsUntilUtc=<date>",
"host":[
"{{baseUrl}}"
],
"path":[
"v3",
"WatchlistAutomation",
"GetClientHits",
":clientId"
],
"query":[
{
"key":"hitResult",
"value":"validating",
"description":"Filter hits by status. <br>Enum: <br>• `confirmed_hit` <br>• `false_positive` <br>• `null` <br>• `validating`"
},
{
"key":"hitKind",
"value":"sanction",
"description":"Filter hits by type of hit. <br>Enum: <br>• null <br>• `pep` <br>• `sanction`"
},
{
"key":"hitsSinceUtc",
"value":"<date>",
"description":"Filter hits by date. <br> Set the start date of the time frame you want to view hits for, including on this date. <br>Format: YYYY-MM-DD"
},
{
"key":"hitsUntilUtc",
"value":"<date>",
"description":"Filter hits by date. <br> Set the end date of the time frame you want to view hits for, including on this date. <br>Format: YYYY-MM-DD"
}
],
"variable":[
{
"key":"clientId"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"clientId\": \"<string>\",\n \"hits\": [\n {\n \"hitId\": \"<integer>\",\n \"result\": \"<string>\",\n \"hitKind\": \"<string>\",\n \"processStartDate\": \"<string>\",\n \"processEndDate\": \"<string>\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n },\n {\n \"hitId\": \"<integer>\",\n \"result\": \"<string>\",\n \"hitKind\": \"<string>\",\n \"processStartDate\": \"<string>\",\n \"processEndDate\": \"<string>\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n }\n ]\n}"
}
]
},
{
"name":"Get investigation hits",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v3/WatchlistAutomation/GetVerificationHits/:verificationId",
"host":[
"{{baseUrl}}"
],
"path":[
"v3",
"WatchlistAutomation",
"GetVerificationHits",
":verificationId"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) The unique identifier for the investigation, returned in any [Get latest client hit](https://docs.fourthline.com/reference/get-latest-client-hit), [Get all client hits](https://docs.fourthline.com/reference/get-all-client-hits), or [Get investigation hits](https://docs.fourthline.com/reference/get-investigation-hits) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"Use this endpoint to get all hits for a specific AML investigation. <br><br><img src=\"https://files.readme.io/ad2486a-Inline_Note.svg\" align=\"left\"/> **Note**: Multiple investigations can be linked to a single AML 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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v3/WatchlistAutomation/GetVerificationHits/:verificationId",
"host":[
"{{baseUrl}}"
],
"path":[
"v3",
"WatchlistAutomation",
"GetVerificationHits",
":verificationId"
],
"variable":[
{
"key":"verificationId"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"hitId\": \"<integer>\",\n \"result\": \"<string>\",\n \"hitKind\": \"<string>\",\n \"processStartDate\": \"<string>\",\n \"processEndDate\": \"<string>\",\n \"statusCode\": \"<integer>\",\n \"verificationId\": \"<string>\"\n}"
}
]
},
{
"name":"Get Confirmed Hit Report",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/getpdfresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"getpdfresult"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) Our unique identifier for the AML investigation, returned in the [Get latest client hit](https://docs.fourthline.com/reference/get-latest-client-hit) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"Use this endpoint to download the [Confirmed Hit Report](https://docs.fourthline.com/docs/reports#aml-report) for an AML Investigation. <br><br><img src=\"https://files.readme.io/ad2486a-Inline_Note.svg\" align=\"left\"/> **Note**: To make this request, you must first make a [Get latest client hit](https://docs.fourthline.com/reference/get-latest-client-hit) request to get the investigation identifier."
},
"response":[
{
"name":"200",
"originalRequest":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/getpdfresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"getpdfresult"
],
"variable":[
{
"key":"verificationId"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{}"
}
]
},
{
"name":"Get AML client by your ID",
"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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v2/clients/ProviderClientId/:providerClientId?tenant=<string>",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"clients",
"ProviderClientId",
":providerClientId"
],
"query":[
{
"key":"tenant",
"value":"<string>",
"description":"Your unique identifier."
}
],
"variable":[
{
"key":"providerClientId",
"value":"<string>",
"description":"(Required) Your unique identifier for the client that you passed in the [Create AML client](https://docs.fourthline.com/reference/create-aml-client) request."
}
]
},
"description":"Use this endpoint to get an AML client profile using **your** identifier: `providerClientId`."
},
"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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v2/clients/ProviderClientId/:providerClientId?tenant=<string>",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"clients",
"ProviderClientId",
":providerClientId"
],
"query":[
{
"key":"tenant",
"value":"<string>",
"description":"Your unique identifier."
}
],
"variable":[
{
"key":"providerClientId"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"id\": \"<string>\",\n \"providerClientId\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"type\": \"<string>\",\n \"name\": \"<string>\",\n \"initials\": \"<string>\",\n \"firstName\": \"<string>\",\n \"middleName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"<string>\",\n \"countryOfBirth\": \"<string>\",\n \"placeOfBirth\": \"<string>\",\n \"birthDate\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumber\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"region\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\"\n },\n \"contact\": {\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"mobile\": \"<string>\"\n },\n \"document\": {\n \"documentNumber\": \"<string>\"\n },\n \"monitoringType\": \"<integer>\",\n \"creationUtcDateTime\": \"<string>\",\n \"updateUtcDateTime\": \"<string>\"\n }\n}"
}
]
},
{
"name":"Get AML client by our ID",
"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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v2/clients/:id?tenant=<string>",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"clients",
":id"
],
"query":[
{
"key":"tenant",
"value":"<string>",
"description":"Your unique identifier."
}
],
"variable":[
{
"key":"id",
"value":"<string>",
"description":"(Required) Our unique identifier for the client returned in the [Create AML client](https://docs.fourthline.com/reference/create-aml-client) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"Use this endpoint to get an AML client profile using Fourthline's identifier: `id`."
},
"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":"<string>"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v2/clients/:id?tenant=<string>",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"clients",
":id"
],
"query":[
{
"key":"tenant",
"value":"<string>",
"description":"Your unique identifier."
}
],
"variable":[
{
"key":"id"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"id\": \"<string>\",\n \"providerClientId\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"type\": \"<string>\",\n \"name\": \"<string>\",\n \"initials\": \"<string>\",\n \"firstName\": \"<string>\",\n \"middleName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"<string>\",\n \"countryOfBirth\": \"<string>\",\n \"placeOfBirth\": \"<string>\",\n \"birthDate\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumber\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"region\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\"\n },\n \"contact\": {\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"mobile\": \"<string>\"\n },\n \"document\": {\n \"documentNumber\": \"<string>\"\n },\n \"monitoringType\": \"<integer>\",\n \"creationUtcDateTime\": \"<string>\",\n \"updateUtcDateTime\": \"<string>\"\n }\n}"
}
]
},
{
"name":"Update AML client",
"request":{
"method":"PUT",
"header":[
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"clientData\": {\n \"person\": {\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Unknown\",\n \"placeOfBirth\": \"<string>\",\n \"birthDate\": \"<string>\",\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"street\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumber\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"document\": {\n \"documentNumber\": \"<string>\"\n },\n \"contact\": {\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"mobile\": \"<string>\"\n }\n },\n \"monitoringType\": \"<integer>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v2/clients/:id",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"clients",
":id"
],
"variable":[
{
"key":"id",
"value":"<string>",
"description":"(Required) Our unique identifier for the client returned in the [Create AML client](https://docs.fourthline.com/reference/create-aml-client) response.<br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"Use this endpoint to update an AML client profile."
},
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"clientData\": {\n \"person\": {\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Unknown\",\n \"placeOfBirth\": \"<string>\",\n \"birthDate\": \"<string>\",\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"street\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumber\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"document\": {\n \"documentNumber\": \"<string>\"\n },\n \"contact\": {\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"mobile\": \"<string>\"\n }\n },\n \"monitoringType\": \"<integer>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v2/clients/:id",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"clients",
":id"
],
"variable":[
{
"key":"id"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"examples\": {\n \"OK\": {\n \"value\": \"{\\n \\\"id\\\":\\\"a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6\\\",\\n \\\"branch\\\":\\\"{TENANT_BRANCH}\\\",\\n \\\"providerClientId\\\":\\\"your-client-id\\\",\\n \\\"clientData\\\":{\\n \\\"person\\\":{\\n \\\"firstName\\\":\\\"WILLEKE LISELOTTE\\\",\\n \\\"lastName\\\":\\\"DE BRUIJN\\\",\\n \\\"nationality\\\":\\\"NLD\\\",\\n \\\"gender\\\":\\\"Female\\\",\\n \\\"countryOfBirth\\\":\\\"NLD\\\",\\n \\\"placeOfBirth\\\":\\\"Amsterdam\\\",\\n \\\"birthDate\\\":\\\"1965-10-03T00:00:00\\\"\\n },\\n \\\"address\\\":{\\n \\\"city\\\":\\\"Amsterdam\\\",\\n \\\"country\\\":\\\"NLD\\\"\\n },\\n \\\"document\\\":{\\n \\\"documentNumber\\\":\\\"{DOCUMENT_NUMBER}\\\"\\n }\\n },\\n \\\"monitoringType\\\":2,\\n \\\"creationUtcDateTime\\\":\\\"2020-12-28T13:57:22.9931256Z\\\",\\n \\\"updateUtcDateTime\\\":\\\"2020-12-28T13:57:22.9931272Z\\\"\\n} \"\n }\n }\n}"
},
{
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"clientData\": {\n \"person\": {\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Unknown\",\n \"placeOfBirth\": \"<string>\",\n \"birthDate\": \"<string>\",\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"street\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumber\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"document\": {\n \"documentNumber\": \"<string>\"\n },\n \"contact\": {\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"mobile\": \"<string>\"\n }\n },\n \"monitoringType\": \"<integer>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v2/clients/:id",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"clients",
":id"
],
"variable":[
{
"key":"id"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"errors\": {\n \"ClientData\": [\n \"<string>\",\n \"<string>\"\n ],\n \"ProviderClientId\": [\n \"<string>\",\n \"<string>\"\n ]\n },\n \"type\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\",\n \"traceId\": \"<string>\"\n}"
}
]
},
{
"name":"Deactivate AML client",
"request":{
"method":"DELETE",
"header":[
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v2/clients/:id?tenant=<string>",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"clients",
":id"
],
"query":[
{
"key":"tenant",
"value":"<string>",
"description":"Your unique identifier."
}
],
"variable":[
{
"key":"id",
"value":"<string>",
"description":"(Required) Our unique identifier for the client returned in the [Create AML client](https://docs.fourthline.com/reference/create-aml-client) response.<br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"Use this endpoint to deactivate an AML client profile (no data is deleted)."
},
"response":[
{
"name":"204",
"originalRequest":{
"method":"DELETE",
"header":[
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v2/clients/:id?tenant=<string>",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"clients",
":id"
],
"query":[
{
"key":"tenant",
"value":"<string>",
"description":"Your unique identifier."
}
],
"variable":[
{
"key":"id"
}
]
}
},
"status":"No Content",
"code":204,
"_postman_previewlanguage":"text",
"header":[
{
"key":"Content-Type",
"value":"text/plain"
}
],
"cookie":[
],
"body":"{\n \"examples\": {\n \"No content\": {\n \"value\": \"Response headers:\\ndate: Mon18 Oct 2021 07:46:24 GMT \\nserver: Kestrel \"\n }\n }\n}"
},
{
"name":"404",
"originalRequest":{
"method":"DELETE",
"header":[
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v2/clients/:id?tenant=<string>",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"clients",
":id"
],
"query":[
{
"key":"tenant",
"value":"<string>",
"description":"Your unique identifier."
}
],
"variable":[
{
"key":"id"
}
]
}
},
"status":"Not Found",
"code":404,
"_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"
}
]
}
Client Authentication
{
"info":{
"_postman_id":"9585be16-87fa-4b05-8f00-cd166647cdf2",
"name":"Client Authentication",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create Client Authentication",
"request":{
"method":"POST",
"header":[
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"providerProcessId\": \"<string>\",\n \"processType\": \"ClientConfirmation\",\n \"branch\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Other\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"L\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"no\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\n }\n }\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/clients/:clientId/verifications (ClientConfirmation)",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"clients",
":clientId",
"verifications (ClientConfirmation)"
],
"variable":[
{
"key":"clientId",
"value":"<string>",
"description":"(Required) Our unique identifier for the client returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response.<br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"Use this endpoint to create a Client Authentication case with the `clientId` from a previous successful Identity Verification case."
},
"response":[
{
"name":"201",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"providerProcessId\": \"<string>\",\n \"processType\": \"ClientConfirmation\",\n \"branch\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Other\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"L\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"no\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\n }\n }\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/clients/:clientId/verifications (ClientConfirmation)",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"clients",
":clientId",
"verifications (ClientConfirmation)"
],
"variable":[
{
"key":"clientId"
}
]
}
},
"status":"Created",
"code":201,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"verificationId\": \"<string>\",\n \"providerProcessId\": \"<string>\",\n \"status\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"providerProcessId\": \"<string>\",\n \"processType\": \"ClientConfirmation\",\n \"branch\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Other\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"L\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"no\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\n }\n }\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/clients/:clientId/verifications (ClientConfirmation)",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"clients",
":clientId",
"verifications (ClientConfirmation)"
],
"variable":[
{
"key":"clientId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"providerProcessId\": \"<string>\",\n \"processType\": \"ClientConfirmation\",\n \"branch\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Other\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"L\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"no\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\n }\n }\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/clients/:clientId/verifications (ClientConfirmation)",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"clients",
":clientId",
"verifications (ClientConfirmation)"
],
"variable":[
{
"key":"clientId"
}
]
}
},
"status":"Not Found",
"code":404,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{}"
},
{
"name":"422",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"providerProcessId\": \"<string>\",\n \"processType\": \"ClientConfirmation\",\n \"branch\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Other\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"yes\",\n \"professionName\": \"<string>\",\n \"industry\": \"L\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"no\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\n }\n }\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/clients/:clientId/verifications (ClientConfirmation)",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"clients",
":clientId",
"verifications (ClientConfirmation)"
],
"variable":[
{
"key":"clientId"
}
]
}
},
"status":"Unprocessable Entity (WebDAV) (RFC 4918)",
"code":422,
"_postman_previewlanguage":"text",
"header":[
{
"key":"Content-Type",
"value":"text/plain"
}
],
"cookie":[
],
"body":"{}"
}
]
},
{
"name":"Process Client Authentication",
"request":{
"method":"PUT",
"header":[
{
"key":"Content-Type",
"value":"application/x-www-form-urlencoded"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"Selfie",
"value":"<string>",
"description":"(Required) The client’s selfie photo. <br>Format: Binary jpeg image"
},
{
"key":"SelfieVideo",
"value":"<string>",
"description":"(Required) The client’s selfie video.<br>Format: Binary mp4 video file of less than 10 seconds with .mp4 file name extension"
},
{
"key":"DeviceMetaData",
"value":"[object Object]",
"description":"(Required) The client’s device metadata."
}
]
},
"url":{
"raw":"{{baseUrl}}/ccr/v1/verifications/:verificationId/confirmclient",
"host":[
"{{baseUrl}}"
],
"path":[
"ccr",
"v1",
"verifications",
":verificationId",
"confirmclient"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) Our unique identifier for the case, returned in the [Create Client Authentication](https://docs.fourthline.com/reference/create-identity-verification-copy) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
}
]
},
"description":"Use this endpoint to trigger processing of a Client Authentication case."
},
"response":[
{
"name":"200",
"originalRequest":{
"method":"PUT",
"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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"Selfie",
"value":"<string>",
"description":"(Required) The client’s selfie photo. <br>Format: Binary jpeg image"
},
{
"key":"SelfieVideo",
"value":"<string>",
"description":"(Required) The client’s selfie video.<br>Format: Binary mp4 video file of less than 10 seconds with .mp4 file name extension"
},
{
"key":"DeviceMetaData",
"value":"[object Object]",
"description":"(Required) The client’s device metadata."
}
]
},
"url":{
"raw":"{{baseUrl}}/ccr/v1/verifications/:verificationId/confirmclient",
"host":[
"{{baseUrl}}"
],
"path":[
"ccr",
"v1",
"verifications",
":verificationId",
"confirmclient"
],
"variable":[
{
"key":"verificationId"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"status\": \"<string>\",\n \"providerProcessId\": \"<string>\",\n \"created\": \"<string>\"\n}"
},
{
"name":"400",
"originalRequest":{
"method":"PUT",
"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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"Selfie",
"value":"<string>",
"description":"(Required) The client’s selfie photo. <br>Format: Binary jpeg image"
},
{
"key":"SelfieVideo",
"value":"<string>",
"description":"(Required) The client’s selfie video.<br>Format: Binary mp4 video file of less than 10 seconds with .mp4 file name extension"
},
{
"key":"DeviceMetaData",
"value":"[object Object]",
"description":"(Required) The client’s device metadata."
}
]
},
"url":{
"raw":"{{baseUrl}}/ccr/v1/verifications/:verificationId/confirmclient",
"host":[
"{{baseUrl}}"
],
"path":[
"ccr",
"v1",
"verifications",
":verificationId",
"confirmclient"
],
"variable":[
{
"key":"verificationId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"errors\": {\n \"selfie\": [\n \"<string>\",\n \"<string>\"\n ],\n \"selfieVideo\": [\n \"<string>\",\n \"<string>\"\n ]\n },\n \"type\": \"<string>\",\n \"title\": \"<string>\",\n \"status\": \"<integer>\"\n}"
},
{
"name":"404",
"originalRequest":{
"method":"PUT",
"header":[
{
"key":"Content-Type",
"value":"application/x-www-form-urlencoded"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"Selfie",
"value":"<string>",
"description":"(Required) The client’s selfie photo. <br>Format: Binary jpeg image"
},
{
"key":"SelfieVideo",
"value":"<string>",
"description":"(Required) The client’s selfie video.<br>Format: Binary mp4 video file of less than 10 seconds with .mp4 file name extension"
},
{
"key":"DeviceMetaData",
"value":"[object Object]",
"description":"(Required) The client’s device metadata."
}
]
},
"url":{
"raw":"{{baseUrl}}/ccr/v1/verifications/:verificationId/confirmclient",
"host":[
"{{baseUrl}}"
],
"path":[
"ccr",
"v1",
"verifications",
":verificationId",
"confirmclient"
],
"variable":[
{
"key":"verificationId"
}
]
}
},
"status":"Not Found",
"code":404,
"_postman_previewlanguage":"text",
"header":[
{
"key":"Content-Type",
"value":"text/plain"
}
],
"cookie":[
],
"body":"{}"
},
{
"name":"422",
"originalRequest":{
"method":"PUT",
"header":[
{
"key":"Content-Type",
"value":"application/x-www-form-urlencoded"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"Selfie",
"value":"<string>",
"description":"(Required) The client’s selfie photo. <br>Format: Binary jpeg image"
},
{
"key":"SelfieVideo",
"value":"<string>",
"description":"(Required) The client’s selfie video.<br>Format: Binary mp4 video file of less than 10 seconds with .mp4 file name extension"
},
{
"key":"DeviceMetaData",
"value":"[object Object]",
"description":"(Required) The client’s device metadata."
}
]
},
"url":{
"raw":"{{baseUrl}}/ccr/v1/verifications/:verificationId/confirmclient",
"host":[
"{{baseUrl}}"
],
"path":[
"ccr",
"v1",
"verifications",
":verificationId",
"confirmclient"
],
"variable":[
{
"key":"verificationId"
}
]
}
},
"status":"Unprocessable Entity (WebDAV) (RFC 4918)",
"code":422,
"_postman_previewlanguage":"text",
"header":[
{
"key":"Content-Type",
"value":"text/plain"
}
],
"cookie":[
],
"body":"{\n \"examples\": {\n \"Invalid processType\": {\n \"value\": \"The process type of the verification is not allowed for this action.\"\n },\n \"Invalid data in form\": {\n \"value\": \"Selfie : The document NLD.selfie.front.0.jpg is not a valid image\\nSelfieVideo : Video document NLD.selfie.jpg is not an MP4 file.\\nCcrJson : The document CcrJson.json has the following errors: NoTypeValidates: #/DeviceMetaData.Language\\n{Null:\\n PatternMismatch: #/DeviceMetaData.Language\\n StringTooLong: #/DeviceMetaData.Language\\n NullExpected: #/DeviceMetaData.Language\\n}\\n{String:\\n PatternMismatch: #/DeviceMetaData.Language\\n StringTooLong: #/DeviceMetaData.Language\\n}\"\n }\n }\n}"
}
]
},
{
"name":"Get Client Authentication status",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/clientconfirmationresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"clientconfirmationresult"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) Our unique identifier for the case, returned in the [Create Client Authentication](https://docs.fourthline.com/reference/create-identity-verification-copy) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
}
]
},
"description":"Use this endpoint to get the [status](https://docs.fourthline.com/docs/clientauth-statuses) of a Client Authentication case. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/clientconfirmationresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"clientconfirmationresult"
],
"variable":[
{
"key":"verificationId"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"data\": {\n \"analyst\": \"<string>\"\n },\n \"verificationId\": \"<string>\",\n \"processType\": \"<string>\",\n \"verificationStatus\": \"<string>\",\n \"riskInfo\": {\n \"statusCode\": \"<integer>\",\n \"description\": \"<string>\"\n }\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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":workflowId",
"getpdfresult"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"{}"
}
]
}
],
"auth":{
"type":"oauth2"
},
"variable":[
{
"key":"baseUrl",
"value":"https://api.ext-sandbox.fourthline.com"
}
]
}
Document Authentication
{
"info":{
"_postman_id":"145139dd-4c92-4165-9015-d4965ffec68e",
"name":"Document Authentication",
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\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. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Make sure you address the correct [environment](https://docs.fourthline.com/reference/introduction#environments)."
},
"response":[
{
"name":"200",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"token_type\": \"<string>\",\n \"access_token\": \"<string>\",\n \"expires_in\": \"<integer>\"\n}"
},
{
"name":"400",
"originalRequest":{
"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":"<string>"
},
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/oauth2/token",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"oauth2",
"token"
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"error_description\": \"<string>\",\n \"error\": \"<string>\"\n}"
}
]
},
{
"name":"Create Document Authentication",
"request":{
"method":"POST",
"header":[
{
"key":"Content-Type",
"value":"application/json"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"providerProcessId\": \"<string>\",\n \"processType\": \"ClientDocumentRenewal\",\n \"branch\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"self-employed\",\n \"professionName\": \"<string>\",\n \"industry\": \"Q\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\n }\n }\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/clients/:clientId/verifications (DocumentAuthentication)",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"clients",
":clientId",
"verifications (DocumentAuthentication)"
],
"variable":[
{
"key":"clientId",
"value":"<string>",
"description":"(Required) Our unique identifier for the client returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`"
}
]
},
"description":"Use this endpoint to create a Document Authentication case with the `clientId` from a previous successful Identity Verification case."
},
"response":[
{
"name":"201",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"providerProcessId\": \"<string>\",\n \"processType\": \"ClientDocumentRenewal\",\n \"branch\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"self-employed\",\n \"professionName\": \"<string>\",\n \"industry\": \"Q\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\n }\n }\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/clients/:clientId/verifications (DocumentAuthentication)",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"clients",
":clientId",
"verifications (DocumentAuthentication)"
],
"variable":[
{
"key":"clientId"
}
]
}
},
"status":"Created",
"code":201,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"verificationId\": \"<string>\",\n \"providerProcessId\": \"<string>\",\n \"status\": \"<string>\"\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"providerProcessId\": \"<string>\",\n \"processType\": \"ClientDocumentRenewal\",\n \"branch\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"self-employed\",\n \"professionName\": \"<string>\",\n \"industry\": \"Q\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\n }\n }\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/clients/:clientId/verifications (DocumentAuthentication)",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"clients",
":clientId",
"verifications (DocumentAuthentication)"
],
"variable":[
{
"key":"clientId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"providerProcessId\": \"<string>\",\n \"processType\": \"ClientDocumentRenewal\",\n \"branch\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"self-employed\",\n \"professionName\": \"<string>\",\n \"industry\": \"Q\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\n }\n }\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/clients/:clientId/verifications (DocumentAuthentication)",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"clients",
":clientId",
"verifications (DocumentAuthentication)"
],
"variable":[
{
"key":"clientId"
}
]
}
},
"status":"Not Found",
"code":404,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{}"
},
{
"name":"422",
"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":"<token>"
}
],
"body":{
"mode":"raw",
"raw":"{\n \"providerProcessId\": \"<string>\",\n \"processType\": \"ClientDocumentRenewal\",\n \"branch\": \"<string>\",\n \"clientData\": {\n \"person\": {\n \"type\": \"Natural Person\",\n \"name\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"nationality\": \"<string>\",\n \"gender\": \"Female\",\n \"birthDate\": \"<date>\",\n \"placeOfBirth\": \"<string>\",\n \"initials\": \"<string>\",\n \"middleName\": \"<string>\",\n \"countryOfBirth\": \"<string>\"\n },\n \"address\": {\n \"street\": \"<string>\",\n \"streetNumber\": \"<integer>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"streetNumberPrefix\": \"<string>\",\n \"streetNumberSuffix\": \"<string>\",\n \"secondAddressLine\": \"<string>\",\n \"region\": \"<string>\"\n },\n \"emailAndPhone\": {\n \"email\": \"<string>\",\n \"mobile\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"tax\": {\n \"countrySubjectToTaxation\": \"<string>\",\n \"tin\": \"<string>\",\n \"usPerson\": \"<string>\",\n \"usTin\": \"<string>\"\n },\n \"profession\": {\n \"employment\": \"self-employed\",\n \"professionName\": \"<string>\",\n \"industry\": \"Q\"\n },\n \"riskRequirements\": {\n \"entity\": \"ITA\",\n \"pepSelfDeclared\": \"yes\",\n \"placeOfWork\": \"<string>\",\n \"product\": \"<string>\",\n \"sector\": \"<string>\",\n \"sourceOfIncome\": \"<string>\"\n },\n \"deviceMetaData\": {\n \"browserType\": \"<string>\",\n \"browserVersion\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"language\": \"<string>\",\n \"latitude\": \"<string>\",\n \"longitude\": \"<string>\",\n \"model\": \"<string>\",\n \"osCompromised\": \"<string>\",\n \"osVersion\": \"<string>\",\n \"region\": \"<string>\",\n \"sdkVersion\": \"<string>\",\n \"analyticsId\": \"<string>\"\n },\n \"previousDocumentData\": {\n \"BirthDate\": \"<date>\",\n \"FirstName\": \"<string>\",\n \"LastName\": \"<string>\",\n \"Nationality\": \"<string>\",\n \"PlaceOfBirth\": \"<string>\"\n }\n }\n}",
"options":{
"raw":{
"headerFamily":"json",
"language":"json"
}
}
},
"url":{
"raw":"{{baseUrl}}/v1/clients/:clientId/verifications (DocumentAuthentication)",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"clients",
":clientId",
"verifications (DocumentAuthentication)"
],
"variable":[
{
"key":"clientId"
}
]
}
},
"status":"Unprocessable Entity (WebDAV) (RFC 4918)",
"code":422,
"_postman_previewlanguage":"text",
"header":[
{
"key":"Content-Type",
"value":"text/plain"
}
],
"cookie":[
],
"body":"{}"
}
]
},
{
"name":"Upload new ID document",
"request":{
"method":"POST",
"header":[
{
"key":"Content-Type",
"value":"application/x-www-form-urlencoded"
},
{
"key":"Accept",
"value":"application/json"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"DocumentType",
"value":"ResidencePermit",
"description":"(Required) The new ID document data."
},
{
"key":"DocumentNumber",
"value":"<string>",
"description":"(Required) The new ID document data."
},
{
"key":"IsPrimaryDocument",
"value":"false",
"description":"(Required) The new ID document data."
},
{
"key":"IssueDate",
"value":"<date>",
"description":"(Required) The new ID document data."
},
{
"key":"ExpirationDate",
"value":"<date>",
"description":"(Required) The new ID document data."
},
{
"key":"OriginTypeOs",
"value":"<string>",
"description":"(Required) The new ID document data."
},
{
"key":"KycFiles",
"value":"[object Object],[object Object]",
"description":"(Required) The new ID document data."
},
{
"key":"NfcDataGroups",
"value":"[object Object]",
"description":"(Required) The new ID document data."
},
{
"key":"Files",
"value":"<string>",
"description":"(Required) The file to upload. <br> You can upload multiple files in one request."
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/document",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"document"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) Our unique identifier for the case, returned in the [Create Document Authentication](https://docs.fourthline.com/reference/create-document-authentication) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
}
]
},
"description":"Use this endpoint to upload the client’s new ID document for a Document Authentication case. <br><br>**Guidance**: <br><br>• Always specify the document type in the request, include at least 1 file and provide information about the file or it is ignored. <br>• Make separate request for each document type: selfie file, ID document file, EmbeddedFace file (portrait on the NFC chip). <br>• Requests can contain more than 1 file per document type. <br>• You can only upload an EmbeddedFace file **after** you have uploaded the GLOSSARY:ID DOCUMENT. The `documentNumber` in the EmbeddedFace file request must match the document. <br><br> **Updating document data** <br><br>• After uploading a document, you can send new requests to update the document and its information. <br>• To add new files to a previously uploaded document, you must specify the **same** `documentType` and `documentNumber`, if relevant. Otherwise, it is considered a new document. <br>• To update the file content or data, you must specify the same `fileName` (case sensitive). Otherwise, it is added as a new file. <br>• Provide 1 unique filename per client. <br>• PDF documents **aren’t** updated."
},
"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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"DocumentType",
"value":"ResidencePermit",
"description":"(Required) The new ID document data."
},
{
"key":"DocumentNumber",
"value":"<string>",
"description":"(Required) The new ID document data."
},
{
"key":"IsPrimaryDocument",
"value":"false",
"description":"(Required) The new ID document data."
},
{
"key":"IssueDate",
"value":"<date>",
"description":"(Required) The new ID document data."
},
{
"key":"ExpirationDate",
"value":"<date>",
"description":"(Required) The new ID document data."
},
{
"key":"OriginTypeOs",
"value":"<string>",
"description":"(Required) The new ID document data."
},
{
"key":"KycFiles",
"value":"[object Object],[object Object]",
"description":"(Required) The new ID document data."
},
{
"key":"NfcDataGroups",
"value":"[object Object]",
"description":"(Required) The new ID document data."
},
{
"key":"Files",
"value":"<string>",
"description":"(Required) The file to upload. <br> You can upload multiple files in one request."
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/document",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"document"
],
"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":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"DocumentType",
"value":"ResidencePermit",
"description":"(Required) The new ID document data."
},
{
"key":"DocumentNumber",
"value":"<string>",
"description":"(Required) The new ID document data."
},
{
"key":"IsPrimaryDocument",
"value":"false",
"description":"(Required) The new ID document data."
},
{
"key":"IssueDate",
"value":"<date>",
"description":"(Required) The new ID document data."
},
{
"key":"ExpirationDate",
"value":"<date>",
"description":"(Required) The new ID document data."
},
{
"key":"OriginTypeOs",
"value":"<string>",
"description":"(Required) The new ID document data."
},
{
"key":"KycFiles",
"value":"[object Object],[object Object]",
"description":"(Required) The new ID document data."
},
{
"key":"NfcDataGroups",
"value":"[object Object]",
"description":"(Required) The new ID document data."
},
{
"key":"Files",
"value":"<string>",
"description":"(Required) The file to upload. <br> You can upload multiple files in one request."
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/document",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"document"
],
"variable":[
{
"key":"verificationId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n }\n ]\n}"
},
{
"name":"422",
"originalRequest":{
"method":"POST",
"header":[
{
"key":"Content-Type",
"value":"application/x-www-form-urlencoded"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"body":{
"mode":"urlencoded",
"urlencoded":[
{
"key":"DocumentType",
"value":"ResidencePermit",
"description":"(Required) The new ID document data."
},
{
"key":"DocumentNumber",
"value":"<string>",
"description":"(Required) The new ID document data."
},
{
"key":"IsPrimaryDocument",
"value":"false",
"description":"(Required) The new ID document data."
},
{
"key":"IssueDate",
"value":"<date>",
"description":"(Required) The new ID document data."
},
{
"key":"ExpirationDate",
"value":"<date>",
"description":"(Required) The new ID document data."
},
{
"key":"OriginTypeOs",
"value":"<string>",
"description":"(Required) The new ID document data."
},
{
"key":"KycFiles",
"value":"[object Object],[object Object]",
"description":"(Required) The new ID document data."
},
{
"key":"NfcDataGroups",
"value":"[object Object]",
"description":"(Required) The new ID document data."
},
{
"key":"Files",
"value":"<string>",
"description":"(Required) The file to upload. <br> You can upload multiple files in one request."
}
]
},
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/document",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"document"
],
"variable":[
{
"key":"verificationId"
}
]
}
},
"status":"Unprocessable Entity (WebDAV) (RFC 4918)",
"code":422,
"_postman_previewlanguage":"text",
"header":[
{
"key":"Content-Type",
"value":"text/plain"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\"\n}"
}
]
},
{
"name":"Process Document Authentication",
"request":{
"method":"POST",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/start",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"start"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) Our unique identifier for the case, returned in the [Create Document Authentication](https://docs.fourthline.com/reference/create-document-authentication) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
}
]
},
"description":"Use this endpoint to trigger processing of a Document Authentication case."
},
"response":[
{
"name":"200",
"originalRequest":{
"method":"POST",
"header":[
{
"key":"Accept",
"value":"application/json"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/start",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"start"
],
"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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/start",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"start"
],
"variable":[
{
"key":"verificationId"
}
]
}
},
"status":"Bad Request",
"code":400,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"message\": \"<string>\",\n \"code\": \"<integer>\",\n \"errors\": [\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\n },\n {\n \"code\": \"<integer>\",\n \"property\": \"<string>\",\n \"message\": \"<string>\"\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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/start",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"start"
],
"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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:verificationId/start",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":verificationId",
"start"
],
"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\": \"<string>\",\n \"code\": \"<integer>\"\n}"
}
]
},
{
"name":"Get Document Authentication status",
"request":{
"method":"GET",
"header":[
{
"key":"Accept",
"value":"application/json"
}
],
"url":{
"raw":"{{baseUrl}}/v2/data/:verificationId/result",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"data",
":verificationId",
"result"
],
"variable":[
{
"key":"verificationId",
"value":"<string>",
"description":"(Required) Our unique identifier for the case, returned in the [Create Document Authentication](https://docs.fourthline.com/reference/create-document-authentication) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **Tip**: Use this as the case reference number for any questions."
}
]
},
"description":"Use this endpoint to get the [status](https://docs.fourthline.com/docs/docauth-statuses) of a Document Authentication case. <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<token>"
}
],
"url":{
"raw":"{{baseUrl}}/v2/data/:verificationId/result",
"host":[
"{{baseUrl}}"
],
"path":[
"v2",
"data",
":verificationId",
"result"
],
"variable":[
{
"key":"verificationId"
}
]
}
},
"status":"OK",
"code":200,
"_postman_previewlanguage":"json",
"header":[
{
"key":"Content-Type",
"value":"application/json"
}
],
"cookie":[
],
"body":"{\n \"hash\": \"<string>\",\n \"dataValidationError\": {},\n \"verificationId\": \"<string>\",\n \"verificationStatus\": \"<string>\"\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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
}
],
"url":{
"raw":"{{baseUrl}}/v1/verifications/:workflowId/getpdfresult",
"host":[
"{{baseUrl}}"
],
"path":[
"v1",
"verifications",
":workflowId",
"getpdfresult"
],
"variable":[
{
"key":"workflowId",
"value":"<string>",
"description":"(Required) Our unique identifier for the workflow, returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response. <br>Format: GUID 128-bit text string <br>Example: `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` <br><br><img src=\"https://files.readme.io/8eb9022-Inline_Tip.svg\" align=\"left\"/> **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":"<string>"
},
{
"key":"Accept",
"value":"text/plain"
},
{
"description":"Added as a part of security scheme: oauth2",
"key":"Authorization",
"value":"<token>"
}
],
"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":"{}"
}
]
}
],
"auth":{
"type":"oauth2"
},
"variable":[
{
"key":"baseUrl",
"value":"https://api.ext-sandbox.fourthline.com"
}
]
}
Updated 7 months ago