Sdk reference
A list of all methods in the 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 |
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 |
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 |
create_webhook | Create webhook |
list_webhooks | List webhooks |
delete_webhook | Delete webhook |
create_envelope
Create new envelope
- HTTP Method:
POST
- Endpoint:
/envelope
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\CreateEnvelopeRequest | ✅ | Create new envelope |
Return Type
Models\Envelope
Example Usage Code Snippet
create_envelope_from_template
Create new envelope from template
- HTTP Method:
POST
- Endpoint:
/envelope/from_template/{template_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\CreateEnvelopeFromTemplateRequest | ✅ | Create new envelope from template |
$templateId | string | ✅ |
Return Type
Models\Envelope
Example Usage Code Snippet
list_envelopes
List envelopes
- HTTP Method:
POST
- Endpoint:
/envelopes
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\ListEnvelopesRequest | ❌ | List envelopes |
Return Type
Models\ListEnvelopesResponse
Example Usage Code Snippet
get_envelope
Get envelope
- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ |
Return Type
Models\Envelope
Example Usage Code Snippet
delete_envelope
Delete envelope
- HTTP Method:
DELETE
- Endpoint:
/envelope/{envelope_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ |
Return Type
mixed
Example Usage Code Snippet
get_envelope_document
Get envelope document
- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/document/{document_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ | |
$documentId | string | ✅ |
Return Type
Models\Document
Example Usage Code Snippet
get_envelope_documents
Get envelope documents
- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/documents
Parameters
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ |
Return Type
Models\ListEnvelopeDocumentsResponse
Example Usage Code Snippet
add_envelope_document
Add envelope document
- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/document
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\AddEnvelopeDocumentRequest | ✅ | Add envelope document |
$envelopeId | string | ✅ |
Return Type
Models\Document
Example Usage Code Snippet
set_envelope_dynamic_fields
Set envelope dynamic fields
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/dynamic_fields
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetEnvelopeDynamicFieldsRequest | ✅ | Set envelope dynamic fields |
$envelopeId | string | ✅ |
Return Type
Models\Envelope
Example Usage Code Snippet
add_envelope_signing_steps
Add envelope signing steps
- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/signing_steps
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\AddEnvelopeSigningStepsRequest | ✅ | Add envelope signing steps |
$envelopeId | string | ✅ |
Return Type
Models\Envelope
Example Usage Code Snippet
send_envelope
Send envelope for signature
- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/send
Parameters
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ |
Return Type
Models\Envelope
Example Usage Code Snippet
duplicate_envelope
Duplicate envelope
- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/duplicate
Parameters
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ |
Return Type
Models\Envelope
Example Usage Code Snippet
void_envelope
Void envelope
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/void
Parameters
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ |
Return Type
Models\Envelope
Example Usage Code Snippet
rename_envelope
Rename envelope
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/rename
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\RenameEnvelopeRequest | ✅ | Rename envelope |
$envelopeId | string | ✅ |
Return Type
Models\Envelope
Example Usage Code Snippet
set_envelope_comment
Set envelope comment
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/set_comment
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetEnvelopeCommentRequest | ✅ | Set envelope comment |
$envelopeId | string | ✅ |
Return Type
Models\Envelope
Example Usage Code Snippet
set_envelope_notification
Set envelope notification
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/set_notification
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\EnvelopeNotification | ✅ | Set envelope notification |
$envelopeId | string | ✅ |
Return Type
Models\Envelope
Example Usage Code Snippet
set_envelope_expiration_date
Set envelope expiration date
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/set_expiration_date
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetEnvelopeExpirationRequest | ✅ | Set envelope expiration date |
$envelopeId | string | ✅ |
Return Type
Models\Envelope
Example Usage Code Snippet
set_envelope_legality_level
Set envelope legality level
- HTTP Method:
PUT
- Endpoint:
/envelope/{envelope_id}/set_legality_level
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetEnvelopeLegalityLevelRequest | ✅ | Set envelope legality level |
$envelopeId | string | ✅ |
Return Type
Models\Envelope
Example Usage Code Snippet
get_envelope_annotations
Get envelope annotations
- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/annotations
Parameters
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ | ID of the envelope |
Return Type
array
Example Usage Code Snippet
get_envelope_document_annotations
Get envelope document annotations
- HTTP Method:
GET
- Endpoint:
/envelope/{envelope_id}/annotations/{document_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ | ID of the envelope |
$documentId | string | ✅ | ID of document |
Return Type
Models\ListEnvelopeDocumentAnnotationsResponse
Example Usage Code Snippet
add_envelope_annotation
Add envelope annotation
- HTTP Method:
POST
- Endpoint:
/envelope/{envelope_id}/annotation
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\AddAnnotationRequest | ✅ | Add envelope annotation |
$envelopeId | string | ✅ | ID of the envelope |
Return Type
Models\Annotation
Example Usage Code Snippet
delete_envelope_annotation
Delete envelope annotation
- HTTP Method:
DELETE
- Endpoint:
/envelope/{envelope_id}/annotation/{annotation_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
$envelopeId | string | ✅ | ID of the envelope |
$annotationId | string | ✅ | ID of the annotation to delete |
Return Type
mixed
Example Usage Code Snippet
create_template
Create new template
- HTTP Method:
POST
- Endpoint:
/template
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\CreateTemplateRequest | ✅ | Create new template |
Return Type
Models\Template
Example Usage Code Snippet
list_templates
List templates
- HTTP Method:
POST
- Endpoint:
/templates
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\ListTemplatesRequest | ❌ | List templates |
Return Type
Models\ListTemplatesResponse
Example Usage Code Snippet
get_template
Get template
- HTTP Method:
GET
- Endpoint:
/template/{template_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ |
Return Type
Models\Template
Example Usage Code Snippet
delete_template
Delete template
- HTTP Method:
DELETE
- Endpoint:
/template/{template_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ |
Return Type
mixed
Example Usage Code Snippet
duplicate_template
Duplicate template
- HTTP Method:
POST
- Endpoint:
/template/{template_id}/duplicate
Parameters
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ |
Return Type
Models\Template
Example Usage Code Snippet
add_template_document
Add template document
- HTTP Method:
POST
- Endpoint:
/template/{template_id}/document
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\AddTemplateDocumentRequest | ✅ | Add template document |
$templateId | string | ✅ |
Return Type
Models\Document
Example Usage Code Snippet
get_template_document
Get template document
- HTTP Method:
GET
- Endpoint:
/template/{template_id}/document/{document_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ | |
$documentId | string | ✅ |
Return Type
Models\Document
Example Usage Code Snippet
get_template_documents
Get template documents
- HTTP Method:
GET
- Endpoint:
/template/{template_id}/documents
Parameters
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ |
Return Type
Models\ListTemplateDocumentsResponse
Example Usage Code Snippet
add_template_signing_steps
Add template signing steps
- HTTP Method:
POST
- Endpoint:
/template/{template_id}/signing_steps
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\AddTemplateSigningStepsRequest | ✅ | Add template signing steps |
$templateId | string | ✅ |
Return Type
Models\Template
Example Usage Code Snippet
rename_template
Rename template
- HTTP Method:
PUT
- Endpoint:
/template/{template_id}/rename
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\RenameTemplateRequest | ✅ | Rename template |
$templateId | string | ✅ |
Return Type
Models\Template
Example Usage Code Snippet
set_template_comment
Set template comment
- HTTP Method:
PUT
- Endpoint:
/template/{template_id}/set_comment
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\SetTemplateCommentRequest | ✅ | Set template comment |
$templateId | string | ✅ |
Return Type
Models\Template
Example Usage Code Snippet
set_template_notification
Set template notification
- HTTP Method:
PUT
- Endpoint:
/template/{template_id}/set_notification
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\EnvelopeNotification | ✅ | Set template notification |
$templateId | string | ✅ |
Return Type
Models\Template
Example Usage Code Snippet
get_template_annotations
Get template annotations
- HTTP Method:
GET
- Endpoint:
/template/{template_id}/annotations
Parameters
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ | ID of the template |
Return Type
Models\ListTemplateAnnotationsResponse
Example Usage Code Snippet
get_document_template_annotations
Get document template annotations
- HTTP Method:
GET
- Endpoint:
/template/{template_id}/annotations/{document_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ | ID of the template |
$documentId | string | ✅ | ID of document |
Return Type
Models\ListTemplateDocumentAnnotationsResponse
Example Usage Code Snippet
add_template_annotation
Add template annotation
- HTTP Method:
POST
- Endpoint:
/template/{template_id}/annotation
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\AddAnnotationRequest | ✅ | Add template annotation |
$templateId | string | ✅ | ID of the template |
Return Type
Models\Annotation
Example Usage Code Snippet
delete_template_annotation
Delete template annotation
- HTTP Method:
DELETE
- Endpoint:
/template/{template_id}/annotation/{annotation_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
$templateId | string | ✅ | ID of the template |
$annotationId | string | ✅ | ID of the annotation to delete |
Return Type
mixed
Example Usage Code Snippet
create_webhook
Create webhook
- HTTP Method:
POST
- Endpoint:
/webhook
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\CreateWebhookRequest | ✅ | Create webhook |
Return Type
Models\Webhook
Example Usage Code Snippet
list_webhooks
List webhooks
- HTTP Method:
POST
- Endpoint:
/webhooks
Parameters
Name | Type | Required | Description |
---|---|---|---|
input | Models\ListWebhooksRequest | ❌ | List webhooks |
Return Type
Models\ListWebhooksResponse
Example Usage Code Snippet
delete_webhook
Delete webhook
- HTTP Method:
DELETE
- Endpoint:
/webhook/{webhook_id}
Parameters
Name | Type | Required | Description |
---|---|---|---|
$webhookId | string | ✅ |
Return Type
mixed
Example Usage Code Snippet
Models
Document
Properties
Name | Type | Required | Description |
---|---|---|---|
id | string | ❌ | Unique identifier of the document |
name | string | ❌ | Name of the document |
filename | string | ❌ | Filename of the document |
pageCount | 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 |
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 |
RecipientVerificationType
Type of signature verification (SMS sends a code via SMS, PASSCODE requires a code to be entered)
Properties
Name | Type | Required | Description |
---|---|---|---|
Sms | string | SMS | |
Passcode | string | PASSCODE |
AddEnvelopeSigningStepsRequest
Properties
Name | Type | Required | Description |
---|---|---|---|
signingSteps | 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) |
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 | ❌ |
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 signature verification (SMS sends a code via SMS, PASSCODE requires a code to be entered) |
value | string | ❌ |
AnnotationCheckboxStyle
Style of the checkbox
Properties
Name | Type | Required | Description |
---|---|---|---|
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) |
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 | ❌ |
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 |
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 |
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 |