v1

latestSwagger 2.02026-07-134146194.6 MB
BulkSend

Gets envelopes from a specific bulk send batch.

This method returns a list of envelopes in a specified bulk batch. Use the query parameters to filter and sort the envelopes by different attributes.

get/v2.1/accounts/{accountId}/bulk_send_batch/{bulkSendBatchId}/envelopes

Path parameters

accountIdstring required

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

bulkSendBatchIdstring required

The batch ID.

Query parameters

countstring

The maximum number of results to return.

Use start_position to specify the number of results to skip.

Valid values: 1 to 1000

includestring

When recipients, only envelopes with recipient nodes will be included in the response.

orderstring

The order in which to sort the results. Valid values are:

  • Descending order: desc (default)
  • Ascending order: asc
order_bystring

The envelope attribute used to sort the results. Valid values are:

  • created (default)
  • completed
  • last_modified
  • sent
  • status
  • subject
  • status_changed
search_textstring

Use this parameter to search for specific text.

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.

statusstring

Comma-separated list of envelope statuses.

Note that any should not be included with other statuses. In other words, any is a valid parameter value, but any,sent is not.

Use the value deliveryfailure to get all envelopes with AuthFailed and AutoResponded status. This value is specific to bulk sending.

Response

Successful response.