Sdk reference
A list of all methods in the SignplusService
service. Click on the method name to view detailed information about that method.
Methods | Description |
---|---|
createEnvelope | Create new envelope |
createEnvelopeFromTemplate | Create new envelope from template |
listEnvelopes | List envelopes |
getEnvelope | Get envelope |
deleteEnvelope | Delete envelope |
getEnvelopeDocument | Get envelope document |
getEnvelopeDocuments | Get envelope documents |
addEnvelopeDocument | Add envelope document |
setEnvelopeDynamicFields | Set envelope dynamic fields |
addEnvelopeSigningSteps | Add envelope signing steps |
sendEnvelope | Send envelope for signature |
duplicateEnvelope | Duplicate envelope |
voidEnvelope | Void envelope |
renameEnvelope | Rename envelope |
setEnvelopeComment | Set envelope comment |
setEnvelopeNotification | Set envelope notification |
setEnvelopeExpirationDate | Set envelope expiration date |
setEnvelopeLegalityLevel | Set envelope legality level |
getEnvelopeAnnotations | Get envelope annotations |
getEnvelopeDocumentAnnotations | Get envelope document annotations |
addEnvelopeAnnotation | Add envelope annotation |
deleteEnvelopeAnnotation | Delete envelope annotation |
createTemplate | Create new template |
listTemplates | List templates |
getTemplate | Get template |
deleteTemplate | Delete template |
duplicateTemplate | Duplicate template |
addTemplateDocument | Add template document |
getTemplateDocument | Get template document |
getTemplateDocuments | Get template documents |
addTemplateSigningSteps | Add template signing steps |
renameTemplate | Rename template |
setTemplateComment | Set template comment |
setTemplateNotification | Set template notification |
getTemplateAnnotations | Get template annotations |
getDocumentTemplateAnnotations | Get document template annotations |
addTemplateAnnotation | Add template annotation |
deleteTemplateAnnotation | Delete template annotation |
createWebhook | Create webhook |
listWebhooks | List webhooks |
deleteWebhook | Delete webhook |
createEnvelope
Create new envelope
- HTTP Method:
POST
- Endpoint:
/envelope
Parameters
Name | Type | Required | Description |
---|---|---|---|
createEnvelopeRequest | CreateEnvelopeRequest | ✅ | Request Body |
Return Type
Envelope
Example Usage Code Snippet
createEnvelopeFromTemplate
Create new envelope from template
- HTTP Method:
POST
- Endpoint:
/envelope/from_template/{template_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ | |
createEnvelopeFromTemplateRequest | CreateEnvelopeFromTemplateRequest | ✅ | Request Body |
Return Type
Envelope
Example Usage Code Snippet
listEnvelopes
List envelopes
- HTTP Method:
POST
- Endpoint:
/envelopes
Parameters
Name | Type | Required | Description |
---|---|---|---|
listEnvelopesRequest | ListEnvelopesRequest | ❌ | Request Body |
Return Type
ListEnvelopesResponse
Example Usage Code Snippet
getEnvelope
Get envelope
- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ |
Return Type
Envelope
Example Usage Code Snippet
deleteEnvelope
Delete envelope
- HTTP Method:
DELETE
- Endpoint:
/envelope/{envelope_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ |
Example Usage Code Snippet
getEnvelopeDocument
Get envelope document
- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/document/{document_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ | |
documentId | String | ✅ |
Return Type
Document
Example Usage Code Snippet
getEnvelopeDocuments
Get envelope documents
- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/documents
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ |
Return Type
ListEnvelopeDocumentsResponse
Example Usage Code Snippet
addEnvelopeDocument
Add envelope document
- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/document
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ | |
addEnvelopeDocumentRequest | AddEnvelopeDocumentRequest | ✅ | Request Body |
Return Type
Document
Example Usage Code Snippet
setEnvelopeDynamicFields
Set envelope dynamic fields
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/dynamic_fields
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ | |
setEnvelopeDynamicFieldsRequest | SetEnvelopeDynamicFieldsRequest | ✅ | Request Body |
Return Type
Envelope
Example Usage Code Snippet
addEnvelopeSigningSteps
Add envelope signing steps
- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/signing_steps
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ | |
addEnvelopeSigningStepsRequest | AddEnvelopeSigningStepsRequest | ✅ | Request Body |
Return Type
Envelope
Example Usage Code Snippet
sendEnvelope
Send envelope for signature
- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/send
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ |
Return Type
Envelope
Example Usage Code Snippet
duplicateEnvelope
Duplicate envelope
- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/duplicate
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ |
Return Type
Envelope
Example Usage Code Snippet
voidEnvelope
Void envelope
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/void
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ |
Return Type
Envelope
Example Usage Code Snippet
renameEnvelope
Rename envelope
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/rename
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ | |
renameEnvelopeRequest | RenameEnvelopeRequest | ✅ | Request Body |
Return Type
Envelope
Example Usage Code Snippet
setEnvelopeComment
Set envelope comment
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/set_comment
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ | |
setEnvelopeCommentRequest | SetEnvelopeCommentRequest | ✅ | Request Body |
Return Type
Envelope
Example Usage Code Snippet
setEnvelopeNotification
Set envelope notification
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/set_notification
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ | |
envelopeNotification | EnvelopeNotification | ✅ | Request Body |
Return Type
Envelope
Example Usage Code Snippet
setEnvelopeExpirationDate
Set envelope expiration date
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/set_expiration_date
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ | |
setEnvelopeExpirationRequest | SetEnvelopeExpirationRequest | ✅ | Request Body |
Return Type
Envelope
Example Usage Code Snippet
setEnvelopeLegalityLevel
Set envelope legality level
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/set_legality_level
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ | |
setEnvelopeLegalityLevelRequest | SetEnvelopeLegalityLevelRequest | ✅ | Request Body |
Return Type
Envelope
Example Usage Code Snippet
getEnvelopeAnnotations
Get envelope annotations
- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/annotations
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ | ID of the envelope |
Return Type
List<Annotation>
Example Usage Code Snippet
getEnvelopeDocumentAnnotations
Get envelope document annotations
- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/annotations/{document_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ | ID of the envelope |
documentId | String | ✅ | ID of document |
Return Type
ListEnvelopeDocumentAnnotationsResponse
Example Usage Code Snippet
addEnvelopeAnnotation
Add envelope annotation
- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/annotation
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ | ID of the envelope |
addAnnotationRequest | AddAnnotationRequest | ✅ | Request Body |
Return Type
Annotation
Example Usage Code Snippet
deleteEnvelopeAnnotation
Delete envelope annotation
- HTTP Method:
DELETE
- Endpoint:
/envelope/{envelope_id}/annotation/{annotation_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
envelopeId | String | ✅ | ID of the envelope |
annotationId | String | ✅ | ID of the annotation to delete |
Example Usage Code Snippet
createTemplate
Create new template
- HTTP Method:
POST
- Endpoint:
/template
Parameters
Name | Type | Required | Description |
---|---|---|---|
createTemplateRequest | CreateTemplateRequest | ✅ | Request Body |
Return Type
Template
Example Usage Code Snippet
listTemplates
List templates
- HTTP Method:
POST
- Endpoint:
/templates
Parameters
Name | Type | Required | Description |
---|---|---|---|
listTemplatesRequest | ListTemplatesRequest | ❌ | Request Body |
Return Type
ListTemplatesResponse
Example Usage Code Snippet
getTemplate
Get template
- HTTP Method:
GET
- Endpoint:
/template/{template_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ |
Return Type
Template
Example Usage Code Snippet
deleteTemplate
Delete template
- HTTP Method:
DELETE
- Endpoint:
/template/{template_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ |
Example Usage Code Snippet
duplicateTemplate
Duplicate template
- HTTP Method:
POST
- Endpoint:
/template/{template_id}/duplicate
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ |
Return Type
Template
Example Usage Code Snippet
addTemplateDocument
Add template document
- HTTP Method:
POST
- Endpoint:
/template/{template_id}/document
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ | |
addTemplateDocumentRequest | AddTemplateDocumentRequest | ✅ | Request Body |
Return Type
Document
Example Usage Code Snippet
getTemplateDocument
Get template document
- HTTP Method:
GET
- Endpoint:
/template/{template_id}/document/{document_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ | |
documentId | String | ✅ |
Return Type
Document
Example Usage Code Snippet
getTemplateDocuments
Get template documents
- HTTP Method:
GET
- Endpoint:
/template/{template_id}/documents
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ |
Return Type
ListTemplateDocumentsResponse
Example Usage Code Snippet
addTemplateSigningSteps
Add template signing steps
- HTTP Method:
POST
- Endpoint:
/template/{template_id}/signing_steps
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ | |
addTemplateSigningStepsRequest | AddTemplateSigningStepsRequest | ✅ | Request Body |
Return Type
Template
Example Usage Code Snippet
renameTemplate
Rename template
- HTTP Method:
PUT
- Endpoint:
/template/{template_id}/rename
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ | |
renameTemplateRequest | RenameTemplateRequest | ✅ | Request Body |
Return Type
Template
Example Usage Code Snippet
setTemplateComment
Set template comment
- HTTP Method:
PUT
- Endpoint:
/template/{template_id}/set_comment
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ | |
setTemplateCommentRequest | SetTemplateCommentRequest | ✅ | Request Body |
Return Type
Template
Example Usage Code Snippet
setTemplateNotification
Set template notification
- HTTP Method:
PUT
- Endpoint:
/template/{template_id}/set_notification
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ | |
envelopeNotification | EnvelopeNotification | ✅ | Request Body |
Return Type
Template
Example Usage Code Snippet
getTemplateAnnotations
Get template annotations
- HTTP Method:
GET
- Endpoint:
/template/{template_id}/annotations
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ | ID of the template |
Return Type
ListTemplateAnnotationsResponse
Example Usage Code Snippet
getDocumentTemplateAnnotations
Get document template annotations
- HTTP Method:
GET
- Endpoint:
/template/{template_id}/annotations/{document_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ | ID of the template |
documentId | String | ✅ | ID of document |
Return Type
ListTemplateDocumentAnnotationsResponse
Example Usage Code Snippet
addTemplateAnnotation
Add template annotation
- HTTP Method:
POST
- Endpoint:
/template/{template_id}/annotation
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ | ID of the template |
addAnnotationRequest | AddAnnotationRequest | ✅ | Request Body |
Return Type
Annotation
Example Usage Code Snippet
deleteTemplateAnnotation
Delete template annotation
- HTTP Method:
DELETE
- Endpoint:
/template/{template_id}/annotation/{annotation_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
templateId | String | ✅ | ID of the template |
annotationId | String | ✅ | ID of the annotation to delete |
Example Usage Code Snippet
createWebhook
Create webhook
- HTTP Method:
POST
- Endpoint:
/webhook
Parameters
Name | Type | Required | Description |
---|---|---|---|
createWebhookRequest | CreateWebhookRequest | ✅ | Request Body |
Return Type
Webhook
Example Usage Code Snippet
listWebhooks
List webhooks
- HTTP Method:
POST
- Endpoint:
/webhooks
Parameters
Name | Type | Required | Description |
---|---|---|---|
listWebhooksRequest | ListWebhooksRequest | ❌ | Request Body |
Return Type
ListWebhooksResponse
Example Usage Code Snippet
deleteWebhook
Delete webhook
- HTTP Method:
DELETE
- Endpoint:
/webhook/{webhook_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
webhookId | String | ✅ |
Example Usage Code Snippet
Models
Document
Properties
Name | Type | Required | Description |
---|---|---|---|
id | String | ❌ | Unique identifier of the document |
name | String | ❌ | Name of the document |
filename | String | ❌ | Filename of the document |
pageCount | Long | ❌ | Number of pages in the document |
pages | List<Page> | ❌ | List of pages in the document |
CreateEnvelopeRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
name | String | ✅ | Name of the envelope |
legalityLevel | EnvelopeLegalityLevel | ✅ | Legal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes) |
expiresAt | Long | ❌ | Unix timestamp of the expiration date |
comment | String | ❌ | Comment for the envelope |
sandbox | Boolean | ❌ | Whether the envelope is created in sandbox mode |
ListEnvelopesRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
name | String | ❌ | Name of the envelope |
tags | List<String> | ❌ | List of tags |
comment | String | ❌ | Comment of the envelope |
ids | List<String> | ❌ | List of envelope IDs |
statuses | List<EnvelopeStatus> | ❌ | List of envelope statuses |
folderIds | List<String> | ❌ | List of folder IDs |
onlyRootFolder | Boolean | ❌ | Whether to only list envelopes in the root folder |
dateFrom | Long | ❌ | Unix timestamp of the start date |
dateTo | Long | ❌ | Unix timestamp of the end date |
uid | String | ❌ | Unique identifier of the user |
first | Long | ❌ | |
last | Long | ❌ | |
after | String | ❌ | |
before | String | ❌ | |
orderField | EnvelopeOrderField | ❌ | Field to order envelopes by |
ascending | Boolean | ❌ | Whether to order envelopes in ascending order |
includeTrash | Boolean | ❌ | Whether to include envelopes in the trash |
EnvelopeNotification
Properties
Name | Type | Required | Description |
---|---|---|---|
subject | String | ❌ | Subject of the notification |
message | String | ❌ | Message of the notification |
reminderInterval | Long | ❌ | Interval in days to send reminder |
ListTemplatesRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
name | String | ❌ | Name of the template |
tags | List<String> | ❌ | List of tag templates |
ids | List<String> | ❌ | List of templates IDs |
first | Long | ❌ | |
last | Long | ❌ | |
after | String | ❌ | |
before | String | ❌ | |
orderField | TemplateOrderField | ❌ | Field to order templates by |
ascending | Boolean | ❌ | Whether to order templates in ascending order |
SetTemplateCommentRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
comment | String | ✅ | Comment for the template |
Template
Properties
Name | Type | Required | Description |
---|---|---|---|
id | String | ❌ | Unique identifier of the template |
name | String | ❌ | Name of the template |
comment | String | ❌ | Comment for the template |
pages | Long | ❌ | Total number of pages in the template |
legalityLevel | EnvelopeLegalityLevel | ❌ | Legal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes) |
createdAt | Long | ❌ | Unix timestamp of the creation date |
updatedAt | Long | ❌ | Unix timestamp of the last modification date |
expirationDelay | Long | ❌ | Expiration delay added to the current time when an envelope is created from this template |
numRecipients | Long | ❌ | Number of recipients in the envelope |
signingSteps | List<TemplateSigningStep> | ❌ | |
documents | List<Document> | ❌ | |
notification | EnvelopeNotification | ❌ | |
dynamicFields | List<String> | ❌ | List of dynamic fields |
RecipientVerificationType
Type of signature verification (SMS sends a code via SMS, PASSCODE requires a code to be entered)
Properties
Name | Type | Required | Description |
---|---|---|---|
SMS | String | ✅ | “SMS” |
PASSCODE | String | ✅ | “PASSCODE” |
AddEnvelopeSigningStepsRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
signingSteps | List<SigningStep> | ❌ | List of signing steps |
AnnotationFontFamily
Font family of the text
Properties
Name | Type | Required | Description |
---|---|---|---|
UNKNOWN | String | ✅ | “UNKNOWN” |
SERIF | String | ✅ | “SERIF” |
SANS | String | ✅ | “SANS” |
MONO | String | ✅ | “MONO” |
AddTemplateSigningStepsRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
signingSteps | List<TemplateSigningStep> | ✅ | List of signing steps |
SetEnvelopeCommentRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
comment | String | ✅ | Comment for the envelope |
TemplateOrderField
Field to order templates by
Properties
Name | Type | Required | Description |
---|---|---|---|
TEMPLATE_ID | String | ✅ | “TEMPLATE_ID” |
TEMPLATE_CREATION_DATE | String | ✅ | “TEMPLATE_CREATION_DATE” |
TEMPLATE_MODIFICATION_DATE | String | ✅ | “TEMPLATE_MODIFICATION_DATE” |
TEMPLATE_NAME | String | ✅ | “TEMPLATE_NAME” |
EnvelopeOrderField
Field to order envelopes by
Properties
Name | Type | Required | Description |
---|---|---|---|
CREATION_DATE | String | ✅ | “CREATION_DATE” |
MODIFICATION_DATE | String | ✅ | “MODIFICATION_DATE” |
NAME | String | ✅ | “NAME” |
STATUS | String | ✅ | “STATUS” |
LAST_DOCUMENT_CHANGE | String | ✅ | “LAST_DOCUMENT_CHANGE” |
AddEnvelopeDocumentRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
file | byte[] | ❌ | File to upload in binary format |
ListWebhooksRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
webhookId | String | ❌ | ID of the webhook |
event | WebhookEvent | ❌ | Event of the webhook |
SetEnvelopeLegalityLevelRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
legalityLevel | EnvelopeLegalityLevel | ❌ | Legal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes) |
SetEnvelopeExpirationRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
expiresAt | Long | ✅ | Unix timestamp of the expiration date |
AnnotationText
Text annotation (null if annotation is not a text)
Properties
Name | Type | Required | Description |
---|---|---|---|
size | Double | ❌ | Font size of the text in pt |
color | Double | ❌ | Text color in 32bit representation |
value | String | ❌ | Text content of the annotation |
tooltip | String | ❌ | Tooltip of the annotation |
dynamicFieldName | String | ❌ | Name of the dynamic field |
font | AnnotationFont | ❌ |
AnnotationCheckbox
Checkbox annotation (null if annotation is not a checkbox)
Properties
Name | Type | Required | Description |
---|---|---|---|
checked | Boolean | ❌ | Whether the checkbox is checked |
style | AnnotationCheckboxStyle | ❌ | Style of the checkbox |
Envelope
Properties
Name | Type | Required | Description |
---|---|---|---|
id | String | ❌ | Unique identifier of the envelope |
name | String | ❌ | Name of the envelope |
comment | String | ❌ | Comment for the envelope |
pages | Long | ❌ | Total number of pages in the envelope |
flowType | EnvelopeFlowType | ❌ | Flow type of the envelope (REQUEST_SIGNATURE is a request for signature, SIGN_MYSELF is a self-signing flow) |
legalityLevel | EnvelopeLegalityLevel | ❌ | Legal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes) |
status | EnvelopeStatus | ❌ | Status of the envelope |
createdAt | Long | ❌ | Unix timestamp of the creation date |
updatedAt | Long | ❌ | Unix timestamp of the last modification date |
expiresAt | Long | ❌ | Unix timestamp of the expiration date |
numRecipients | Long | ❌ | Number of recipients in the envelope |
isDuplicable | Boolean | ❌ | Whether the envelope can be duplicated |
signingSteps | List<SigningStep> | ❌ | |
documents | List<Document> | ❌ | |
notification | EnvelopeNotification | ❌ |
AddTemplateDocumentRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
file | byte[] | ✅ | File to upload in binary format |
TemplateRecipient
Properties
Name | Type | Required | Description |
---|---|---|---|
id | String | ❌ | Unique identifier of the recipient |
uid | String | ❌ | Unique identifier of the user associated with the recipient |
name | String | ❌ | Name of the recipient |
String | ❌ | Email of the recipient | |
role | TemplateRecipientRole | ❌ | Role of the recipient (SIGNER signs the document, RECEIVES_COPY receives a copy of the document, IN_PERSON_SIGNER signs the document in person, SENDER sends the document) |
AddAnnotationRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
documentId | String | ✅ | ID of the document |
page | Long | ✅ | Page number where the annotation is placed |
x | Double | ✅ | X coordinate of the annotation (in % of the page width from 0 to 100) from the top left corner |
y | Double | ✅ | Y coordinate of the annotation (in % of the page height from 0 to 100) from the top left corner |
width | Double | ✅ | Width of the annotation (in % of the page width from 0 to 100) |
height | Double | ✅ | Height of the annotation (in % of the page height from 0 to 100) |
type | AnnotationType | ✅ | Type of the annotation |
recipientId | String | ❌ | ID of the recipient |
required | Boolean | ❌ | |
signature | AnnotationSignature | ❌ | Signature annotation (null if annotation is not a signature) |
initials | AnnotationInitials | ❌ | Initials annotation (null if annotation is not initials) |
text | AnnotationText | ❌ | Text annotation (null if annotation is not a text) |
datetime | AnnotationDateTime | ❌ | Date annotation (null if annotation is not a date) |
checkbox | AnnotationCheckbox | ❌ | Checkbox annotation (null if annotation is not a checkbox) |
ListEnvelopeDocumentAnnotationsResponse
Properties
Name | Type | Required | Description |
---|---|---|---|
annotations | List<Annotation> | ❌ |
EnvelopeStatus
Status of the envelope
Properties
Name | Type | Required | Description |
---|---|---|---|
DRAFT | String | ✅ | “DRAFT” |
IN_PROGRESS | String | ✅ | “IN_PROGRESS” |
COMPLETED | String | ✅ | “COMPLETED” |
EXPIRED | String | ✅ | “EXPIRED” |
DECLINED | String | ✅ | “DECLINED” |
VOIDED | String | ✅ | “VOIDED” |
PENDING | String | ✅ | “PENDING” |
RecipientVerification
Properties
Name | Type | Required | Description |
---|---|---|---|
type | RecipientVerificationType | ❌ | Type of signature verification (SMS sends a code via SMS, PASSCODE requires a code to be entered) |
value | String | ❌ |
AnnotationCheckboxStyle
Style of the checkbox
Properties
Name | Type | Required | Description |
---|---|---|---|
CIRCLE_CHECK | String | ✅ | “CIRCLE_CHECK” |
CIRCLE_FULL | String | ✅ | “CIRCLE_FULL” |
SQUARE_CHECK | String | ✅ | “SQUARE_CHECK” |
SQUARE_FULL | String | ✅ | “SQUARE_FULL” |
CHECK_MARK | String | ✅ | “CHECK_MARK” |
TIMES_SQUARE | String | ✅ | “TIMES_SQUARE” |
SigningStep
Properties
Name | Type | Required | Description |
---|---|---|---|
recipients | List<Recipient> | ❌ | List of recipients |
AnnotationDateTime
Date annotation (null if annotation is not a date)
Properties
Name | Type | Required | Description |
---|---|---|---|
size | Double | ❌ | Font size of the text in pt |
font | AnnotationFont | ❌ | |
color | String | ❌ | Color of the text in hex format |
autoFill | Boolean | ❌ | Whether the date should be automatically filled |
timezone | String | ❌ | Timezone of the date |
timestamp | Long | ❌ | Unix timestamp of the date |
format | AnnotationDateTimeFormat | ❌ | Format of the date time (DMY_NUMERIC_SLASH is day/month/year with slashes, MDY_NUMERIC_SLASH is month/day/year with slashes, YMD_NUMERIC_SLASH is year/month/day with slashes, DMY_NUMERIC_DASH_SHORT is day/month/year with dashes, DMY_NUMERIC_DASH is day/month/year with dashes, YMD_NUMERIC_DASH is year/month/day with dashes, MDY_TEXT_DASH_SHORT is month/day/year with dashes, MDY_TEXT_SPACE_SHORT is month/day/year with spaces, MDY_TEXT_SPACE is month/day/year with spaces) |
CreateTemplateRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
name | String | ✅ |
ListTemplateDocumentsResponse
Properties
Name | Type | Required | Description |
---|---|---|---|
documents | List<Document> | ❌ |
AnnotationInitials
Initials annotation (null if annotation is not initials)
Properties
Name | Type | Required | Description |
---|---|---|---|
id | String | ❌ | Unique identifier of the annotation initials |
AnnotationFont
Properties
Name | Type | Required | Description |
---|---|---|---|
family | AnnotationFontFamily | ❌ | Font family of the text |
italic | Boolean | ❌ | Whether the text is italic |
bold | Boolean | ❌ | Whether the text is bold |
AnnotationType
Type of the annotation
Properties
Name | Type | Required | Description |
---|---|---|---|
TEXT | String | ✅ | “TEXT” |
SIGNATURE | String | ✅ | “SIGNATURE” |
INITIALS | String | ✅ | “INITIALS” |
CHECKBOX | String | ✅ | “CHECKBOX” |
DATE | String | ✅ | “DATE” |
Webhook
Properties
Name | Type | Required | Description |
---|---|---|---|
id | String | ❌ | Unique identifier of the webhook |
event | WebhookEvent | ❌ | Event of the webhook |
target | String | ❌ | Target URL of the webhook |
RenameTemplateRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
name | String | ✅ | Name of the template |
ListTemplatesResponse
Properties
Name | Type | Required | Description |
---|---|---|---|
hasNextPage | Boolean | ❌ | Whether there is a next page |
hasPreviousPage | Boolean | ❌ | Whether there is a previous page |
templates | List<Template> | ❌ |
RecipientRole
Role of the recipient (SIGNER signs the document, RECEIVES_COPY receives a copy of the document, IN_PERSON_SIGNER signs the document in person, SENDER sends the document)
Properties
Name | Type | Required | Description |
---|---|---|---|
SIGNER | String | ✅ | “SIGNER” |
RECEIVES_COPY | String | ✅ | “RECEIVES_COPY” |
IN_PERSON_SIGNER | String | ✅ | “IN_PERSON_SIGNER” |
Annotation
Properties
Name | Type | Required | Description |
---|---|---|---|
id | String | ❌ | Unique identifier of the annotation |
recipientId | String | ❌ | ID of the recipient |
documentId | String | ❌ | ID of the document |
page | Long | ❌ | Page number where the annotation is placed |
x | Double | ❌ | X coordinate of the annotation (in % of the page width from 0 to 100) from the top left corner |
y | Double | ❌ | Y coordinate of the annotation (in % of the page height from 0 to 100) from the top left corner |
width | Double | ❌ | Width of the annotation (in % of the page width from 0 to 100) |
height | Double | ❌ | Height of the annotation (in % of the page height from 0 to 100) |
required | Boolean | ❌ | Whether the annotation is required |
type | AnnotationType | ❌ | Type of the annotation |
signature | AnnotationSignature | ❌ | Signature annotation (null if annotation is not a signature) |
initials | AnnotationInitials | ❌ | Initials annotation (null if annotation is not initials) |
text | AnnotationText | ❌ | Text annotation (null if annotation is not a text) |
datetime | AnnotationDateTime | ❌ | Date annotation (null if annotation is not a date) |
checkbox | AnnotationCheckbox | ❌ | Checkbox annotation (null if annotation is not a checkbox) |
DynamicField
Properties
Name | Type | Required | Description |
---|---|---|---|
name | String | ❌ | Name of the dynamic field |
value | String | ❌ | Value of the dynamic field |
AnnotationDateTimeFormat
Format of the date time (DMY_NUMERIC_SLASH is day/month/year with slashes, MDY_NUMERIC_SLASH is month/day/year with slashes, YMD_NUMERIC_SLASH is year/month/day with slashes, DMY_NUMERIC_DASH_SHORT is day/month/year with dashes, DMY_NUMERIC_DASH is day/month/year with dashes, YMD_NUMERIC_DASH is year/month/day with dashes, MDY_TEXT_DASH_SHORT is month/day/year with dashes, MDY_TEXT_SPACE_SHORT is month/day/year with spaces, MDY_TEXT_SPACE is month/day/year with spaces)
Properties
Name | Type | Required | Description |
---|---|---|---|
DMY_NUMERIC_SLASH | String | ✅ | “DMY_NUMERIC_SLASH” |
MDY_NUMERIC_SLASH | String | ✅ | “MDY_NUMERIC_SLASH” |
YMD_NUMERIC_SLASH | String | ✅ | “YMD_NUMERIC_SLASH” |
DMY_NUMERIC_DASH_SHORT | String | ✅ | “DMY_NUMERIC_DASH_SHORT” |
DMY_NUMERIC_DASH | String | ✅ | “DMY_NUMERIC_DASH” |
YMD_NUMERIC_DASH | String | ✅ | “YMD_NUMERIC_DASH” |
MDY_TEXT_DASH_SHORT | String | ✅ | “MDY_TEXT_DASH_SHORT” |
MDY_TEXT_SPACE_SHORT | String | ✅ | “MDY_TEXT_SPACE_SHORT” |
MDY_TEXT_SPACE | String | ✅ | “MDY_TEXT_SPACE” |
EnvelopeFlowType
Flow type of the envelope (REQUEST_SIGNATURE is a request for signature, SIGN_MYSELF is a self-signing flow)
Properties
Name | Type | Required | Description |
---|---|---|---|
REQUEST_SIGNATURE | String | ✅ | “REQUEST_SIGNATURE” |
SIGN_MYSELF | String | ✅ | “SIGN_MYSELF” |
EnvelopeLegalityLevel
Legal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes)
Properties
Name | Type | Required | Description |
---|---|---|---|
SES | String | ✅ | “SES” |
QES_EIDAS | String | ✅ | “QES_EIDAS” |
QES_ZERTES | String | ✅ | “QES_ZERTES” |
TemplateRecipientRole
Role of the recipient (SIGNER signs the document, RECEIVES_COPY receives a copy of the document, IN_PERSON_SIGNER signs the document in person, SENDER sends the document)
Properties
Name | Type | Required | Description |
---|---|---|---|
SIGNER | String | ✅ | “SIGNER” |
RECEIVES_COPY | String | ✅ | “RECEIVES_COPY” |
IN_PERSON_SIGNER | String | ✅ | “IN_PERSON_SIGNER” |
SetEnvelopeDynamicFieldsRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
dynamicFields | List<DynamicField> | ✅ | List of dynamic fields |
Page
Properties
Name | Type | Required | Description |
---|---|---|---|
width | Long | ❌ | Width of the page in pixels |
height | Long | ❌ | Height of the page in pixels |
TemplateSigningStep
Properties
Name | Type | Required | Description |
---|---|---|---|
recipients | List<TemplateRecipient> | ❌ | List of recipients |
ListEnvelopesResponse
Properties
Name | Type | Required | Description |
---|---|---|---|
hasNextPage | Boolean | ❌ | Whether there is a next page |
hasPreviousPage | Boolean | ❌ | Whether there is a previous page |
envelopes | List<Envelope> | ❌ |
Recipient
Properties
Name | Type | Required | Description |
---|---|---|---|
name | String | ✅ | Name of the recipient |
String | ✅ | Email of the recipient | |
role | RecipientRole | ✅ | Role of the recipient (SIGNER signs the document, RECEIVES_COPY receives a copy of the document, IN_PERSON_SIGNER signs the document in person, SENDER sends the document) |
id | String | ❌ | Unique identifier of the recipient |
uid | String | ❌ | Unique identifier of the user associated with the recipient |
verification | RecipientVerification | ❌ |
WebhookEvent
Event of the webhook
Properties
Name | Type | Required | Description |
---|---|---|---|
ENVELOPE_EXPIRED | String | ✅ | “ENVELOPE_EXPIRED” |
ENVELOPE_DECLINED | String | ✅ | “ENVELOPE_DECLINED” |
ENVELOPE_VOIDED | String | ✅ | “ENVELOPE_VOIDED” |
ENVELOPE_COMPLETED | String | ✅ | “ENVELOPE_COMPLETED” |
ENVELOPE_AUDIT_TRAIL | String | ✅ | “ENVELOPE_AUDIT_TRAIL” |
CreateWebhookRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
event | WebhookEvent | ✅ | Event of the webhook |
target | String | ✅ | URL of the webhook target |
CreateEnvelopeFromTemplateRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
name | String | ✅ | Name of the envelope |
comment | String | ❌ | Comment for the envelope |
sandbox | Boolean | ❌ | Whether the envelope is created in sandbox mode |
ListTemplateAnnotationsResponse
Properties
Name | Type | Required | Description |
---|---|---|---|
annotations | List<Annotation> | ❌ |
RenameEnvelopeRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
name | String | ❌ | Name of the envelope |
ListTemplateDocumentAnnotationsResponse
Properties
Name | Type | Required | Description |
---|---|---|---|
annotations | List<Annotation> | ❌ |
ListEnvelopeDocumentsResponse
Properties
Name | Type | Required | Description |
---|---|---|---|
documents | List<Document> | ❌ |
ListWebhooksResponse
Properties
Name | Type | Required | Description |
---|---|---|---|
webhooks | List<Webhook> | ❌ |
AnnotationSignature
Signature annotation (null if annotation is not a signature)
Properties
Name | Type | Required | Description |
---|---|---|---|
id | String | ❌ | Unique identifier of the annotation signature |