Question regarding error responses from GET Envelope API

Question

Hello DocuSign Support Team,We are currently integrating with the DocuSign eSignature REST API v2.1 and have a question regarding the following endpoint:GET /v2.1/accounts/{accountId}/envelopes/{envelopeId}In our application, we use this endpoint to retrieve information about previously created envelopes. However, we have identified some cases where the request fails with errors that are not currently mapped in our application.One specific scenario we are investigating is related to the age of the envelope/signature. We have cases where the document was signed more than three months ago, and when we try to retrieve the envelope using the endpoint above, the request fails.Could you please confirm whether DocuSign has any retention, expiration, or API access limitation for envelopes or signatures older than three months?Additionally, we would like to know where we can find the official documentation for the possible errors returned by this endpoint, including the errorCode, HTTP status, and the conditions under which each error occurs.We want to properly map and handle these DocuSign errors in our application.Thank you for your assistance.

Iandro.Simoes · Answer

Hi ​@HarriHakaThere is no general three-month cutoff for retrieving envelopes. Envelopes and documents are stored indefinitely by default, although account retention or purge policies can remove data.A document purge can remove documents, attachments, tabs, and metadata while retaining recipient information, so a complete GET failure may indicate envelope-level removal or an access problem rather than age alone.If an older envelope cannot be retrieved, investigate: account-specific retention or purge policies; the envelope or its documents being deleted/purged; incorrect accountId or insufficient access.Here are the official reference for the API error codes:https://developers.docusign.com/docs/esign-rest-api/esign101/error-codes/Best regards,

Sign up

You can login or register as either a Docusign customer or developer. If you don’t already have a Docusign customer or developer account, you can create one for free when registering.

Docusign Community

You can login or register as either a Docusign customer or developer. If you don’t already have a Docusign customer or developer account, you can create one for free when registering.