API Documentation
docs.signius.eu
PROFESSIONAL
PROFESSIONAL
  • ๐Ÿ‘จโ€๐ŸซIntroduction
  • ๐Ÿ”‘Key concepts
  • ๐Ÿ”Getting Started
  • ๐Ÿ›‚Authentication
  • ๐ŸขIntegration Scenarios
  • ๐Ÿ“‚Folders
  • ๐Ÿ“„Document handling
  • โœ’๏ธAutomatic signing
  • ๐Ÿ’ฐConfiguration options
  • โ—Error Codes
Powered by GitBook
On this page

Automatic signing

PreviousDocument handlingNextConfiguration options

Last updated 1 year ago

Automatic signature is possible only and exclusively as an EASY signature type (i.e. "Advanced" signature). It is also possible to sign with the same e-mail address (from which the document is ordered for signature), or from a different e-mail address that is assigned to the same Business Customer. Each of these e-mail addresses must be assigned access to the API (on the SIGNIUS side).

When ordering a document for signature (in the PUT method), you need to remember that the value of the "skipAccountCreation" parameter (for e-mail signing Automatically) must be set to "false".

Create a signing session

Signing documents

โœ’๏ธ
  • Create a signing session
  • POSTCreate signing session
  • Signing documents
  • POSTSign documents

Create signing session

post

Creates new signing session for selected documents. As a result documents are split into required number of signing batches, each of up to 20 files. Each of these batches has to be signed separatedly

Path parameters
documentFolderIdstring ยท uuidRequired

The id of the document folder in which are placed documents being signed.

Body
documentIdsstring ยท uuid[]Required

Identifiers of documents which will be signed during session.

signatureTypestring ยท enumRequired

Type of signature which will be placed during session.

Example: EASYPossible values:
acceptTermsbooleanRequired

Approval of Signius Terms and Conditions, have to be set to true to be able to create signing session.

Example: true
Responses
200
OK
*/*
post
POST /services/document-folders/{documentFolderId}/sign/session HTTP/1.1
Host: professional.signius.eu:8970
Content-Type: application/json
Accept: */*
Content-Length: 98

{
  "documentIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "signatureType": "EASY",
  "acceptTerms": true
}
200

OK

{
  "batchIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "signeeSignatureType": "ADVANCED",
  "verificationRequired": true
}

Sign documents

post

Sign documents in batch using selected signature type.

Path parameters
batchIdstring ยท uuidRequired

Batch id

Body
signatureTypestring ยท enumRequired

Documents signature type

Example: EASYPossible values:
Responses
200
OK
*/*
Responseobject
post
POST /services/sign/{batchId} HTTP/1.1
Host: professional.signius.eu:8970
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "signatureType": "EASY"
}
200

OK

{}