Docusign SDK check envelope status

0
votes

Currently, I am having a schedule job which get all uncompleted envelope status from my system and check each envelope status update from docusign via docusign sdk (Envelope env = envelopesApi.getEnvelope(accountId, envelopeId)). The reason to use that api is there are different use cases for each envelope status.

But I see that polling api (EnvelopesInformation envelopes = envelopesApi.ListStatusChanges(accountId, options)) has limitation that not allowed to poll DocuSign more than once every 15 minutes. I don't use this api now.

So is there any problems/limitation for envelopesApi.getEnvelope(accountId, envelopeId))?

Thanks.

1
docusignapi

1 Answers

1
votes

The getEnvelope() and the listStatusChanges() requests both have the same polling limitation in place, if you start calling either too much your API key might get throttled or temporarily disabled by DocuSign.

However, since the listStatusChanges() request returns status on a whole set of envelopes instead of just one envelope at a time this is the preferred API request when polling the DocuSign platform.

Furthermore, the truly optimal option which doesn't count at all against the platform limits is using DocuSign webhooks to push status out to your app instead of your app constantly polling. You can configure webhooks either through the DocuSign Connect module or by using eventNofications through the envelope structure.

Learn more about DocuSign Webhooks.