Hi everyone,
I’m running into an issue where I cannot retrieve the actual comment data from an envelope using the primary Get Envelope endpoint, even when including all relevant parameters.
The Goal: I want to retrieve the contents of commentThreadTabs (specifically the comments array) in a single request to avoid making multiple calls per envelope.
The Problem: When calling GET /v2.1/accounts/{accountId}/envelopes/{envelopeId} with the following query parameters: ?include=workflow,documents,custom_fields,recipients,tabs,prefill_tabs
The response returns the commentThreadTabs object, but the comments array inside it is always empty.
Observations:
-
If I use the specific
GET /v2.1/accounts/{accountId}/envelopes/{envelopeId}/documents/{documentId}/tabsendpoint, the comments are populated correctly. -
However, the documentation for the main Get Envelope endpoint implies that
include=tabsshould return the full tab schema, which includes the comment threads.
Questions:
-
Is it by design that the
commentsarray withincommentThreadTabsis excluded from the main Envelope response? -
Is there a specific
includevalue or header required to "hydrate" these comment arrays in a single call?
Any insights would be greatly appreciated!
Back to Docusign.com


