Sealeo API Documentation
Welcome to the Sealeo API by AppLeo, LLC. This API provides programmatic access to Sealeo's document signing platform. Use it to integrate e-signatures into your applications, automate document workflows, and build custom signing solutions.
Authentication
All API requests require authentication via an API key. Include your API key in the Authorization header:
Base URL
All API endpoints are relative to:
Response Codes
200 Successful response
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Document
Returns a document given an ID
| Name | Type | In | Required |
|---|---|---|---|
| documentId | number | path | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Find documents based on a search criteria
| Name | Type | In | Required |
|---|---|---|---|
| query | string | query | No |
| page | number | query | No |
| perPage | number | query | No |
| templateId | number | query | No |
| source | string | query | No |
| status | string | query | No |
| folderId | string | query | No |
| orderByColumn | string | query | No |
| orderByDirection | string | query | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Create a document using form data.
| Property | Type | Required |
|---|---|---|
| payload | object | Yes |
| file | string | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
| data | object | No |
| meta | object | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Send the document out to recipients based on your distribution method
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
| meta | object | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Redistribute the document to the provided recipients who have not actioned the document. Will use the distribution method set in the document
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
| recipients | array[number] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
| Name | Type | In | Required |
|---|---|---|---|
| documentId | number | path | Yes |
| version | string | query | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Get a pre-signed download URL for the original or signed version of a document
| Name | Type | In | Required |
|---|---|---|---|
| documentId | number | path | Yes |
| version | string | query | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
You will need to upload the PDF to the provided URL returned. Note: Once V2 API is released, this will be removed since we will allow direct uploads, instead of using an upload URL.
| Property | Type | Required |
|---|---|---|
| title | string | Yes |
| externalId | string | No |
| visibility | string | No |
| globalAccessAuth | array[string] | No |
| globalActionAuth | array[string] | No |
| formValues | object | No |
| folderId | string | No |
| recipients | array[object] | No |
| attachments | array[object] | No |
| meta | object | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Create a new attachment for a document
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
| data | object | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Update an existing attachment
| Property | Type | Required |
|---|---|---|
| id | string | Yes |
| data | object | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Delete an attachment from a document
| Property | Type | Required |
|---|---|---|
| id | string | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Find all attachments for a document
| Name | Type | In | Required |
|---|---|---|---|
| documentId | number | query | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Document Fields
Returns a single field. If you want to retrieve all the fields for a document, use the "Get Document" endpoint.
| Name | Type | In | Required |
|---|---|---|---|
| fieldId | number | path | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Create a single field for a document.
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
| field | any | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Create multiple fields for a document.
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
| fields | array[any] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Update a single field for a document.
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
| field | any | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Update multiple fields for a document.
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
| fields | array[any] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
| Property | Type | Required |
|---|---|---|
| fieldId | number | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Document Recipients
Returns a single recipient. If you want to retrieve all the recipients for a document, use the "Get Document" endpoint.
| Name | Type | In | Required |
|---|---|---|---|
| recipientId | number | path | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Create a single recipient for a document.
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
| recipient | object | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Create multiple recipients for a document.
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
| recipients | array[object] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Update a single recipient for a document.
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
| recipient | object | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Update multiple recipients for a document.
| Property | Type | Required |
|---|---|---|
| documentId | number | Yes |
| recipients | array[object] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
| Property | Type | Required |
|---|---|---|
| recipientId | number | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Embedding
Creates a presign token for embedding operations with configurable expiration time
| Property | Type | Required |
|---|---|---|
| expiresIn | number | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Verifies a presign token for embedding operations and returns the associated API token
| Property | Type | Required |
|---|---|---|
| token | string | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Envelope
Returns an envelope given an ID
| Name | Type | In | Required |
|---|---|---|---|
| envelopeId | string | path | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Create an envelope using form data.
| Property | Type | Required |
|---|---|---|
| payload | object | Yes |
| files | array[string] | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Create a document envelope from a template envelope. Upload custom files to replace the template PDFs and map them to specific envelope items using identifiers.
| Property | Type | Required |
|---|---|---|
| payload | object | Yes |
| files | array[string] | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
| Property | Type | Required |
|---|---|---|
| envelopeId | string | Yes |
| data | object | No |
| meta | object | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
| Property | Type | Required |
|---|---|---|
| envelopeId | string | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Duplicate an envelope with all its settings
| Property | Type | Required |
|---|---|---|
| envelopeId | string | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Send the envelope to recipients based on your distribution method
| Property | Type | Required |
|---|---|---|
| envelopeId | string | Yes |
| meta | object | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Redistribute the envelope to the provided recipients who have not actioned the envelope. Will use the distribution method set in the envelope
| Property | Type | Required |
|---|---|---|
| envelopeId | string | Yes |
| recipients | array[number] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Envelope Attachments
Find all attachments for an envelope
| Name | Type | In | Required |
|---|---|---|---|
| envelopeId | string | query | Yes |
| token | string | query | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Create a new attachment for an envelope
| Property | Type | Required |
|---|---|---|
| envelopeId | string | Yes |
| data | object | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Update an existing attachment
| Property | Type | Required |
|---|---|---|
| id | string | Yes |
| data | object | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Delete an attachment from an envelope
| Property | Type | Required |
|---|---|---|
| id | string | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Envelope Fields
Returns an envelope field given an ID
| Name | Type | In | Required |
|---|---|---|---|
| fieldId | number | path | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Create multiple fields for an envelope
| Property | Type | Required |
|---|---|---|
| envelopeId | string | Yes |
| data | array[any] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Update multiple envelope fields for an envelope
| Property | Type | Required |
|---|---|---|
| envelopeId | string | Yes |
| data | array[any] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Delete an envelope field
| Property | Type | Required |
|---|---|---|
| fieldId | number | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Envelope Items
Create multiple envelope items for an envelope
| Property | Type | Required |
|---|---|---|
| payload | object | Yes |
| files | array[string] | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Update multiple envelope items for an envelope
| Property | Type | Required |
|---|---|---|
| envelopeId | string | Yes |
| data | array[object] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Delete an envelope item from an envelope
| Property | Type | Required |
|---|---|---|
| envelopeId | string | Yes |
| envelopeItemId | string | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Download an envelope item by its ID
| Name | Type | In | Required |
|---|---|---|---|
| envelopeItemId | string | path | Yes |
| version | string | query | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Envelope Recipients
Returns an envelope recipient given an ID
| Name | Type | In | Required |
|---|---|---|---|
| recipientId | number | path | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Create multiple recipients for an envelope
| Property | Type | Required |
|---|---|---|
| envelopeId | string | Yes |
| data | array[object] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Update multiple recipients for an envelope
| Property | Type | Required |
|---|---|---|
| envelopeId | string | Yes |
| data | array[object] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Delete an envelope recipient
| Property | Type | Required |
|---|---|---|
| recipientId | number | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Folder
Find folders based on a search criteria
| Name | Type | In | Required |
|---|---|---|---|
| query | string | query | No |
| page | number | query | No |
| perPage | number | query | No |
| parentId | string | query | No |
| type | string | query | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Creates a new folder in your team
| Property | Type | Required |
|---|---|---|
| name | string | Yes |
| parentId | string | No |
| type | string | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Updates an existing folder
| Property | Type | Required |
|---|---|---|
| folderId | string | Yes |
| data | object | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Deletes an existing folder
| Property | Type | Required |
|---|---|---|
| folderId | string | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Template
Find templates based on a search criteria
| Name | Type | In | Required |
|---|---|---|---|
| query | string | query | No |
| page | number | query | No |
| perPage | number | query | No |
| type | string | query | No |
| folderId | string | query | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
| Name | Type | In | Required |
|---|---|---|---|
| templateId | number | path | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Create a new template
| Property | Type | Required |
|---|---|---|
| payload | object | Yes |
| file | string | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
You will need to upload the PDF to the provided URL returned. Note: Once V2 API is released, this will be removed since we will allow direct uploads, instead of using an upload URL.
| Property | Type | Required |
|---|---|---|
| title | string | Yes |
| folderId | string | No |
| externalId | string | No |
| visibility | string | No |
| globalAccessAuth | array[string] | No |
| globalActionAuth | array[string] | No |
| publicTitle | string | No |
| publicDescription | string | No |
| type | string | No |
| meta | object | No |
| attachments | array[object] | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
| data | object | No |
| meta | object | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Use the template to create a document
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
| recipients | array[object] | Yes |
| distributeDocument | boolean | No |
| customDocumentDataId | string | No |
| customDocumentData | array[object] | No |
| folderId | string | No |
| prefillFields | array[any] | No |
| override | object | No |
| attachments | array[object] | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Create a direct link for a template
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
| directRecipientId | number | No |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Delete a direct link for a template
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Enable or disable a direct link for a template
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
| enabled | boolean | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Template Fields
Create a single field for a template.
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
| field | any | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Returns a single field. If you want to retrieve all the fields for a template, use the "Get Template" endpoint.
| Name | Type | In | Required |
|---|---|---|---|
| fieldId | number | path | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Create multiple fields for a template.
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
| fields | array[any] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Update a single field for a template.
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
| field | any | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Update multiple fields for a template.
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
| fields | array[any] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
| Property | Type | Required |
|---|---|---|
| fieldId | number | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Template Recipients
Returns a single recipient. If you want to retrieve all the recipients for a template, use the "Get Template" endpoint.
| Name | Type | In | Required |
|---|---|---|---|
| recipientId | number | path | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
404 Not found
500 Internal server error
Create a single recipient for a template.
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
| recipient | object | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Create multiple recipients for a template.
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
| recipients | array[object] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Update a single recipient for a template.
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
| recipient | object | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
Update multiple recipients for a template.
| Property | Type | Required |
|---|---|---|
| templateId | number | Yes |
| recipients | array[object] | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error
| Property | Type | Required |
|---|---|---|
| recipientId | number | Yes |
400 Invalid input data
401 Authorization not provided
403 Insufficient access
500 Internal server error