SignplusService service. Click on the method name to view detailed information about that method.
CreateEnvelopeAsync
Create new envelope- HTTP Method:
POST - Endpoint:
/envelope
| Name | Type | Required | Description |
|---|---|---|---|
| input | CreateEnvelopeRequest | ✅ | The request body. |
Envelope
Example Usage Code Snippet
CreateEnvelopeFromTemplateAsync
Create new envelope from template- HTTP Method:
POST - Endpoint:
/envelope/from_template/{template_id}
| Name | Type | Required | Description |
|---|---|---|---|
| input | CreateEnvelopeFromTemplateRequest | ✅ | The request body. |
| templateId | string | ✅ |
Envelope
Example Usage Code Snippet
ListEnvelopesAsync
List envelopes- HTTP Method:
POST - Endpoint:
/envelopes
| Name | Type | Required | Description |
|---|---|---|---|
| input | ListEnvelopesRequest | ❌ | The request body. |
ListEnvelopesResponse
Example Usage Code Snippet
GetEnvelopeAsync
Get envelope- HTTP Method:
GET - Endpoint:
/envelope/{envelope_id}
| Name | Type | Required | Description |
|---|---|---|---|
| envelopeId | string | ✅ |
Envelope
Example Usage Code Snippet
DeleteEnvelopeAsync
Delete envelope- HTTP Method:
DELETE - Endpoint:
/envelope/{envelope_id}
| Name | Type | Required | Description |
|---|---|---|---|
| envelopeId | string | ✅ |
DownloadEnvelopeSignedDocumentsAsync
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 |
byte[]
Example Usage Code Snippet
DownloadEnvelopeCertificateAsync
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 |
byte[]
Example Usage Code Snippet
GetEnvelopeDocumentAsync
Get envelope document- HTTP Method:
GET - Endpoint:
/envelope/{envelope_id}/document/{document_id}
| Name | Type | Required | Description |
|---|---|---|---|
| envelopeId | string | ✅ | |
| documentId | string | ✅ |
Document
Example Usage Code Snippet
GetEnvelopeDocumentsAsync
Get envelope documents- HTTP Method:
GET - Endpoint:
/envelope/{envelope_id}/documents
| Name | Type | Required | Description |
|---|---|---|---|
| envelopeId | string | ✅ |
ListEnvelopeDocumentsResponse
Example Usage Code Snippet
AddEnvelopeDocumentAsync
Add envelope document- HTTP Method:
POST - Endpoint:
/envelope/{envelope_id}/document
| Name | Type | Required | Description |
|---|---|---|---|
| input | AddEnvelopeDocumentRequest | ✅ | The request body. |
| envelopeId | string | ✅ |
Document
Example Usage Code Snippet
SetEnvelopeDynamicFieldsAsync
Set envelope dynamic fields- HTTP Method:
PUT - Endpoint:
/envelope/{envelope_id}/dynamic_fields
| Name | Type | Required | Description |
|---|---|---|---|
| input | SetEnvelopeDynamicFieldsRequest | ✅ | The request body. |
| envelopeId | string | ✅ |
Envelope
Example Usage Code Snippet
AddEnvelopeSigningStepsAsync
Add envelope signing steps- HTTP Method:
POST - Endpoint:
/envelope/{envelope_id}/signing_steps
| Name | Type | Required | Description |
|---|---|---|---|
| input | AddEnvelopeSigningStepsRequest | ✅ | The request body. |
| envelopeId | string | ✅ |
Envelope
Example Usage Code Snippet
SetEnvelopeAttachmentsSettingsAsync
Set envelope attachment settings- HTTP Method:
PUT - Endpoint:
/envelope/{envelope_id}/attachments/settings
| Name | Type | Required | Description |
|---|---|---|---|
| input | SetEnvelopeAttachmentsSettingsRequest | ✅ | The request body. |
| envelopeId | string | ✅ |
EnvelopeAttachments
Example Usage Code Snippet
SetEnvelopeAttachmentsPlaceholdersAsync
Placeholders to be set, completely replacing the existing ones.- HTTP Method:
PUT - Endpoint:
/envelope/{envelope_id}/attachments/placeholders
| Name | Type | Required | Description |
|---|---|---|---|
| input | SetEnvelopeAttachmentsPlaceholdersRequest | ✅ | The request body. |
| envelopeId | string | ✅ |
EnvelopeAttachments
Example Usage Code Snippet
GetAttachmentFileAsync
Get envelope attachment file- HTTP Method:
GET - Endpoint:
/envelope/{envelope_id}/attachments/{file_id}
| Name | Type | Required | Description |
|---|---|---|---|
| envelopeId | string | ✅ | |
| fileId | string | ✅ |
byte[]
Example Usage Code Snippet
SendEnvelopeAsync
Send envelope for signature- HTTP Method:
POST - Endpoint:
/envelope/{envelope_id}/send
| Name | Type | Required | Description |
|---|---|---|---|
| envelopeId | string | ✅ |
Envelope
Example Usage Code Snippet
DuplicateEnvelopeAsync
Duplicate envelope- HTTP Method:
POST - Endpoint:
/envelope/{envelope_id}/duplicate
| Name | Type | Required | Description |
|---|---|---|---|
| envelopeId | string | ✅ |
Envelope
Example Usage Code Snippet
VoidEnvelopeAsync
Void envelope- HTTP Method:
PUT - Endpoint:
/envelope/{envelope_id}/void
| Name | Type | Required | Description |
|---|---|---|---|
| envelopeId | string | ✅ |
Envelope
Example Usage Code Snippet
RenameEnvelopeAsync
Rename envelope- HTTP Method:
PUT - Endpoint:
/envelope/{envelope_id}/rename
| Name | Type | Required | Description |
|---|---|---|---|
| input | RenameEnvelopeRequest | ✅ | The request body. |
| envelopeId | string | ✅ |
Envelope
Example Usage Code Snippet
SetEnvelopeCommentAsync
Set envelope comment- HTTP Method:
PUT - Endpoint:
/envelope/{envelope_id}/set_comment
| Name | Type | Required | Description |
|---|---|---|---|
| input | SetEnvelopeCommentRequest | ✅ | The request body. |
| envelopeId | string | ✅ |
Envelope
Example Usage Code Snippet
SetEnvelopeNotificationAsync
Set envelope notification- HTTP Method:
PUT - Endpoint:
/envelope/{envelope_id}/set_notification
| Name | Type | Required | Description |
|---|---|---|---|
| input | EnvelopeNotification | ✅ | The request body. |
| envelopeId | string | ✅ |
Envelope
Example Usage Code Snippet
SetEnvelopeExpirationDateAsync
Set envelope expiration date- HTTP Method:
PUT - Endpoint:
/envelope/{envelope_id}/set_expiration_date
| Name | Type | Required | Description |
|---|---|---|---|
| input | SetEnvelopeExpirationRequest | ✅ | The request body. |
| envelopeId | string | ✅ |
Envelope
Example Usage Code Snippet
SetEnvelopeLegalityLevelAsync
Set envelope legality level- HTTP Method:
PUT - Endpoint:
/envelope/{envelope_id}/set_legality_level
| Name | Type | Required | Description |
|---|---|---|---|
| input | SetEnvelopeLegalityLevelRequest | ✅ | The request body. |
| envelopeId | string | ✅ |
Envelope
Example Usage Code Snippet
GetEnvelopeAnnotationsAsync
Get envelope annotations- HTTP Method:
GET - Endpoint:
/envelope/{envelope_id}/annotations
| Name | Type | Required | Description |
|---|---|---|---|
| envelopeId | string | ✅ | ID of the envelope |
List<Annotation>
Example Usage Code Snippet
GetEnvelopeDocumentAnnotationsAsync
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 |
ListEnvelopeDocumentAnnotationsResponse
Example Usage Code Snippet
AddEnvelopeAnnotationAsync
Add envelope annotation- HTTP Method:
POST - Endpoint:
/envelope/{envelope_id}/annotation
| Name | Type | Required | Description |
|---|---|---|---|
| input | AddAnnotationRequest | ✅ | The request body. |
| envelopeId | string | ✅ | ID of the envelope |
Annotation
Example Usage Code Snippet
DeleteEnvelopeAnnotationAsync
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 |
CreateTemplateAsync
Create new template- HTTP Method:
POST - Endpoint:
/template
| Name | Type | Required | Description |
|---|---|---|---|
| input | CreateTemplateRequest | ✅ | The request body. |
Template
Example Usage Code Snippet
ListTemplatesAsync
List templates- HTTP Method:
POST - Endpoint:
/templates
| Name | Type | Required | Description |
|---|---|---|---|
| input | ListTemplatesRequest | ❌ | The request body. |
ListTemplatesResponse
Example Usage Code Snippet
GetTemplateAsync
Get template- HTTP Method:
GET - Endpoint:
/template/{template_id}
| Name | Type | Required | Description |
|---|---|---|---|
| templateId | string | ✅ |
Template
Example Usage Code Snippet
DeleteTemplateAsync
Delete template- HTTP Method:
DELETE - Endpoint:
/template/{template_id}
| Name | Type | Required | Description |
|---|---|---|---|
| templateId | string | ✅ |
DuplicateTemplateAsync
Duplicate template- HTTP Method:
POST - Endpoint:
/template/{template_id}/duplicate
| Name | Type | Required | Description |
|---|---|---|---|
| templateId | string | ✅ |
Template
Example Usage Code Snippet
AddTemplateDocumentAsync
Add template document- HTTP Method:
POST - Endpoint:
/template/{template_id}/document
| Name | Type | Required | Description |
|---|---|---|---|
| input | AddTemplateDocumentRequest | ✅ | The request body. |
| templateId | string | ✅ |
Document
Example Usage Code Snippet
GetTemplateDocumentAsync
Get template document- HTTP Method:
GET - Endpoint:
/template/{template_id}/document/{document_id}
| Name | Type | Required | Description |
|---|---|---|---|
| templateId | string | ✅ | |
| documentId | string | ✅ |
Document
Example Usage Code Snippet
GetTemplateDocumentsAsync
Get template documents- HTTP Method:
GET - Endpoint:
/template/{template_id}/documents
| Name | Type | Required | Description |
|---|---|---|---|
| templateId | string | ✅ |
ListTemplateDocumentsResponse
Example Usage Code Snippet
AddTemplateSigningStepsAsync
Add template signing steps- HTTP Method:
POST - Endpoint:
/template/{template_id}/signing_steps
| Name | Type | Required | Description |
|---|---|---|---|
| input | AddTemplateSigningStepsRequest | ✅ | The request body. |
| templateId | string | ✅ |
Template
Example Usage Code Snippet
RenameTemplateAsync
Rename template- HTTP Method:
PUT - Endpoint:
/template/{template_id}/rename
| Name | Type | Required | Description |
|---|---|---|---|
| input | RenameTemplateRequest | ✅ | The request body. |
| templateId | string | ✅ |
Template
Example Usage Code Snippet
SetTemplateCommentAsync
Set template comment- HTTP Method:
PUT - Endpoint:
/template/{template_id}/set_comment
| Name | Type | Required | Description |
|---|---|---|---|
| input | SetTemplateCommentRequest | ✅ | The request body. |
| templateId | string | ✅ |
Template
Example Usage Code Snippet
SetTemplateNotificationAsync
Set template notification- HTTP Method:
PUT - Endpoint:
/template/{template_id}/set_notification
| Name | Type | Required | Description |
|---|---|---|---|
| input | EnvelopeNotification | ✅ | The request body. |
| templateId | string | ✅ |
Template
Example Usage Code Snippet
GetTemplateAnnotationsAsync
Get template annotations- HTTP Method:
GET - Endpoint:
/template/{template_id}/annotations
| Name | Type | Required | Description |
|---|---|---|---|
| templateId | string | ✅ | ID of the template |
ListTemplateAnnotationsResponse
Example Usage Code Snippet
GetDocumentTemplateAnnotationsAsync
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 |
ListTemplateDocumentAnnotationsResponse
Example Usage Code Snippet
AddTemplateAnnotationAsync
Add template annotation- HTTP Method:
POST - Endpoint:
/template/{template_id}/annotation
| Name | Type | Required | Description |
|---|---|---|---|
| input | AddAnnotationRequest | ✅ | The request body. |
| templateId | string | ✅ | ID of the template |
Annotation
Example Usage Code Snippet
DeleteTemplateAnnotationAsync
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 |
SetTemplateAttachmentsSettingsAsync
Set template attachment settings- HTTP Method:
PUT - Endpoint:
/template/{template_id}/attachments/settings
| Name | Type | Required | Description |
|---|---|---|---|
| input | SetEnvelopeAttachmentsSettingsRequest | ✅ | The request body. |
| templateId | string | ✅ |
EnvelopeAttachments
Example Usage Code Snippet
SetTemplateAttachmentsPlaceholdersAsync
Placeholders to be set, completely replacing the existing ones.- HTTP Method:
PUT - Endpoint:
/template/{template_id}/attachments/placeholders
| Name | Type | Required | Description |
|---|---|---|---|
| input | SetEnvelopeAttachmentsPlaceholdersRequest | ✅ | The request body. |
| templateId | string | ✅ |
EnvelopeAttachments
Example Usage Code Snippet
CreateWebhookAsync
Create webhook- HTTP Method:
POST - Endpoint:
/webhook
| Name | Type | Required | Description |
|---|---|---|---|
| input | CreateWebhookRequest | ✅ | The request body. |
Webhook
Example Usage Code Snippet
ListWebhooksAsync
List webhooks- HTTP Method:
POST - Endpoint:
/webhooks
| Name | Type | Required | Description |
|---|---|---|---|
| input | ListWebhooksRequest | ❌ | The request body. |
ListWebhooksResponse
Example Usage Code Snippet
DeleteWebhookAsync
Delete webhook- HTTP Method:
DELETE - Endpoint:
/webhook/{webhook_id}
| Name | Type | Required | Description |
|---|---|---|---|
| webhookId | string | ✅ |
Models
SetEnvelopeAttachmentsPlaceholdersRequest
Properties| Name | Type | Required | Description |
|---|---|---|---|
| Placeholders | List<AttachmentPlaceholderRequest> | ✅ |
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 | bool | ❌ | 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 | bool | ❌ | 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 | bool | ❌ | Whether to order envelopes in ascending order |
| IncludeTrash | bool | ❌ | 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 | bool | ❌ | Whether the attachment placeholder is required |
| Multiple | bool | ❌ | Whether the attachment placeholder can have multiple files |
| Files | List<AttachmentPlaceholderFile> | ❌ |
SetEnvelopeAttachmentsSettingsRequest
Properties| Name | Type | Required | Description |
|---|---|---|---|
| Settings | AttachmentSettings | ✅ |
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 | bool | ❌ | 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 |
| Attachments | EnvelopeAttachments | ❌ |
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 | 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 |
|---|---|---|---|
| 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 | 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) |
AttachmentPlaceholderFile
Properties| Name | Type | Required | Description |
|---|---|---|---|
| Id | string | ❌ | ID of the file |
| Name | string | ❌ | Name of the file |
| Size | long | ❌ | Size of the file in bytes |
| Mimetype | string | ❌ | MIME type of the file |
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_ | bool | ❌ | 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 | bool | ❌ | Whether the envelope can be duplicated |
| SigningSteps | List<SigningStep> | ❌ | |
| Documents | List<Document> | ❌ | |
| Notification | EnvelopeNotification | ❌ | |
| Attachments | EnvelopeAttachments | ❌ |
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 | bool | ❌ | |
| 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” |
| 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_ | 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. |
| 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 | 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 | bool | ❌ | 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) |
AttachmentSettings
Properties| Name | Type | Required | Description |
|---|---|---|---|
| VisibleToRecipients | bool | ❌ | Whether the attachment is visible to the recipients |
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 | bool | ❌ | Whether the text is italic |
| Bold | bool | ❌ | 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 | bool | ❌ | Whether there is a next page |
| HasPreviousPage | bool | ❌ | Whether there is a previous page |
| Templates | List<Template> | ❌ |
EnvelopeAttachments
Properties| Name | Type | Required | Description |
|---|---|---|---|
| Settings | AttachmentSettings | ❌ | |
| Recipients | List<AttachmentPlaceholdersPerRecipient> | ❌ |
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 | 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 | bool | ❌ | 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 |
|---|---|---|---|
| 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 | bool | ✅ | Whether the attachment placeholder is required |
| Multiple | bool | ✅ | |
| Id | string | ❌ | ID of the attachment placeholder |
| Hint | string | ❌ | Hint of the attachment placeholder |
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 |
AttachmentPlaceholdersPerRecipient
Properties| Name | Type | Required | Description |
|---|---|---|---|
| RecipientId | string | ❌ | ID of the recipient |
| RecipientName | string | ❌ | Name of the recipient |
| Placeholders | List<AttachmentPlaceholder> | ❌ |
ListEnvelopesResponse
Properties| Name | Type | Required | Description |
|---|---|---|---|
| HasNextPage | bool | ❌ | Whether there is a next page |
| HasPreviousPage | bool | ❌ | 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 |
|---|---|---|---|
| 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_ | 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 | bool | ❌ | 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 |