📄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
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: EASYPossible values:
graphicalRepresentationTypestring · enumOptional

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

Example: LAST_PAGEPossible values:
skipAccountCreationbooleanOptional

Skipping account creation for EASY signature. Defaults to false

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

{
  "signeesUsers": [
    {
      "signeeEmail": "[email protected]",
      "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-06-29T11:35:27.158Z",
  "signees": [
    {
      "status": "AWAITING",
      "signingOrder": 1,
      "rejectMessage": "text",
      "user": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "email": "text",
        "terms": true
      },
      "signedDate": "2025-06-29T11:35:27.158Z"
    }
  ]
}

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": "[email protected]",
      "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"

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
200
OK
*/*
get
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
200
OK
application/octet-stream
Responsestring · byte[]
get
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
200
OK
application/octet-stream
Responsestring · byte[]
get
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
200
OK
*/*
get
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-06-29T11:35:27.158Z",
    "signees": [
      {
        "status": "AWAITING",
        "signingOrder": 1,
        "rejectMessage": "text",
        "user": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "email": "text",
          "terms": true
        },
        "signedDate": "2025-06-29T11:35:27.158Z"
      }
    ]
  }
]

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
200
OK
*/*
Responseobject
delete
DELETE /services/documents/{documentId}/ HTTP/1.1
Host: professional.signius.eu:8970
Accept: */*
200

OK

{}

Last updated