A list of all methods in the SignplusService service. Click on the method name to view detailed information about that method.

MethodsDescription
create_envelopeCreate new envelope
create_envelope_from_templateCreate new envelope from template
list_envelopesList envelopes
get_envelopeGet envelope
delete_envelopeDelete envelope
get_envelope_documentGet envelope document
get_envelope_documentsGet envelope documents
add_envelope_documentAdd envelope document
set_envelope_dynamic_fieldsSet envelope dynamic fields
add_envelope_signing_stepsAdd envelope signing steps
send_envelopeSend envelope for signature
duplicate_envelopeDuplicate envelope
void_envelopeVoid envelope
rename_envelopeRename envelope
set_envelope_commentSet envelope comment
set_envelope_notificationSet envelope notification
set_envelope_expiration_dateSet envelope expiration date
set_envelope_legality_levelSet envelope legality level
get_envelope_annotationsGet envelope annotations
get_envelope_document_annotationsGet envelope document annotations
add_envelope_annotationAdd envelope annotation
delete_envelope_annotationDelete envelope annotation
create_templateCreate new template
list_templatesList templates
get_templateGet template
delete_templateDelete template
duplicate_templateDuplicate template
add_template_documentAdd template document
get_template_documentGet template document
get_template_documentsGet template documents
add_template_signing_stepsAdd template signing steps
rename_templateRename template
set_template_commentSet template comment
set_template_notificationSet template notification
get_template_annotationsGet template annotations
get_document_template_annotationsGet document template annotations
add_template_annotationAdd template annotation
delete_template_annotationDelete template annotation
create_webhookCreate webhook
list_webhooksList webhooks
delete_webhookDelete webhook

create_envelope

Create new envelope

  • HTTP Method: POST
  • Endpoint: /envelope

Parameters

NameTypeRequiredDescription
request_bodyCreateEnvelopeRequest

The request body.

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import CreateEnvelopeRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = CreateEnvelopeRequest(
    name="name",
    flow_type="REQUEST_SIGNATURE",
    legality_level="SES",
    expires_at=4,
    comment="comment",
    sandbox=True
)

result = sdk.signplus.create_envelope(request_body=request_body)

print(result)

create_envelope_from_template

Create new envelope from template

  • HTTP Method: POST
  • Endpoint: /envelope/from_template/{template_id}

Parameters

NameTypeRequiredDescription
request_bodyCreateEnvelopeFromTemplateRequest

The request body.
template_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import CreateEnvelopeFromTemplateRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = CreateEnvelopeFromTemplateRequest(
    name="name",
    comment="comment",
    sandbox=False
)

result = sdk.signplus.create_envelope_from_template(
    request_body=request_body,
    template_id="template_id"
)

print(result)

list_envelopes

List envelopes

  • HTTP Method: POST
  • Endpoint: /envelopes

Parameters

NameTypeRequiredDescription
request_bodyListEnvelopesRequest

The request body.

Return Type

ListEnvelopesResponse

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import ListEnvelopesRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = ListEnvelopesRequest(
    name="name",
    tags=[
        "tags"
    ],
    comment="comment",
    ids=[
        "ids"
    ],
    statuses=[
        "DRAFT"
    ],
    folder_ids=[
        "folder_ids"
    ],
    only_root_folder=False,
    date_from=2,
    date_to=5,
    uid="uid",
    first=4,
    last=9,
    after="after",
    before="before",
    order_field="CREATION_DATE",
    ascending=True,
    include_trash=True
)

result = sdk.signplus.list_envelopes(request_body=request_body)

print(result)

get_envelope

Get envelope

  • HTTP Method: GET
  • Endpoint: /envelope/{envelope_id}

Parameters

NameTypeRequiredDescription
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.get_envelope(envelope_id="envelope_id")

print(result)

delete_envelope

Delete envelope

  • HTTP Method: DELETE
  • Endpoint: /envelope/{envelope_id}

Parameters

NameTypeRequiredDescription
envelope_idstr

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.delete_envelope(envelope_id="envelope_id")

print(result)

get_envelope_document

Get envelope document

  • HTTP Method: GET
  • Endpoint: /envelope/{envelope_id}/document/{document_id}

Parameters

NameTypeRequiredDescription
envelope_idstr

document_idstr

Return Type

Document

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.get_envelope_document(
    envelope_id="envelope_id",
    document_id="document_id"
)

print(result)

get_envelope_documents

Get envelope documents

  • HTTP Method: GET
  • Endpoint: /envelope/{envelope_id}/documents

Parameters

