✒️Automatic signing

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

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

application/json

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

/services/document-folders/{documentFolderId}/sign/session

HTTPcURLJavaScriptPython

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
}

Signing documents

Sign documents

post

Sign documents in batch using selected signature type.

Path parameters

batchIdstring · uuidRequired

Batch id

Body

application/json

signatureTypestring · enumRequired

Documents signature type

Example: EASYPossible values:

Responses

200

OK

*/*

Responseobject

post

/services/sign/{batchId}

HTTPcURLJavaScriptPython

POST /services/sign/{batchId} HTTP/1.1
Host: professional.signius.eu:8970
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "signatureType": "EASY"
}

200

OK

{}