openapi: 3.0.0
info:
contact:
name: Onfido
url: https://public.support.onfido.com
description: "\nCreate trust at onboarding and beyond with a complete, AI-powered digital\nidentity solution built to help you know your customers online. \nAutomation allows you to acquire new customers and reduce costs while\nmeeting global KYC and AML compliance."
license:
name: MIT
title: Onfido Signatures API
version: v3.6
servers:
- url: https://api.{region}.onfido.com/v3.6
variables:
region:
default: eu
enum:
- eu
- us
- ca
security:
- Token: []
tags:
- name: Signatures
paths:
/qualified_electronic_signature/documents:
get:
description: 'Retrieves the signed document or application form depending on the file_id provided.
'
operationId: download_qes_document
parameters:
- description: The unique identifier of the Workflow Run for which you want to retrieve the signed document.
in: query
name: workflow_run_id
required: true
schema:
format: uuid
type: string
- description: The unique identifier of the file which you want to retrieve.
in: query
name: file_id
required: true
schema:
format: uuid
type: string
responses:
'200':
content:
application/pdf:
schema:
format: binary
type: string
description: The signed document PDF binary data.
'302':
description: Found
headers:
Location:
description: Pre-signed URL to download the file.
schema:
format: uri
type: string
default:
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Unexpected error
summary: Retrieves the signed document or application form
tags:
- Signatures
components:
schemas:
ErrorProperties:
example:
type: type
message: message
fields:
key: ''
properties:
type:
type: string
message:
type: string
fields:
additionalProperties: true
type: object
title: ErrorProperties
type: object
Error:
example:
error:
type: type
message: message
fields:
key: ''
properties:
error:
$ref: '#/components/schemas/ErrorProperties'
title: Error
type: object
securitySchemes:
Token:
in: header
name: Authorization
type: apiKey
externalDocs:
url: https://documentation.onfido.com