✒️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

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

POSThttps://professional.signius.eu:8970/services/document-folders/{documentFolderId}/sign/session

Path parameters

documentFolderId*string (uuid)

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

Body

application/json

documentIds*array of string (uuid)

Identifiers of documents which will be signed during session.

signatureType*enum

Type of signature which will be placed during session.

Example: "EASY"

ADVANCEDQUALIFIEDEASY

acceptTerms*boolean

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

Example: true

Response

200

OK

Body

*/*

batchIdsarray of string (uuid)

signeeSignatureTypeenum

ADVANCEDQUALIFIEDEASY

verificationRequiredboolean

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://professional.signius.eu:8970/services/document-folders/{documentFolderId}/sign/session', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "documentIds": [
        null
      ],
      "signatureType": "EASY",
      "acceptTerms": true
    }),
});
const data = await response.json();

Response

200

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

Signing documents

Sign documents

Sign documents in batch using selected signature type.

POSThttps://professional.signius.eu:8970/services/sign/{batchId}

Path parameters

batchId*string (uuid)

Batch id

Body

application/json

Signature type (for now only EASY is available)

signatureType*enum

Documents signature type

Example: "EASY"

ADVANCEDQUALIFIEDEASY

Response

200

OK

Body

*/*

object

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://professional.signius.eu:8970/services/sign/{batchId}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "signatureType": "EASY"
    }),
});
const data = await response.json();

Response

200

{}