NameTypeRequiredDescription
envelope_idstr

Return Type

ListEnvelopeDocumentsResponse

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.get_envelope_documents(envelope_id="envelope_id")

print(result)

add_envelope_document

Add envelope document

  • HTTP Method: POST
  • Endpoint: /envelope/{envelope_id}/document

Parameters

NameTypeRequiredDescription
request_bodyAddEnvelopeDocumentRequest

The request body.
envelope_idstr

Return Type

Document

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import AddEnvelopeDocumentRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = AddEnvelopeDocumentRequest(
    file="file"
)

result = sdk.signplus.add_envelope_document(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

set_envelope_dynamic_fields

Set envelope dynamic fields

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/dynamic_fields

Parameters

NameTypeRequiredDescription
request_bodySetEnvelopeDynamicFieldsRequest

The request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import SetEnvelopeDynamicFieldsRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = SetEnvelopeDynamicFieldsRequest(
    dynamic_fields=[
        {
            "name": "name",
            "value": "value"
        }
    ]
)

result = sdk.signplus.set_envelope_dynamic_fields(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

add_envelope_signing_steps

Add envelope signing steps

  • HTTP Method: POST
  • Endpoint: /envelope/{envelope_id}/signing_steps

Parameters

NameTypeRequiredDescription
request_bodyAddEnvelopeSigningStepsRequest

The request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import AddEnvelopeSigningStepsRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = AddEnvelopeSigningStepsRequest(
    signing_steps=[
        {
            "recipients": [
                {
                    "id_": "id",
                    "uid": "uid",
                    "name": "name",
                    "email": "email",
                    "role": "SIGNER",
                    "verification": {
                        "type_": "SMS",
                        "value": "value"
                    }
                }
            ]
        }
    ]
)

result = sdk.signplus.add_envelope_signing_steps(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

send_envelope

Send envelope for signature

  • HTTP Method: POST
  • Endpoint: /envelope/{envelope_id}/send

Parameters

NameTypeRequiredDescription
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.send_envelope(envelope_id="envelope_id")

print(result)

duplicate_envelope

Duplicate envelope

  • HTTP Method: POST
  • Endpoint: /envelope/{envelope_id}/duplicate

Parameters

NameTypeRequiredDescription
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.duplicate_envelope(envelope_id="envelope_id")

print(result)

void_envelope

Void envelope

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/void

Parameters

NameTypeRequiredDescription
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.void_envelope(envelope_id="envelope_id")

print(result)

rename_envelope

Rename envelope

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/rename

Parameters

NameTypeRequiredDescription
request_bodyRenameEnvelopeRequest

The request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import RenameEnvelopeRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = RenameEnvelopeRequest(
    name="name"
)

result = sdk.signplus.rename_envelope(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

set_envelope_comment

Set envelope comment

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/set_comment

Parameters

NameTypeRequiredDescription
request_bodySetEnvelopeCommentRequest

The request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import SetEnvelopeCommentRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = SetEnvelopeCommentRequest(
    comment="comment"
)

result = sdk.signplus.set_envelope_comment(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

set_envelope_notification

Set envelope notification

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/set_notification

Parameters

NameTypeRequiredDescription
request_bodyEnvelopeNotification

The request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import EnvelopeNotification

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = EnvelopeNotification(
    subject="subject",
    message="message",
    reminder_interval=5
)

result = sdk.signplus.set_envelope_notification(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

set_envelope_expiration_date

Set envelope expiration date

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/set_expiration_date

Parameters

NameTypeRequiredDescription
request_bodySetEnvelopeExpirationRequest

The request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import SetEnvelopeExpirationRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = SetEnvelopeExpirationRequest(
    expires_at=2
)

result = sdk.signplus.set_envelope_expiration_date(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

set_envelope_legality_level

Set envelope legality level

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/set_legality_level

Parameters

NameTypeRequiredDescription
request_bodySetEnvelopeLegalityLevelRequest

The request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import SetEnvelopeLegalityLevelRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = SetEnvelopeLegalityLevelRequest(
    legality_level="SES"
)

result = sdk.signplus.set_envelope_legality_level(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

get_envelope_annotations

Get envelope annotations

  • HTTP Method: GET
  • Endpoint: /envelope/{envelope_id}/annotations

Parameters

NameTypeRequiredDescription
envelope_idstr

ID of the envelope

Return Type

List[Annotation]

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.get_envelope_annotations(envelope_id="envelope_id")

print(result)

get_envelope_document_annotations

Get envelope document annotations

  • HTTP Method: GET
  • Endpoint: /envelope/{envelope_id}/annotations/{document_id}

Parameters

NameTypeRequiredDescription
envelope_idstr

ID of the envelope
document_idstr

ID of document

Return Type

ListEnvelopeDocumentAnnotationsResponse

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.get_envelope_document_annotations(
    envelope_id="envelope_id",
    document_id="document_id"
)

print(result)

add_envelope_annotation

Add envelope annotation

  • HTTP Method: POST
  • Endpoint: /envelope/{envelope_id}/annotation

Parameters

NameTypeRequiredDescription
request_bodyAddAnnotationRequest

The request body.
envelope_idstr

ID of the envelope

Return Type

Annotation

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import AddAnnotationRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = AddAnnotationRequest(
    recipient_id="recipient_id",
    document_id="document_id",
    page=7,
    x=4.46,
    y=7.18,
    width=7.26,
    height=1.77,
    required=False,
    type_="TEXT",
    signature={
        "id_": "id"
    },
    initials={
        "id_": "id"
    },
    text={
        "size": 8.13,
        "color": 7.22,
        "value": "value",
        "tooltip": "tooltip",
        "dynamic_field_name": "dynamic_field_name",
        "font": {
            "family": "UNKNOWN",
            "italic": True,
            "bold": False
        }
    },
    datetime_={
        "size": 0.86,
        "font": {
            "family": "UNKNOWN",
            "italic": True,
            "bold": False
        },
        "color": "color",
        "auto_fill": False,
        "timezone": "timezone",
        "timestamp": 8,
        "format": "DMY_NUMERIC_SLASH"
    },
    checkbox={
        "checked": False,
        "style": "CIRCLE_CHECK"
    }
)

result = sdk.signplus.add_envelope_annotation(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

delete_envelope_annotation

Delete envelope annotation

  • HTTP Method: DELETE
  • Endpoint: /envelope/{envelope_id}/annotation/{annotation_id}

Parameters

NameTypeRequiredDescription
envelope_idstr

ID of the envelope
annotation_idstr

ID of the annotation to delete

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.delete_envelope_annotation(
    envelope_id="envelope_id",
    annotation_id="annotation_id"
)

print(result)

create_template

Create new template

  • HTTP Method: POST
  • Endpoint: /template

Parameters

NameTypeRequiredDescription
request_bodyCreateTemplateRequest

The request body.

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import CreateTemplateRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = CreateTemplateRequest(
    name="name"
)

result = sdk.signplus.create_template(request_body=request_body)

print(result)

list_templates

List templates

  • HTTP Method: POST
  • Endpoint: /templates

Parameters

NameTypeRequiredDescription
request_bodyListTemplatesRequest

The request body.

Return Type

ListTemplatesResponse

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import ListTemplatesRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = ListTemplatesRequest(
    name="name",
    tags=[
        "tags"
    ],
    ids=[
        "ids"
    ],
    first=8,
    last=7,
    after="after",
    before="before",
    order_field="TEMPLATE_ID",
    ascending=True
)

result = sdk.signplus.list_templates(request_body=request_body)

print(result)

get_template

Get template

  • HTTP Method: GET
  • Endpoint: /template/{template_id}

Parameters

NameTypeRequiredDescription
template_idstr

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.get_template(template_id="template_id")

print(result)

delete_template

Delete template

  • HTTP Method: DELETE
  • Endpoint: /template/{template_id}

Parameters

NameTypeRequiredDescription
template_idstr

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.delete_template(template_id="template_id")

print(result)

duplicate_template

Duplicate template

  • HTTP Method: POST
  • Endpoint: /template/{template_id}/duplicate

Parameters

NameTypeRequiredDescription
template_idstr

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.duplicate_template(template_id="template_id")

print(result)

add_template_document

Add template document

  • HTTP Method: POST
  • Endpoint: /template/{template_id}/document

Parameters

NameTypeRequiredDescription
request_bodyAddTemplateDocumentRequest

The request body.
template_idstr

Return Type

Document

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import AddTemplateDocumentRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = AddTemplateDocumentRequest(
    file="file"
)

result = sdk.signplus.add_template_document(
    request_body=request_body,
    template_id="template_id"
)

print(result)

get_template_document

Get template document

  • HTTP Method: GET
  • Endpoint: /template/{template_id}/document/{document_id}

Parameters

NameTypeRequiredDescription
template_idstr

document_idstr

Return Type

Document

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.get_template_document(
    template_id="template_id",
    document_id="document_id"
)

print(result)

get_template_documents

Get template documents

  • HTTP Method: GET
  • Endpoint: /template/{template_id}/documents

Parameters

NameTypeRequiredDescription
template_idstr

Return Type

ListTemplateDocumentsResponse

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.get_template_documents(template_id="template_id")

print(result)

add_template_signing_steps

Add template signing steps

  • HTTP Method: POST
  • Endpoint: /template/{template_id}/signing_steps

Parameters

NameTypeRequiredDescription
request_bodyAddTemplateSigningStepsRequest

The request body.
template_idstr

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import AddTemplateSigningStepsRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = AddTemplateSigningStepsRequest(
    signing_steps=[
        {
            "recipients": [
                {
                    "id_": "id",
                    "uid": "uid",
                    "name": "name",
                    "email": "email",
                    "role": "SIGNER"
                }
            ]
        }
    ]
)

result = sdk.signplus.add_template_signing_steps(
    request_body=request_body,
    template_id="template_id"
)

print(result)

rename_template

Rename template

  • HTTP Method: PUT
  • Endpoint: /template/{template_id}/rename

Parameters

NameTypeRequiredDescription
request_bodyRenameTemplateRequest

The request body.
template_idstr

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import RenameTemplateRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = RenameTemplateRequest(
    name="name"
)

result = sdk.signplus.rename_template(
    request_body=request_body,
    template_id="template_id"
)

print(result)

set_template_comment

Set template comment

  • HTTP Method: PUT
  • Endpoint: /template/{template_id}/set_comment

Parameters

NameTypeRequiredDescription
request_bodySetTemplateCommentRequest

The request body.
template_idstr

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import SetTemplateCommentRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = SetTemplateCommentRequest(
    comment="comment"
)

result = sdk.signplus.set_template_comment(
    request_body=request_body,
    template_id="template_id"
)

print(result)

set_template_notification

Set template notification

  • HTTP Method: PUT
  • Endpoint: /template/{template_id}/set_notification

Parameters

NameTypeRequiredDescription
request_bodyEnvelopeNotification

The request body.
template_idstr

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import EnvelopeNotification

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = EnvelopeNotification(
    subject="subject",
    message="message",
    reminder_interval=5
)

result = sdk.signplus.set_template_notification(
    request_body=request_body,
    template_id="template_id"
)

print(result)

get_template_annotations

Get template annotations

  • HTTP Method: GET
  • Endpoint: /template/{template_id}/annotations

Parameters

NameTypeRequiredDescription
template_idstr

ID of the template

Return Type

ListTemplateAnnotationsResponse

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.get_template_annotations(template_id="template_id")

print(result)

get_document_template_annotations

Get document template annotations

  • HTTP Method: GET
  • Endpoint: /template/{template_id}/annotations/{document_id}

Parameters

NameTypeRequiredDescription
template_idstr

ID of the template
document_idstr

ID of document

Return Type

ListTemplateDocumentAnnotationsResponse

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.get_document_template_annotations(
    template_id="template_id",
    document_id="document_id"
)

print(result)

add_template_annotation

Add template annotation

  • HTTP Method: POST
  • Endpoint: /template/{template_id}/annotation

Parameters

NameTypeRequiredDescription
request_bodyAddAnnotationRequest

The request body.
template_idstr

ID of the template

Return Type

Annotation

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import AddAnnotationRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = AddAnnotationRequest(
    recipient_id="recipient_id",
    document_id="document_id",
    page=7,
    x=4.46,
    y=7.18,
    width=7.26,
    height=1.77,
    required=False,
    type_="TEXT",
    signature={
        "id_": "id"
    },
    initials={
        "id_": "id"
    },
    text={
        "size": 8.13,
        "color": 7.22,
        "value": "value",
        "tooltip": "tooltip",
        "dynamic_field_name": "dynamic_field_name",
        "font": {
            "family": "UNKNOWN",
            "italic": True,
            "bold": False
        }
    },
    datetime_={
        "size": 0.86,
        "font": {
            "family": "UNKNOWN",
            "italic": True,
            "bold": False
        },
        "color": "color",
        "auto_fill": False,
        "timezone": "timezone",
        "timestamp": 8,
        "format": "DMY_NUMERIC_SLASH"
    },
    checkbox={
        "checked": False,
        "style": "CIRCLE_CHECK"
    }
)

result = sdk.signplus.add_template_annotation(
    request_body=request_body,
    template_id="template_id"
)

print(result)

delete_template_annotation

Delete template annotation

  • HTTP Method: DELETE
  • Endpoint: /template/{template_id}/annotation/{annotation_id}

Parameters

NameTypeRequiredDescription
template_idstr

ID of the template
annotation_idstr

ID of the annotation to delete

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.delete_template_annotation(
    template_id="template_id",
    annotation_id="annotation_id"
)

print(result)

create_webhook

Create webhook

  • HTTP Method: POST
  • Endpoint: /webhook

Parameters

NameTypeRequiredDescription
request_bodyCreateWebhookRequest

The request body.

Return Type

Webhook

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import CreateWebhookRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = CreateWebhookRequest(
    event="ENVELOPE_EXPIRED",
    target="target"
)

result = sdk.signplus.create_webhook(request_body=request_body)

print(result)

list_webhooks

List webhooks

  • HTTP Method: POST
  • Endpoint: /webhooks

Parameters

NameTypeRequiredDescription
request_bodyListWebhooksRequest

The request body.

Return Type

ListWebhooksResponse

Example Usage Code Snippet

from signplus import Signplus, Environment
from signplus.models import ListWebhooksRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

request_body = ListWebhooksRequest(
    webhook_id="webhook_id",
    event="ENVELOPE_EXPIRED"
)

result = sdk.signplus.list_webhooks(request_body=request_body)

print(result)

delete_webhook

Delete webhook

  • HTTP Method: DELETE
  • Endpoint: /webhook/{webhook_id}

Parameters

NameTypeRequiredDescription
webhook_idstr

Example Usage Code Snippet

from signplus import Signplus, Environment

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    base_url=Environment.DEFAULT.value,
    timeout=10000
)

result = sdk.signplus.delete_webhook(webhook_id="webhook_id")

print(result)

Models

Document

Properties

NameTypeRequiredDescription
id_str

Unique identifier of the document
namestr

Name of the document
filenamestr

Filename of the document
page_countint

Number of pages in the document
pagesList[Page]

List of pages in the document

Models

CreateEnvelopeRequest

Properties

NameTypeRequiredDescription
namestr

Name of the envelope
flow_typeEnvelopeFlowType

Flow type of the envelope (REQUEST_SIGNATURE is a request for signature, SIGN_MYSELF is a self-signing flow)
legality_levelEnvelopeLegalityLevel

Legal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes)
expires_atint

Unix timestamp of the expiration date
commentstr

Comment for the envelope
sandboxbool

Whether the envelope is created in sandbox mode

Models

ListEnvelopesRequest

Properties

NameTypeRequiredDescription
namestr

Name of the envelope
tagsList[str]

List of tags
commentstr

Comment of the envelope
idsList[str]

List of envelope IDs
statusesList[EnvelopeStatus]

List of envelope statuses
folder_idsList[str]

List of folder IDs
only_root_folderbool

Whether to only list envelopes in the root folder
date_fromint

Unix timestamp of the start date
date_toint

Unix timestamp of the end date
uidstr

Unique identifier of the user
firstint

lastint

afterstr

beforestr

order_fieldEnvelopeOrderField

Field to order envelopes by
ascendingbool

Whether to order envelopes in ascending order
include_trashbool

Whether to include envelopes in the trash

Models

EnvelopeNotification

Properties

NameTypeRequiredDescription
subjectstr

Subject of the notification
messagestr

Message of the notification
reminder_intervalint

Interval in days to send reminder

Models

ListTemplatesRequest

Properties

NameTypeRequiredDescription
namestr

Name of the template
tagsList[str]

List of tag templates
idsList[str]

List of templates IDs
firstint

lastint

afterstr

beforestr

order_fieldTemplateOrderField

Field to order templates by
ascendingbool

Whether to order templates in ascending order

Models

SetTemplateCommentRequest

Properties

NameTypeRequiredDescription
commentstr

Comment for the template

Models

Template

Properties

NameTypeRequiredDescription
id_str

Unique identifier of the template
namestr

Name of the template
commentstr

Comment for the template
pagesint

Total number of pages in the template
legality_levelEnvelopeLegalityLevel

Legal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes)
created_atint

Unix timestamp of the creation date
updated_atint

Unix timestamp of the last modification date
expiration_delayint

Expiration delay added to the current time when an envelope is created from this template
num_recipientsint

Number of recipients in the envelope
signing_stepsList[TemplateSigningStep]

documentsList[Document]

notificationEnvelopeNotification

dynamic_fieldsList[str]

List of dynamic fields

Models

RecipientVerificationType

Type of signature verification (SMS sends a code via SMS, PASSCODE requires a code to be entered)

Properties

NameTypeRequiredDescription
SMSstr

“SMS”
PASSCODEstr

“PASSCODE”

Models

AddEnvelopeSigningStepsRequest

Properties

NameTypeRequiredDescription
signing_stepsList[SigningStep]

List of signing steps

Models

AnnotationFontFamily

Font family of the text

Properties

NameTypeRequiredDescription
UNKNOWNstr

“UNKNOWN”
SERIFstr

“SERIF”
SANSstr

“SANS”
MONOstr

“MONO”

Models

AddTemplateSigningStepsRequest

Properties

NameTypeRequiredDescription
signing_stepsList[TemplateSigningStep]

List of signing steps

Models

SetEnvelopeCommentRequest

Properties

NameTypeRequiredDescription
commentstr

Comment for the envelope

Models

TemplateOrderField

Field to order templates by

Properties

NameTypeRequiredDescription
TEMPLATE_IDstr

“TEMPLATE_ID”
TEMPLATE_CREATION_DATEstr

“TEMPLATE_CREATION_DATE”
TEMPLATE_MODIFICATION_DATEstr

“TEMPLATE_MODIFICATION_DATE”
TEMPLATE_NAMEstr

“TEMPLATE_NAME”

Models

EnvelopeOrderField

Field to order envelopes by

Properties

NameTypeRequiredDescription
CREATION_DATEstr

“CREATION_DATE”
MODIFICATION_DATEstr

“MODIFICATION_DATE”
NAMEstr

“NAME”
STATUSstr

“STATUS”
LAST_DOCUMENT_CHANGEstr

“LAST_DOCUMENT_CHANGE”

Models

AddEnvelopeDocumentRequest

Properties

NameTypeRequiredDescription
filebytes

File to upload in binary format

Models

ListWebhooksRequest

Properties

NameTypeRequiredDescription
webhook_idstr

ID of the webhook
eventWebhookEvent

Event of the webhook

Models

SetEnvelopeLegalityLevelRequest

Properties

NameTypeRequiredDescription
legality_levelEnvelopeLegalityLevel

Legal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes)

Models

SetEnvelopeExpirationRequest

Properties

NameTypeRequiredDescription
expires_atint

Unix timestamp of the expiration date

Models

AnnotationText

Text annotation (null if annotation is not a text)

Properties

NameTypeRequiredDescription
sizefloat

Font size of the text in pt
colorfloat

Text color in 32bit representation
valuestr

Text content of the annotation
tooltipstr

Tooltip of the annotation
dynamic_field_namestr

Name of the dynamic field
fontAnnotationFont

Models

AnnotationCheckbox

Checkbox annotation (null if annotation is not a checkbox)

Properties

NameTypeRequiredDescription
checkedbool

Whether the checkbox is checked
styleAnnotationCheckboxStyle

Style of the checkbox

Models

Envelope

Properties

NameTypeRequiredDescription
id_str

Unique identifier of the envelope
namestr

Name of the envelope
commentstr

Comment for the envelope
pagesint

Total number of pages in the envelope
flow_typeEnvelopeFlowType

Flow type of the envelope (REQUEST_SIGNATURE is a request for signature, SIGN_MYSELF is a self-signing flow)
legality_levelEnvelopeLegalityLevel

Legal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes)
statusEnvelopeStatus

Status of the envelope
created_atint

Unix timestamp of the creation date
updated_atint

Unix timestamp of the last modification date
expires_atint

Unix timestamp of the expiration date
num_recipientsint

Number of recipients in the envelope
is_duplicablebool

Whether the envelope can be duplicated
signing_stepsList[SigningStep]

documentsList[Document]

notificationEnvelopeNotification

Models

AddTemplateDocumentRequest

Properties

NameTypeRequiredDescription
filebytes

File to upload in binary format

Models

TemplateRecipient

Properties

NameTypeRequiredDescription
id_str

Unique identifier of the recipient
uidstr

Unique identifier of the user associated with the recipient
namestr

Name of the recipient
emailstr

Email of the recipient
roleTemplateRecipientRole

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)

Models

AddAnnotationRequest

Properties

NameTypeRequiredDescription
document_idstr

ID of the document
pageint

Page number where the annotation is placed
xfloat

X coordinate of the annotation (in % of the page width from 0 to 100) from the top left corner
yfloat

Y coordinate of the annotation (in % of the page height from 0 to 100) from the top left corner
widthfloat

Width of the annotation (in % of the page width from 0 to 100)
heightfloat

Height of the annotation (in % of the page height from 0 to 100)
type_AnnotationType

Type of the annotation
recipient_idstr

ID of the recipient
requiredbool

signatureAnnotationSignature

Signature annotation (null if annotation is not a signature)
initialsAnnotationInitials

Initials annotation (null if annotation is not initials)
textAnnotationText

Text annotation (null if annotation is not a text)
datetime_AnnotationDateTime

Date annotation (null if annotation is not a date)
checkboxAnnotationCheckbox

Checkbox annotation (null if annotation is not a checkbox)

Models

ListEnvelopeDocumentAnnotationsResponse

Properties

NameTypeRequiredDescription
annotationsList[Annotation]

Models

EnvelopeStatus

Status of the envelope

Properties

NameTypeRequiredDescription
DRAFTstr

“DRAFT”
IN_PROGRESSstr

“IN_PROGRESS”
COMPLETEDstr

“COMPLETED”
EXPIREDstr

“EXPIRED”
DECLINEDstr

“DECLINED”
VOIDEDstr

“VOIDED”
PENDINGstr

“PENDING”

Models

RecipientVerification

Properties

NameTypeRequiredDescription
type_RecipientVerificationType

Type of signature verification (SMS sends a code via SMS, PASSCODE requires a code to be entered)
valuestr

Models

AnnotationCheckboxStyle

Style of the checkbox

Properties

NameTypeRequiredDescription
CIRCLE_CHECKstr

“CIRCLE_CHECK”
CIRCLE_FULLstr

“CIRCLE_FULL”
SQUARE_CHECKstr

“SQUARE_CHECK”
SQUARE_FULLstr

“SQUARE_FULL”
CHECK_MARKstr

“CHECK_MARK”
TIMES_SQUAREstr

“TIMES_SQUARE”

Models

SigningStep

Properties

NameTypeRequiredDescription
recipientsList[Recipient]

List of recipients

Models

AnnotationDateTime

Date annotation (null if annotation is not a date)

Properties

NameTypeRequiredDescription
sizefloat

Font size of the text in pt
fontAnnotationFont

colorstr

Color of the text in hex format
auto_fillbool

Whether the date should be automatically filled
timezonestr

Timezone of the date
timestampint

Unix timestamp of the date
formatAnnotationDateTimeFormat

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)

Models

CreateTemplateRequest

Properties

NameTypeRequiredDescription
namestr

Models

ListTemplateDocumentsResponse

Properties

NameTypeRequiredDescription
documentsList[Document]

Models

AnnotationInitials

Initials annotation (null if annotation is not initials)

Properties

NameTypeRequiredDescription
id_str

Unique identifier of the annotation initials

Models

AnnotationFont

Properties

NameTypeRequiredDescription
familyAnnotationFontFamily

Font family of the text
italicbool

Whether the text is italic
boldbool

Whether the text is bold

Models

AnnotationType

Type of the annotation

Properties

NameTypeRequiredDescription
TEXTstr

“TEXT”
SIGNATUREstr

“SIGNATURE”
INITIALSstr

“INITIALS”
CHECKBOXstr

“CHECKBOX”
DATEstr

“DATE”

Models

Webhook

Properties

NameTypeRequiredDescription
id_str

Unique identifier of the webhook
eventWebhookEvent

Event of the webhook
targetstr

Target URL of the webhook

Models

RenameTemplateRequest

Properties

NameTypeRequiredDescription
namestr

Name of the template

Models

ListTemplatesResponse

Properties

NameTypeRequiredDescription
has_next_pagebool

Whether there is a next page
has_previous_pagebool

Whether there is a previous page
templatesList[Template]

Models

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

NameTypeRequiredDescription
SIGNERstr

“SIGNER”
RECEIVES_COPYstr

“RECEIVES_COPY”
IN_PERSON_SIGNERstr

“IN_PERSON_SIGNER”

Models

Annotation

Properties

NameTypeRequiredDescription
id_str

Unique identifier of the annotation
recipient_idstr

ID of the recipient
document_idstr

ID of the document
pageint

Page number where the annotation is placed
xfloat

X coordinate of the annotation (in % of the page width from 0 to 100) from the top left corner
yfloat

Y coordinate of the annotation (in % of the page height from 0 to 100) from the top left corner
widthfloat

Width of the annotation (in % of the page width from 0 to 100)
heightfloat

Height of the annotation (in % of the page height from 0 to 100)
requiredbool

Whether the annotation is required
type_AnnotationType

Type of the annotation
signatureAnnotationSignature

Signature annotation (null if annotation is not a signature)
initialsAnnotationInitials

Initials annotation (null if annotation is not initials)
textAnnotationText

Text annotation (null if annotation is not a text)
datetime_AnnotationDateTime

Date annotation (null if annotation is not a date)
checkboxAnnotationCheckbox

Checkbox annotation (null if annotation is not a checkbox)

Models

DynamicField

Properties

NameTypeRequiredDescription
namestr

Name of the dynamic field
valuestr

Value of the dynamic field

Models

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

NameTypeRequiredDescription
DMY_NUMERIC_SLASHstr

“DMY_NUMERIC_SLASH”
MDY_NUMERIC_SLASHstr

“MDY_NUMERIC_SLASH”
YMD_NUMERIC_SLASHstr

“YMD_NUMERIC_SLASH”
DMY_NUMERIC_DASH_SHORTstr

“DMY_NUMERIC_DASH_SHORT”
DMY_NUMERIC_DASHstr

“DMY_NUMERIC_DASH”
YMD_NUMERIC_DASHstr

“YMD_NUMERIC_DASH”
MDY_TEXT_DASH_SHORTstr

“MDY_TEXT_DASH_SHORT”
MDY_TEXT_SPACE_SHORTstr

“MDY_TEXT_SPACE_SHORT”
MDY_TEXT_SPACEstr

“MDY_TEXT_SPACE”

Models

EnvelopeFlowType

Flow type of the envelope (REQUEST_SIGNATURE is a request for signature, SIGN_MYSELF is a self-signing flow)

Properties

NameTypeRequiredDescription
REQUEST_SIGNATUREstr

“REQUEST_SIGNATURE”
SIGN_MYSELFstr

“SIGN_MYSELF”

Models

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

NameTypeRequiredDescription
SESstr

“SES”
QES_EIDASstr

“QES_EIDAS”
QES_ZERTESstr

“QES_ZERTES”

Models

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

NameTypeRequiredDescription
SIGNERstr

“SIGNER”
RECEIVES_COPYstr

“RECEIVES_COPY”
IN_PERSON_SIGNERstr

“IN_PERSON_SIGNER”

Models

SetEnvelopeDynamicFieldsRequest

Properties

NameTypeRequiredDescription
dynamic_fieldsList[DynamicField]

List of dynamic fields

Models

Page

Properties

NameTypeRequiredDescription
widthint

Width of the page in pixels
heightint

Height of the page in pixels

Models

TemplateSigningStep

Properties

NameTypeRequiredDescription
recipientsList[TemplateRecipient]

List of recipients

Models

ListEnvelopesResponse

Properties

NameTypeRequiredDescription
has_next_pagebool

Whether there is a next page
has_previous_pagebool

Whether there is a previous page
envelopesList[Envelope]

Models

Recipient

Properties

NameTypeRequiredDescription
namestr

Name of the recipient
emailstr

Email of the recipient
roleRecipientRole

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_str

Unique identifier of the recipient
uidstr

Unique identifier of the user associated with the recipient
verificationRecipientVerification

Models

WebhookEvent

Event of the webhook

Properties

NameTypeRequiredDescription
ENVELOPE_EXPIREDstr

“ENVELOPE_EXPIRED”
ENVELOPE_DECLINEDstr

“ENVELOPE_DECLINED”
ENVELOPE_VOIDEDstr

“ENVELOPE_VOIDED”
ENVELOPE_COMPLETEDstr

“ENVELOPE_COMPLETED”

Models

CreateWebhookRequest

Properties

NameTypeRequiredDescription
eventWebhookEvent

Event of the webhook
targetstr

URL of the webhook target

Models

CreateEnvelopeFromTemplateRequest

Properties

NameTypeRequiredDescription
namestr

Name of the envelope
commentstr

Comment for the envelope
sandboxbool

Whether the envelope is created in sandbox mode

Models

ListTemplateAnnotationsResponse

Properties

NameTypeRequiredDescription
annotationsList[Annotation]

Models

RenameEnvelopeRequest

Properties

NameTypeRequiredDescription
namestr

Name of the envelope

Models

ListTemplateDocumentAnnotationsResponse

Properties

NameTypeRequiredDescription
annotationsList[Annotation]

Models

ListEnvelopeDocumentsResponse

Properties

NameTypeRequiredDescription
documentsList[Document]

Models

ListWebhooksResponse

Properties

NameTypeRequiredDescription
webhooksList[Webhook]

Models

AnnotationSignature

Signature annotation (null if annotation is not a signature)

Properties

NameTypeRequiredDescription
id_str

Unique identifier of the annotation signature