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

Document handling

PreviousFoldersNextAutomatic signing

Last updated 1 month ago

Submit a document for signing

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": "example@example.com",
      "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 a document link

Download original document

Download signed document

List all documents in the folder

Delete a 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

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

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-05-17T20:12:38.724Z",
    "signees": [
      {
        "status": "AWAITING",
        "signingOrder": 1,
        "rejectMessage": "text",
        "user": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "email": "text",
          "terms": true
        },
        "signedDate": "2025-05-17T20:12:38.724Z"
      }
    ]
  }
]

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

{}

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
*/*
400
Error occured
application/json
put
PUT /services/documents/{documentId} HTTP/1.1
Host: professional.signius.eu:8970
Content-Type: application/json
Accept: */*
Content-Length: 281

{
  "signeesUsers": [
    {
      "signeeEmail": "example@example.com",
      "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-05-17T20:12:38.724Z",
  "signees": [
    {
      "status": "AWAITING",
      "signingOrder": 1,
      "rejectMessage": "text",
      "user": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "email": "text",
        "terms": true
      },
      "signedDate": "2025-05-17T20:12:38.724Z"
    }
  ]
}

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

OK

{
  "documentLink": "text"
}
  • Submit a document for signing
  • PUTSubmit a document for signing
  • Submit a document for signing with specifing location of graphical representation of signarure
  • Callbacks
  • Document signing status change notification
  • Get a document link
  • GETGet a document link
  • Download original document
  • GETDownload original document
  • Download signed document
  • GETDownload signed document
  • List all documents in the folder
  • GETList all documents in the folder
  • Delete a document
  • DELETEDelete a document