Skip to main content
POST
List envelopes

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
deprecated

Filter by envelope name. Deprecated — use search instead, which matches across envelope name, recipient name, and recipient email in a single query.

General-purpose search term that matches against envelope name, recipient name, and recipient email address. Case-insensitive and supports partial matches. Replaces the name field for broader, more flexible filtering.

tags
string[]

List of tags

Tag of the envelope

comment
string

Comment of the envelope

ids
string[]

List of envelope IDs

ID of the envelope

statuses
enum<string>[]

List of envelope statuses to filter by. Valid values: DRAFT, IN_PROGRESS, COMPLETED, EXPIRED, DECLINED, VOIDED, PENDING.

Available options:
DRAFT,
IN_PROGRESS,
COMPLETED,
EXPIRED,
DECLINED,
VOIDED,
PENDING
folder_ids
string[]

List of folder IDs

ID of the folder

only_root_folder
boolean

Whether to only list envelopes in the root folder

date_from
integer

Unix timestamp of the start date

date_to
integer

Unix timestamp of the end date

uid
string

Unique identifier of the user

first
integer
last
integer
after
string
before
string
order_field
enum<string>

Field to order envelopes by. Valid values: CREATION_DATE, MODIFICATION_DATE, NAME, STATUS, LAST_DOCUMENT_CHANGE.

Available options:
CREATION_DATE,
MODIFICATION_DATE,
NAME,
STATUS,
LAST_DOCUMENT_CHANGE
ascending
boolean

Whether to order envelopes in ascending order

include_trash
boolean

Whether to include envelopes in the trash

Response

200 - application/json

List of envelopes retrieved successfully

has_next_page
boolean

Whether there is a next page

has_previous_page
boolean

Whether there is a previous page

envelopes
object[]