v1

latestSwagger 2.02026-07-134146194.6 MB
Folders

Deprecated. Use Envelopes: listStatusChanges.

<ds-inlinemessage kind="warning" markdown="1"> <strong>This method is deprecated in API v2.1</strong>

Use Envelopes: listStatusChanges instead. </ds-inlinemessage>

Retrieves a list of items that match the criteria specified in the query.

If the user ID of the user making the call is the same as the user ID for any returned recipient, then the userId property is added to the returned information for those recipients.

get/v2.1/accounts/{accountId}/search_folders/{searchFolderId}

Path parameters

accountIdstring required

The external account number (int) or account ID GUID.

searchFolderIdstring required

Specifies the envelope group that is searched by the request. These are logical groupings, not actual folder names. Valid values are: drafts, awaiting_my_signature, completed, out_for_signature.

Query parameters

allstring

Specifies that all envelopes that match the criteria are returned.

countstring

The maximum number of results to return.

Use start_position to specify the number of results to skip.

Valid values: 1 to 100

from_datestring

Specifies the start of the date range to return. If no value is provided, the default search is the previous 30 days.

include_recipientsstring

When true, the recipient information is returned in the response.

orderstring

Specifies the order in which the list is returned. Valid values are: asc for ascending order, and desc for descending order.

order_bystring

Specifies the property used to sort the list. Valid values are: action_required, created, completed, sent, signer_list, status, or subject.

start_positionstring

The zero-based index of the result from which to start returning results.

Use with count to limit the number of results.

The default value is 0.

to_datestring

Specifies the end of the date range to return.

Response

Successful response.