📄Document handling

Submit a document for signing

Submit a document for signing

put

Start document signing by defining all attributes. After the request is processed, the document becomes availble in the portal. If the automatic email sending is enabled, users are being notified about a document delegated to sign.

Path parameters

documentIdstring · uuidRequired

The id of the document.

Body

signeesUsersobject[]Required

A list of document signees

titlestringOptional

Document name

Example: title

signeeSignatureTypestring · enumRequired

Type of signature. Only signatures of the same type ("EASY", or "ADVANCED", or "QUALIFIED") can be stored in one folder. Adding another document of different signature type to the same folder will result in an error.

Example: EASYAvailable options:

graphicalRepresentationTypestring · enumOptional

Type of graphical representation. Defaults to LAST_PAGE. CUSTOM to set custom location.

Example: LAST_PAGEAvailable options:

skipAccountCreationbooleanOptional

Skipping account creation for EASY signature. Defaults to false

Example: false

Responses

*/*

objectOptional

application/json

put

HTTPcURLJavaScriptPython

PUT /services/documents/{documentId} HTTP/1.1
Host: professional.signius.eu:8970
Content-Type: application/json
Accept: */*
Content-Length: 281

{
  "signeesUsers": [
    {
      "signeeEmail": "[e-mail]",
      "signeePhone": "+48XXXXXXXXX",
      "signingOrder": 1,
      "name": "Imię",
      "surname": "Nazwisko",
      "skipAccountCreation": false
    }
  ],
  "title": "title",
  "signeeSignatureType": "EASY",
  "graphicalRepresentationType": "LAST_PAGE",
  "skipAccountCreation": false
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "status": "UPLOADED",
  "title": "text",
  "createDate": "2025-04-19T17:12:29.389Z",
  "signees": [
    {
      "status": "AWAITING",
      "signingOrder": 1,
      "rejectMessage": "text",
      "user": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "email": "text",
        "terms": true
      },
      "signedDate": "2025-04-19T17:12:29.389Z"
    }
  ]
}

Submit a document for signing with specifing location of graphical representation of signarure

If you want to specify locatation of graphical representation of signature you have to set graphicalRepresentationType to CUSTOM. And specify values of top, left, page. You can see example on image below.

Example request body.

{
  "signeesUsers": [
    {
      "signeeEmail": "[e-mail]",
      "signeePhone": "+48XXXXXXXXX",
      "signingOrder": 1,
      "name": "Imię",
      "surname": "Nazwisko",
      "skipAccountCreation": false,
      "signature": {
        "top": 100,  
        "left": 100, 
        "page": 2 
      }
    }
  ],
  "title": "title",
  "signeeSignatureType": "EASY",
  "graphicalRepresentationType": "CUSTOM",
  "skipAccountCreation": false
}

A single „rectangle” with a signature measures Width: 160px Height: 36px

Maximum position of A4 signature placement vertically: Max top = 807px Max left = 435px

Maximum position of A4 signature placement horizontal: Max top = 560px Max left = 682px

WARNING!! On one vertical A4 sheet you can fit 3 signatures (on one level). To center them perfectly, set the coordinates according to image below.

Callbacks

Document signing status change notification

POST http://yourserver.com/

Successfully implementing signing process with Signius requires client to take care of document status change notifications. The url for callback notification has to be configured beforehand on the client’s account. Depending on the configuration the callback notification can be sent either after placing last signature on a document (a good time to download fully signed file), or after every signature placed on the document (when you may want to notify next signee about awaiting signature

Request Body

Name	Type	Description
documentId	string <uuid>
presentSignee	string <uuid>
nextSignee	string or null <uuid>
documentStatus	string	The value should be "SIGNED" or "SIGNING_IN_PROGESS"

200: OK Return this code if the callback was received and processed successfully.

500: Internal Server Error default The callback will be repeated 5 times - each retry after an hour.

Get a document link

Get a document link

get

Retrieves an individual link to the document for defined signee. For the signing flow without registration - the link is valid for 30 days since retrieval

Path parameters

documentIdstring · uuidRequired

Id of the document

userIdstring · uuidRequired

Id of the signee for whom the link is retrieved.

Responses

*/*

objectOptional

get

HTTPcURLJavaScriptPython

GET /services/documents/{documentId}/link HTTP/1.1
Host: professional.signius.eu:8970
Accept: */*

200

OK

{
  "documentLink": "text"
}

Download original document

Download original document

get

Enables downloading originally uploaded document (unless previously removed)

Path parameters

documentIdstring · uuidRequired

The id of the document.

Responses

application/octet-stream

string · byte[]Optional

get

HTTPcURLJavaScriptPython

GET /services/documents/{documentId}/file HTTP/1.1
Host: professional.signius.eu:8970
Accept: */*

200

OK

[
  "Ynl0ZXM="
]

Download signed document

Download signed document

get

Enables downloading signed document (unless previously removed). In case document was not yet signed the 404 code is returned

Path parameters

documentIdstring · uuidRequired

The id of the document.

Responses

application/octet-stream

string · byte[]Optional

get

HTTPcURLJavaScriptPython

GET /services/documents/{documentId}/signed HTTP/1.1
Host: professional.signius.eu:8970
Accept: */*

200

OK

[
  "Ynl0ZXM="
]

List all documents in the folder

List all documents in the folder

get

Enables to check the signing status (signed or unsigned) of all documents uploaded in one folder.

Path parameters

documentFolderIdstring · uuidRequired

The id of the folder.

Responses

*/*

object[]Optional

get

HTTPcURLJavaScriptPython

GET /services/documents/document-folders/{documentFolderId} HTTP/1.1
Host: professional.signius.eu:8970
Accept: */*

200

OK

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "status": "UPLOADED",
    "title": "text",
    "createDate": "2025-04-19T17:12:29.389Z",
    "signees": [
      {
        "status": "AWAITING",
        "signingOrder": 1,
        "rejectMessage": "text",
        "user": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "email": "text",
          "terms": true
        },
        "signedDate": "2025-04-19T17:12:29.389Z"
      }
    ]
  }
]

Delete a document

Delete a document

delete

Removes document the system. By default SIGNIUS removes all data older than 30 days. Only audit logs are retained.

Path parameters

documentIdstring · uuidRequired

The id of the document.

Responses

*/*

objectOptional

delete

HTTPcURLJavaScriptPython

DELETE /services/documents/{documentId}/ HTTP/1.1
Host: professional.signius.eu:8970
Accept: */*

200

OK

{}