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
Properties| Name | Type | Required | Description |
|---|---|---|---|
| placeholders | array | ✅ |
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 | integer | ❌ | Number of pages in the document |
| pages | array | ❌ | List of pages in the document |
CreateEnvelopeRequest
Properties| Name | 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
Properties| Name | 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
Properties| Name | 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
Properties| Name | Type | Required | Description |
|---|---|---|---|
| settings | model | ✅ |
EnvelopeNotification
Properties| Name | Type | Required | Description |
|---|---|---|---|
| subject | string | ❌ | Subject of the notification |
| message | string | ❌ | Message of the notification |
| reminderInterval | integer | ❌ | Interval in days to send reminder |
ListTemplatesRequest
Properties| Name | 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
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 | 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
Properties| Name | Type | Required | Description |
|---|---|---|---|
| signingSteps | array | ❌ | 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 | array | ✅ | 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 |
|---|---|---|---|
| TemplateId | string | TEMPLATE_ID | |
| TemplateCreationDate | string | TEMPLATE_CREATION_DATE | |
| TemplateModificationDate | string | TEMPLATE_MODIFICATION_DATE | |
| TemplateName | string | TEMPLATE_NAME |
EnvelopeOrderField
Field to order envelopes by Properties| Name | Type | Required | Description |
|---|---|---|---|
| CreationDate | string | CREATION_DATE | |
| ModificationDate | string | MODIFICATION_DATE | |
| Name | string | NAME | |
| Status | string | STATUS | |
| LastDocumentChange | string | LAST_DOCUMENT_CHANGE |
AddEnvelopeDocumentRequest
Properties| Name | Type | Required | Description |
|---|---|---|---|
| file | binary | ❌ | File to upload in binary format |
ListWebhooksRequest
Properties| Name | Type | Required | Description |
|---|---|---|---|
| webhookId | string | ❌ | ID of the webhook |
| event | model | ❌ | Event of the webhook |
SetEnvelopeLegalityLevelRequest
Properties| Name | 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
Properties| Name | 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
Properties| Name | Type | Required | Description |
|---|---|---|---|
| expiresAt | integer | ✅ | Unix timestamp of the expiration date |
AnnotationText
Text annotation (null if annotation is not a text) Properties| Name | 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) Properties| Name | Type | Required | Description |
|---|---|---|---|
| checked | boolean | ❌ | Whether the checkbox is checked |
| style | model | ❌ | 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 | 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
Properties| Name | Type | Required | Description |
|---|---|---|---|
| file | binary | ✅ | 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 | 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
Properties| Name | 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
Properties| Name | Type | Required | Description |
|---|---|---|---|
| annotations | array | ❌ |
EnvelopeStatus
Status of the envelope Properties| Name | 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
Properties| Name | 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 Properties| Name | 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
Properties| Name | Type | Required | Description |
|---|---|---|---|
| recipients | array | ❌ | List of recipients |
AnnotationDateTime
Date annotation (null if annotation is not a date) Properties| Name | 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
Properties| Name | Type | Required | Description |
|---|---|---|---|
| visibleToRecipients | boolean | ❌ | Whether the attachment is visible to the recipients |
CreateTemplateRequest
Properties| Name | Type | Required | Description |
|---|---|---|---|
| name | string | ✅ |
ListTemplateDocumentsResponse
Properties| Name | Type | Required | Description |
|---|---|---|---|
| documents | array | ❌ |
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 | 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 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 | model | ❌ | 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 | array | ❌ |
EnvelopeAttachments
Properties| Name | 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) Properties| Name | Type | Required | Description |
|---|---|---|---|
| Signer | string | SIGNER | |
| ReceivesCopy | string | RECEIVES_COPY | |
| InPersonSigner | 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 | 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
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 |
|---|---|---|---|
| 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) Properties| Name | 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) Properties| Name | 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) Properties| Name | Type | Required | Description |
|---|---|---|---|
| Signer | string | SIGNER | |
| ReceivesCopy | string | RECEIVES_COPY | |
| InPersonSigner | string | IN_PERSON_SIGNER | |
| Sender | string | SENDER |
AttachmentPlaceholderRequest
Properties| Name | 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
Properties| Name | Type | Required | Description |
|---|---|---|---|
| dynamicFields | array | ✅ | List of dynamic fields |
Page
Properties| Name | Type | Required | Description |
|---|---|---|---|
| width | integer | ❌ | Width of the page in pixels |
| height | integer | ❌ | Height of the page in pixels |
TemplateSigningStep
Properties| Name | Type | Required | Description |
|---|---|---|---|
| recipients | array | ❌ | List of recipients |
AttachmentPlaceholdersPerRecipient
Properties| Name | Type | Required | Description |
|---|---|---|---|
| recipientId | string | ❌ | ID of the recipient |
| recipientName | string | ❌ | Name of the recipient |
| placeholders | array | ❌ |
ListEnvelopesResponse
Properties| Name | Type | Required | Description |
|---|---|---|---|
| hasNextPage | boolean | ❌ | Whether there is a next page |
| hasPreviousPage | boolean | ❌ | Whether there is a previous page |
| envelopes | array | ❌ |
Recipient
Properties| Name | 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 Properties| Name | 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
Properties| Name | Type | Required | Description |
|---|---|---|---|
| event | model | ✅ | 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 | array | ❌ |
RenameEnvelopeRequest
Properties| Name | Type | Required | Description |
|---|---|---|---|
| name | string | ❌ | Name of the envelope |
ListTemplateDocumentAnnotationsResponse
Properties| Name | Type | Required | Description |
|---|---|---|---|
| annotations | array | ❌ |
ListEnvelopeDocumentsResponse
Properties| Name | Type | Required | Description |
|---|---|---|---|
| documents | array | ❌ |
ListWebhooksResponse
Properties| Name | Type | Required | Description |
|---|---|---|---|
| webhooks | array | ❌ |
AnnotationSignature
Signature annotation (null if annotation is not a signature) Properties| Name | Type | Required | Description |
|---|---|---|---|
| id | string | ❌ | Unique identifier of the annotation signature |