Reputation: 13
I want to be able to query the DocuSign REST API for a list of envelopes that are associated with a signer's email address, which I will pass in with my API query.
This would be the same functionality as going to DocuSign.net, then clicking on Manage, and then entering a signer's email address in the search bar ( of course customizing the search parameters ), and being presented all documents associated with that email address.
The only material I've found so far in the API guide is to get a list of envelopes, then a list of documents, and then a list of details per document...that's a lot of looping to perform what appears to be a simple search done through the GUI.
Thanks for any assistance.
Upvotes: 1
Views: 303
Reputation: 2702
There is a REST API call called search_folders, which can be used to return information about envelopes in a specific state, date range, and includes details on the recipients. You would still need to post-process the results for the recipients in question, but it prevents multiple API calls (IMO).
Get List of Envelopes in Folders This returns a list of envelopes that match the criteria specified in the query.
URL: /accounts/{accountId}/search_folders/{search_folder}
Optional query additions: start_position={integer}, count={integer}, from_date={date/time}, to_date={date/time}, order_by={string}, order={string}, include_recipients={true/false}, all
Upvotes: 1