Signplus
service. Click on the method name to view detailed information about that method.
Methods | Description |
---|---|
create_envelope | Create new envelope |
create_envelope_from_template | Create new envelope from template |
list_envelopes | List envelopes |
get_envelope | Get envelope |
delete_envelope | Delete envelope |
download_envelope_signed_documents | Download signed documents for an envelope |
download_envelope_certificate | Download certificate of completion for an envelope |
get_envelope_document | Get envelope document |
get_envelope_documents | Get envelope documents |
add_envelope_document | Add envelope document |
set_envelope_dynamic_fields | Set envelope dynamic fields |
add_envelope_signing_steps | Add envelope signing steps |
set_envelope_attachments_settings | Set envelope attachment settings |
set_envelope_attachments_placeholders | Placeholders to be set, completely replacing the existing ones. |
get_attachment_file | Get envelope attachment file |
send_envelope | Send envelope for signature |
duplicate_envelope | Duplicate envelope |
void_envelope | Void envelope |
rename_envelope | Rename envelope |
set_envelope_comment | Set envelope comment |
set_envelope_notification | Set envelope notification |
set_envelope_expiration_date | Set envelope expiration date |
set_envelope_legality_level | Set envelope legality level |
get_envelope_annotations | Get envelope annotations |
get_envelope_document_annotations | Get envelope document annotations |
add_envelope_annotation | Add envelope annotation |
delete_envelope_annotation | Delete envelope annotation |
create_template | Create new template |
list_templates | List templates |
get_template | Get template |
delete_template | Delete template |
duplicate_template | Duplicate template |
add_template_document | Add template document |
get_template_document | Get template document |
get_template_documents | Get template documents |
add_template_signing_steps | Add template signing steps |
rename_template | Rename template |
set_template_comment | Set template comment |
set_template_notification | Set template notification |
get_template_annotations | Get template annotations |
get_document_template_annotations | Get document template annotations |
add_template_annotation | Add template annotation |
delete_template_annotation | Delete template annotation |
set_template_attachments_settings | Set template attachment settings |
set_template_attachments_placeholders | Placeholders to be set, completely replacing the existing ones. |
create_webhook | Create webhook |
list_webhooks | List webhooks |
delete_webhook | Delete webhook |
create_envelope
Create new envelope- HTTP Method:
POST
- Endpoint:
/envelope
Name | Type | Required | Description |
---|---|---|---|
input | Models\CreateEnvelopeRequest | ✅ | Create new envelope |
Models\Envelope
Example Usage Code Snippet
create_envelope_from_template
Create new envelope from template- HTTP Method:
POST
- Endpoint:
/envelope/from_template/{template_id}
Name | Type | Required | Description |
---|---|---|---|
input | Models\CreateEnvelopeFromTemplateRequest | ✅ | Create new envelope from template |
$templateId | string | ✅ |
Models\Envelope
Example Usage Code Snippet
list_envelopes
List envelopes- HTTP Method:
POST
- Endpoint:
/envelopes
Name | Type | Required | Description |
---|---|---|---|
input | Models\ListEnvelopesRequest | ❌ | List envelopes |
Models\ListEnvelopesResponse
Example Usage Code Snippet
get_envelope
Get envelope- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ |
Models\Envelope
Example Usage Code Snippet
delete_envelope
Delete envelope- HTTP Method:
DELETE
- Endpoint:
/envelope/{envelope_id}
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ |
mixed
Example Usage Code Snippet
download_envelope_signed_documents
Download signed documents for an envelope- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/signed_documents
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ | ID of the envelope |
$certificateOfCompletion | bool | ❌ | Whether to include the certificate of completion in the downloaded file |
mixed
Example Usage Code Snippet
download_envelope_certificate
Download certificate of completion for an envelope- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/certificate
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ | ID of the envelope |
mixed
Example Usage Code Snippet
get_envelope_document
Get envelope document- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/document/{document_id}
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ | |
$documentId | string | ✅ |
Models\Document
Example Usage Code Snippet
get_envelope_documents
Get envelope documents- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/documents
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ |
Models\ListEnvelopeDocumentsResponse
Example Usage Code Snippet
add_envelope_document
Add envelope document- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/document
Name | Type | Required | Description |
---|---|---|---|
input | Models\AddEnvelopeDocumentRequest | ✅ | Add envelope document |
$envelopeId | string | ✅ |
Models\Document
Example Usage Code Snippet
set_envelope_dynamic_fields
Set envelope dynamic fields- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/dynamic_fields
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetEnvelopeDynamicFieldsRequest | ✅ | Set envelope dynamic fields |
$envelopeId | string | ✅ |
Models\Envelope
Example Usage Code Snippet
add_envelope_signing_steps
Add envelope signing steps- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/signing_steps
Name | Type | Required | Description |
---|---|---|---|
input | Models\AddEnvelopeSigningStepsRequest | ✅ | Add envelope signing steps |
$envelopeId | string | ✅ |
Models\Envelope
Example Usage Code Snippet
set_envelope_attachments_settings
Set envelope attachment settings- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/attachments/settings
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetEnvelopeAttachmentsSettingsRequest | ✅ | Set envelope attachment settings |
$envelopeId | string | ✅ |
Models\EnvelopeAttachments
Example Usage Code Snippet
set_envelope_attachments_placeholders
Placeholders to be set, completely replacing the existing ones.- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/attachments/placeholders
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetEnvelopeAttachmentsPlaceholdersRequest | ✅ | Placeholders to be set, completely replacing the existing ones. |
$envelopeId | string | ✅ |
Models\EnvelopeAttachments
Example Usage Code Snippet
get_attachment_file
Get envelope attachment file- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/attachments/{file_id}
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ | |
$fileId | string | ✅ |
mixed
Example Usage Code Snippet
send_envelope
Send envelope for signature- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/send
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ |
Models\Envelope
Example Usage Code Snippet
duplicate_envelope
Duplicate envelope- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/duplicate
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ |
Models\Envelope
Example Usage Code Snippet
void_envelope
Void envelope- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/void
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ |
Models\Envelope
Example Usage Code Snippet
rename_envelope
Rename envelope- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/rename
Name | Type | Required | Description |
---|---|---|---|
input | Models\RenameEnvelopeRequest | ✅ | Rename envelope |
$envelopeId | string | ✅ |
Models\Envelope
Example Usage Code Snippet
set_envelope_comment
Set envelope comment- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/set_comment
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetEnvelopeCommentRequest | ✅ | Set envelope comment |
$envelopeId | string | ✅ |
Models\Envelope
Example Usage Code Snippet
set_envelope_notification
Set envelope notification- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/set_notification
Name | Type | Required | Description |
---|---|---|---|
input | Models\EnvelopeNotification | ✅ | Set envelope notification |
$envelopeId | string | ✅ |
Models\Envelope
Example Usage Code Snippet
set_envelope_expiration_date
Set envelope expiration date- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/set_expiration_date
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetEnvelopeExpirationRequest | ✅ | Set envelope expiration date |
$envelopeId | string | ✅ |
Models\Envelope
Example Usage Code Snippet
set_envelope_legality_level
Set envelope legality level- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/set_legality_level
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetEnvelopeLegalityLevelRequest | ✅ | Set envelope legality level |
$envelopeId | string | ✅ |
Models\Envelope
Example Usage Code Snippet
get_envelope_annotations
Get envelope annotations- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/annotations
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ | ID of the envelope |
array
Example Usage Code Snippet
get_envelope_document_annotations
Get envelope document annotations- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/annotations/{document_id}
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ | ID of the envelope |
$documentId | string | ✅ | ID of document |
Models\ListEnvelopeDocumentAnnotationsResponse
Example Usage Code Snippet
add_envelope_annotation
Add envelope annotation- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/annotation
Name | Type | Required | Description |
---|---|---|---|
input | Models\AddAnnotationRequest | ✅ | Add envelope annotation |
$envelopeId | string | ✅ | ID of the envelope |
Models\Annotation
Example Usage Code Snippet
delete_envelope_annotation
Delete envelope annotation- HTTP Method:
DELETE
- Endpoint:
/envelope/{envelope_id}/annotation/{annotation_id}
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ | ID of the envelope |
$annotationId | string | ✅ | ID of the annotation to delete |
mixed
Example Usage Code Snippet
create_template
Create new template- HTTP Method:
POST
- Endpoint:
/template
Name | Type | Required | Description |
---|---|---|---|
input | Models\CreateTemplateRequest | ✅ | Create new template |
Models\Template
Example Usage Code Snippet
list_templates
List templates- HTTP Method:
POST
- Endpoint:
/templates
Name | Type | Required | Description |
---|---|---|---|
input | Models\ListTemplatesRequest | ❌ | List templates |
Models\ListTemplatesResponse
Example Usage Code Snippet
get_template
Get template- HTTP Method:
GET
- Endpoint:
/template/{template_id}
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ |
Models\Template
Example Usage Code Snippet
delete_template
Delete template- HTTP Method:
DELETE
- Endpoint:
/template/{template_id}
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ |
mixed
Example Usage Code Snippet
duplicate_template
Duplicate template- HTTP Method:
POST
- Endpoint:
/template/{template_id}/duplicate
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ |
Models\Template
Example Usage Code Snippet
add_template_document
Add template document- HTTP Method:
POST
- Endpoint:
/template/{template_id}/document
Name | Type | Required | Description |
---|---|---|---|
input | Models\AddTemplateDocumentRequest | ✅ | Add template document |
$templateId | string | ✅ |
Models\Document
Example Usage Code Snippet
get_template_document
Get template document- HTTP Method:
GET
- Endpoint:
/template/{template_id}/document/{document_id}
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ | |
$documentId | string | ✅ |
Models\Document
Example Usage Code Snippet
get_template_documents
Get template documents- HTTP Method:
GET
- Endpoint:
/template/{template_id}/documents
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ |
Models\ListTemplateDocumentsResponse
Example Usage Code Snippet
add_template_signing_steps
Add template signing steps- HTTP Method:
POST
- Endpoint:
/template/{template_id}/signing_steps
Name | Type | Required | Description |
---|---|---|---|
input | Models\AddTemplateSigningStepsRequest | ✅ | Add template signing steps |
$templateId | string | ✅ |
Models\Template
Example Usage Code Snippet
rename_template
Rename template- HTTP Method:
PUT
- Endpoint:
/template/{template_id}/rename
Name | Type | Required | Description |
---|---|---|---|
input | Models\RenameTemplateRequest | ✅ | Rename template |
$templateId | string | ✅ |
Models\Template
Example Usage Code Snippet
set_template_comment
Set template comment- HTTP Method:
PUT
- Endpoint:
/template/{template_id}/set_comment
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetTemplateCommentRequest | ✅ | Set template comment |
$templateId | string | ✅ |
Models\Template
Example Usage Code Snippet
set_template_notification
Set template notification- HTTP Method:
PUT
- Endpoint:
/template/{template_id}/set_notification
Name | Type | Required | Description |
---|---|---|---|
input | Models\EnvelopeNotification | ✅ | Set template notification |
$templateId | string | ✅ |
Models\Template
Example Usage Code Snippet
get_template_annotations
Get template annotations- HTTP Method:
GET
- Endpoint:
/template/{template_id}/annotations
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ | ID of the template |
Models\ListTemplateAnnotationsResponse
Example Usage Code Snippet
get_document_template_annotations
Get document template annotations- HTTP Method:
GET
- Endpoint:
/template/{template_id}/annotations/{document_id}
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ | ID of the template |
$documentId | string | ✅ | ID of document |
Models\ListTemplateDocumentAnnotationsResponse
Example Usage Code Snippet
add_template_annotation
Add template annotation- HTTP Method:
POST
- Endpoint:
/template/{template_id}/annotation
Name | Type | Required | Description |
---|---|---|---|
input | Models\AddAnnotationRequest | ✅ | Add template annotation |
$templateId | string | ✅ | ID of the template |
Models\Annotation
Example Usage Code Snippet
delete_template_annotation
Delete template annotation- HTTP Method:
DELETE
- Endpoint:
/template/{template_id}/annotation/{annotation_id}
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ | ID of the template |
$annotationId | string | ✅ | ID of the annotation to delete |
mixed
Example Usage Code Snippet
set_template_attachments_settings
Set template attachment settings- HTTP Method:
PUT
- Endpoint:
/template/{template_id}/attachments/settings
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetEnvelopeAttachmentsSettingsRequest | ✅ | Set template attachment settings |
$templateId | string | ✅ |
Models\EnvelopeAttachments
Example Usage Code Snippet
set_template_attachments_placeholders
Placeholders to be set, completely replacing the existing ones.- HTTP Method:
PUT
- Endpoint:
/template/{template_id}/attachments/placeholders
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetEnvelopeAttachmentsPlaceholdersRequest | ✅ | Placeholders to be set, completely replacing the existing ones. |
$templateId | string | ✅ |
Models\EnvelopeAttachments
Example Usage Code Snippet
create_webhook
Create webhook- HTTP Method:
POST
- Endpoint:
/webhook
Name | Type | Required | Description |
---|---|---|---|
input | Models\CreateWebhookRequest | ✅ | Create webhook |
Models\Webhook
Example Usage Code Snippet
list_webhooks
List webhooks- HTTP Method:
POST
- Endpoint:
/webhooks
Name | Type | Required | Description |
---|---|---|---|
input | Models\ListWebhooksRequest | ❌ | List webhooks |
Models\ListWebhooksResponse
Example Usage Code Snippet
delete_webhook
Delete webhook- HTTP Method:
DELETE
- Endpoint:
/webhook/{webhook_id}
Name | Type | Required | Description |
---|---|---|---|
$webhookId | string | ✅ |
mixed
Example Usage Code Snippet
Models
SetEnvelopeAttachmentsPlaceholdersRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
placeholders | array | ✅ |
Document
PropertiesName | Type | Required | Description |
---|---|---|---|
id | string | ❌ | Unique identifier of the document |
name | string | ❌ | Name of the document |
filename | string | ❌ | Filename of the document |
pageCount | integer | ❌ | Number of pages in the document |
pages | array | ❌ | List of pages in the document |
CreateEnvelopeRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
name | string | ✅ | Name of the envelope |
legalityLevel | model | ✅ | 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 | integer | ❌ | Unix timestamp of the expiration date |
comment | string | ❌ | Comment for the envelope |
sandbox | boolean | ❌ | Whether the envelope is created in sandbox mode |
ListEnvelopesRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
name | string | ❌ | Name of the envelope |
tags | array | ❌ | List of tags |
comment | string | ❌ | Comment of the envelope |
ids | array | ❌ | List of envelope IDs |
statuses | array | ❌ | List of envelope statuses |
folderIds | array | ❌ | List of folder IDs |
onlyRootFolder | boolean | ❌ | Whether to only list envelopes in the root folder |
dateFrom | integer | ❌ | Unix timestamp of the start date |
dateTo | integer | ❌ | Unix timestamp of the end date |
uid | string | ❌ | Unique identifier of the user |
first | integer | ❌ | |
last | integer | ❌ | |
after | string | ❌ | |
before | string | ❌ | |
orderField | model | ❌ | Field to order envelopes by |
ascending | boolean | ❌ | Whether to order envelopes in ascending order |
includeTrash | boolean | ❌ | Whether to include envelopes in the trash |
AttachmentPlaceholder
PropertiesName | Type | Required | Description |
---|---|---|---|
recipientId | string | ❌ | ID of the recipient |
id | string | ❌ | ID of the attachment placeholder |
name | string | ❌ | Name of the attachment placeholder |
hint | string | ❌ | Hint of the attachment placeholder |
required | boolean | ❌ | Whether the attachment placeholder is required |
multiple | boolean | ❌ | Whether the attachment placeholder can have multiple files |
files | array | ❌ |
SetEnvelopeAttachmentsSettingsRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
settings | model | ✅ |
EnvelopeNotification
PropertiesName | Type | Required | Description |
---|---|---|---|
subject | string | ❌ | Subject of the notification |
message | string | ❌ | Message of the notification |
reminderInterval | integer | ❌ | Interval in days to send reminder |
ListTemplatesRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
name | string | ❌ | Name of the template |
tags | array | ❌ | List of tag templates |
ids | array | ❌ | List of templates IDs |
first | integer | ❌ | |
last | integer | ❌ | |
after | string | ❌ | |
before | string | ❌ | |
orderField | model | ❌ | Field to order templates by |
ascending | boolean | ❌ | Whether to order templates in ascending order |
SetTemplateCommentRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
comment | string | ✅ | Comment for the template |
Template
PropertiesName | Type | Required | Description |
---|---|---|---|
id | string | ❌ | Unique identifier of the template |
name | string | ❌ | Name of the template |
comment | string | ❌ | Comment for the template |
pages | integer | ❌ | Total number of pages in the template |
legalityLevel | model | ❌ | 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 | integer | ❌ | Unix timestamp of the creation date |
updatedAt | integer | ❌ | Unix timestamp of the last modification date |
expirationDelay | integer | ❌ | Expiration delay added to the current time when an envelope is created from this template |
numRecipients | integer | ❌ | Number of recipients in the envelope |
signingSteps | array | ❌ | |
documents | array | ❌ | |
notification | model | ❌ | |
dynamicFields | array | ❌ | List of dynamic fields |
attachments | model | ❌ |
RecipientVerificationType
Type of verification the recipient must complete before accessing the envelope. -PASSCODE
: requires a code to be entered. - SMS
: sends a code via SMS. - ID_VERIFICATION
: prompts the recipient to complete an automated ID and selfie check.
Properties
Name | Type | Required | Description |
---|---|---|---|
Sms | string | SMS | |
Passcode | string | PASSCODE | |
IdVerification | string | ID_VERIFICATION |
AddEnvelopeSigningStepsRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
signingSteps | array | ❌ | List of signing steps |
AnnotationFontFamily
Font family of the text PropertiesName | Type | Required | Description |
---|---|---|---|
Unknown | string | UNKNOWN | |
Serif | string | SERIF | |
Sans | string | SANS | |
Mono | string | MONO |
AddTemplateSigningStepsRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
signingSteps | array | ✅ | List of signing steps |
SetEnvelopeCommentRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
comment | string | ✅ | Comment for the envelope |
TemplateOrderField
Field to order templates by PropertiesName | Type | Required | Description |
---|---|---|---|
TemplateId | string | TEMPLATE_ID | |
TemplateCreationDate | string | TEMPLATE_CREATION_DATE | |
TemplateModificationDate | string | TEMPLATE_MODIFICATION_DATE | |
TemplateName | string | TEMPLATE_NAME |
EnvelopeOrderField
Field to order envelopes by PropertiesName | Type | Required | Description |
---|---|---|---|
CreationDate | string | CREATION_DATE | |
ModificationDate | string | MODIFICATION_DATE | |
Name | string | NAME | |
Status | string | STATUS | |
LastDocumentChange | string | LAST_DOCUMENT_CHANGE |
AddEnvelopeDocumentRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
file | binary | ❌ | File to upload in binary format |
ListWebhooksRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
webhookId | string | ❌ | ID of the webhook |
event | model | ❌ | Event of the webhook |
SetEnvelopeLegalityLevelRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
legalityLevel | model | ❌ | Legal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes) |
AttachmentPlaceholderFile
PropertiesName | Type | Required | Description |
---|---|---|---|
id | string | ❌ | ID of the file |
name | string | ❌ | Name of the file |
size | integer | ❌ | Size of the file in bytes |
mimetype | string | ❌ | MIME type of the file |
SetEnvelopeExpirationRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
expiresAt | integer | ✅ | Unix timestamp of the expiration date |
AnnotationText
Text annotation (null if annotation is not a text) PropertiesName | Type | Required | Description |
---|---|---|---|
size | number | ❌ | Font size of the text in pt |
color | number | ❌ | 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 | model | ❌ |
AnnotationCheckbox
Checkbox annotation (null if annotation is not a checkbox) PropertiesName | Type | Required | Description |
---|---|---|---|
checked | boolean | ❌ | Whether the checkbox is checked |
style | model | ❌ | Style of the checkbox |
Envelope
PropertiesName | Type | Required | Description |
---|---|---|---|
id | string | ❌ | Unique identifier of the envelope |
name | string | ❌ | Name of the envelope |
comment | string | ❌ | Comment for the envelope |
pages | integer | ❌ | Total number of pages in the envelope |
flowType | model | ❌ | Flow type of the envelope (REQUEST_SIGNATURE is a request for signature, SIGN_MYSELF is a self-signing flow) |
legalityLevel | model | ❌ | 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 | model | ❌ | Status of the envelope |
createdAt | integer | ❌ | Unix timestamp of the creation date |
updatedAt | integer | ❌ | Unix timestamp of the last modification date |
expiresAt | integer | ❌ | Unix timestamp of the expiration date |
numRecipients | integer | ❌ | Number of recipients in the envelope |
isDuplicable | boolean | ❌ | Whether the envelope can be duplicated |
signingSteps | array | ❌ | |
documents | array | ❌ | |
notification | model | ❌ | |
attachments | model | ❌ |
AddTemplateDocumentRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
file | binary | ✅ | File to upload in binary format |
TemplateRecipient
PropertiesName | 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 | model | ❌ | 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
PropertiesName | Type | Required | Description |
---|---|---|---|
documentId | string | ✅ | ID of the document |
page | integer | ✅ | Page number where the annotation is placed |
x | number | ✅ | X coordinate of the annotation (in % of the page width from 0 to 100) from the top left corner |
y | number | ✅ | Y coordinate of the annotation (in % of the page height from 0 to 100) from the top left corner |
width | number | ✅ | Width of the annotation (in % of the page width from 0 to 100) |
height | number | ✅ | Height of the annotation (in % of the page height from 0 to 100) |
type | model | ✅ | Type of the annotation |
recipientId | string | ❌ | ID of the recipient |
required | boolean | ❌ | |
signature | model | ❌ | Signature annotation (null if annotation is not a signature) |
initials | model | ❌ | Initials annotation (null if annotation is not initials) |
text | model | ❌ | Text annotation (null if annotation is not a text) |
datetime | model | ❌ | Date annotation (null if annotation is not a date) |
checkbox | model | ❌ | Checkbox annotation (null if annotation is not a checkbox) |
ListEnvelopeDocumentAnnotationsResponse
PropertiesName | Type | Required | Description |
---|---|---|---|
annotations | array | ❌ |
EnvelopeStatus
Status of the envelope PropertiesName | Type | Required | Description |
---|---|---|---|
Draft | string | DRAFT | |
InProgress | string | IN_PROGRESS | |
Completed | string | COMPLETED | |
Expired | string | EXPIRED | |
Declined | string | DECLINED | |
Voided | string | VOIDED | |
Pending | string | PENDING |
RecipientVerification
PropertiesName | Type | Required | Description |
---|---|---|---|
type | model | ❌ | Type of verification the recipient must complete before accessing the envelope. - PASSCODE : requires a code to be entered. - SMS : sends a code via SMS. - ID_VERIFICATION : prompts the recipient to complete an automated ID and selfie check. |
value | string | ❌ | Required for PASSCODE and SMS verification. - PASSCODE : code required by the recipient to sign the document. - SMS : recipient’s phone number. - ID_VERIFICATION : leave empty. |
AnnotationCheckboxStyle
Style of the checkbox PropertiesName | Type | Required | Description |
---|---|---|---|
CircleCheck | string | CIRCLE_CHECK | |
CircleFull | string | CIRCLE_FULL | |
SquareCheck | string | SQUARE_CHECK | |
SquareFull | string | SQUARE_FULL | |
CheckMark | string | CHECK_MARK | |
TimesSquare | string | TIMES_SQUARE |
SigningStep
PropertiesName | Type | Required | Description |
---|---|---|---|
recipients | array | ❌ | List of recipients |
AnnotationDateTime
Date annotation (null if annotation is not a date) PropertiesName | Type | Required | Description |
---|---|---|---|
size | number | ❌ | Font size of the text in pt |
font | model | ❌ | |
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 | integer | ❌ | Unix timestamp of the date |
format | model | ❌ | 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) |
AttachmentSettings
PropertiesName | Type | Required | Description |
---|---|---|---|
visibleToRecipients | boolean | ❌ | Whether the attachment is visible to the recipients |
CreateTemplateRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
name | string | ✅ |
ListTemplateDocumentsResponse
PropertiesName | Type | Required | Description |
---|---|---|---|
documents | array | ❌ |
AnnotationInitials
Initials annotation (null if annotation is not initials) PropertiesName | Type | Required | Description |
---|---|---|---|
id | string | ❌ | Unique identifier of the annotation initials |
AnnotationFont
PropertiesName | Type | Required | Description |
---|---|---|---|
family | model | ❌ | Font family of the text |
italic | boolean | ❌ | Whether the text is italic |
bold | boolean | ❌ | Whether the text is bold |
AnnotationType
Type of the annotation PropertiesName | Type | Required | Description |
---|---|---|---|
Text | string | TEXT | |
Signature | string | SIGNATURE | |
Initials | string | INITIALS | |
Checkbox | string | CHECKBOX | |
Date | string | DATE |
Webhook
PropertiesName | Type | Required | Description |
---|---|---|---|
id | string | ❌ | Unique identifier of the webhook |
event | model | ❌ | Event of the webhook |
target | string | ❌ | Target URL of the webhook |
RenameTemplateRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
name | string | ✅ | Name of the template |
ListTemplatesResponse
PropertiesName | Type | Required | Description |
---|---|---|---|
hasNextPage | boolean | ❌ | Whether there is a next page |
hasPreviousPage | boolean | ❌ | Whether there is a previous page |
templates | array | ❌ |
EnvelopeAttachments
PropertiesName | Type | Required | Description |
---|---|---|---|
settings | model | ❌ | |
recipients | array | ❌ |
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) PropertiesName | Type | Required | Description |
---|---|---|---|
Signer | string | SIGNER | |
ReceivesCopy | string | RECEIVES_COPY | |
InPersonSigner | string | IN_PERSON_SIGNER |
Annotation
PropertiesName | Type | Required | Description |
---|---|---|---|
id | string | ❌ | Unique identifier of the annotation |
recipientId | string | ❌ | ID of the recipient |
documentId | string | ❌ | ID of the document |
page | integer | ❌ | Page number where the annotation is placed |
x | number | ❌ | X coordinate of the annotation (in % of the page width from 0 to 100) from the top left corner |
y | number | ❌ | Y coordinate of the annotation (in % of the page height from 0 to 100) from the top left corner |
width | number | ❌ | Width of the annotation (in % of the page width from 0 to 100) |
height | number | ❌ | Height of the annotation (in % of the page height from 0 to 100) |
required | boolean | ❌ | Whether the annotation is required |
type | model | ❌ | Type of the annotation |
signature | model | ❌ | Signature annotation (null if annotation is not a signature) |
initials | model | ❌ | Initials annotation (null if annotation is not initials) |
text | model | ❌ | Text annotation (null if annotation is not a text) |
datetime | model | ❌ | Date annotation (null if annotation is not a date) |
checkbox | model | ❌ | Checkbox annotation (null if annotation is not a checkbox) |
DynamicField
PropertiesName | 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) PropertiesName | Type | Required | Description |
---|---|---|---|
DmyNumericSlash | string | DMY_NUMERIC_SLASH | |
MdyNumericSlash | string | MDY_NUMERIC_SLASH | |
YmdNumericSlash | string | YMD_NUMERIC_SLASH | |
DmyNumericDashShort | string | DMY_NUMERIC_DASH_SHORT | |
DmyNumericDash | string | DMY_NUMERIC_DASH | |
YmdNumericDash | string | YMD_NUMERIC_DASH | |
MdyTextDashShort | string | MDY_TEXT_DASH_SHORT | |
MdyTextSpaceShort | string | MDY_TEXT_SPACE_SHORT | |
MdyTextSpace | string | MDY_TEXT_SPACE |
EnvelopeFlowType
Flow type of the envelope (REQUEST_SIGNATURE is a request for signature, SIGN_MYSELF is a self-signing flow) PropertiesName | Type | Required | Description |
---|---|---|---|
RequestSignature | string | REQUEST_SIGNATURE | |
SignMyself | 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) PropertiesName | Type | Required | Description |
---|---|---|---|
Ses | string | SES | |
QesEidas | string | QES_EIDAS | |
QesZertes | 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) PropertiesName | Type | Required | Description |
---|---|---|---|
Signer | string | SIGNER | |
ReceivesCopy | string | RECEIVES_COPY | |
InPersonSigner | string | IN_PERSON_SIGNER | |
Sender | string | SENDER |
AttachmentPlaceholderRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
recipientId | string | ✅ | ID of the recipient |
name | string | ✅ | |
required | boolean | ✅ | Whether the attachment placeholder is required |
multiple | boolean | ✅ | |
id | string | ❌ | ID of the attachment placeholder |
hint | string | ❌ | Hint of the attachment placeholder |
SetEnvelopeDynamicFieldsRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
dynamicFields | array | ✅ | List of dynamic fields |
Page
PropertiesName | Type | Required | Description |
---|---|---|---|
width | integer | ❌ | Width of the page in pixels |
height | integer | ❌ | Height of the page in pixels |
TemplateSigningStep
PropertiesName | Type | Required | Description |
---|---|---|---|
recipients | array | ❌ | List of recipients |
AttachmentPlaceholdersPerRecipient
PropertiesName | Type | Required | Description |
---|---|---|---|
recipientId | string | ❌ | ID of the recipient |
recipientName | string | ❌ | Name of the recipient |
placeholders | array | ❌ |
ListEnvelopesResponse
PropertiesName | Type | Required | Description |
---|---|---|---|
hasNextPage | boolean | ❌ | Whether there is a next page |
hasPreviousPage | boolean | ❌ | Whether there is a previous page |
envelopes | array | ❌ |
Recipient
PropertiesName | Type | Required | Description |
---|---|---|---|
name | string | ✅ | Name of the recipient |
string | ✅ | Email of the recipient | |
role | model | ✅ | 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 | model | ❌ |
WebhookEvent
Event of the webhook PropertiesName | Type | Required | Description |
---|---|---|---|
EnvelopeExpired | string | ENVELOPE_EXPIRED | |
EnvelopeDeclined | string | ENVELOPE_DECLINED | |
EnvelopeVoided | string | ENVELOPE_VOIDED | |
EnvelopeCompleted | string | ENVELOPE_COMPLETED | |
EnvelopeAuditTrail | string | ENVELOPE_AUDIT_TRAIL |
CreateWebhookRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
event | model | ✅ | Event of the webhook |
target | string | ✅ | URL of the webhook target |
CreateEnvelopeFromTemplateRequest
PropertiesName | 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
PropertiesName | Type | Required | Description |
---|---|---|---|
annotations | array | ❌ |
RenameEnvelopeRequest
PropertiesName | Type | Required | Description |
---|---|---|---|
name | string | ❌ | Name of the envelope |
ListTemplateDocumentAnnotationsResponse
PropertiesName | Type | Required | Description |
---|---|---|---|
annotations | array | ❌ |
ListEnvelopeDocumentsResponse
PropertiesName | Type | Required | Description |
---|---|---|---|
documents | array | ❌ |
ListWebhooksResponse
PropertiesName | Type | Required | Description |
---|---|---|---|
webhooks | array | ❌ |
AnnotationSignature
Signature annotation (null if annotation is not a signature) PropertiesName | Type | Required | Description |
---|---|---|---|
id | string | ❌ | Unique identifier of the annotation signature |