DocuSign API method envelopes.listStatusChanges doesn't show envelopes shared to my user

Question

I'm calling listStatusChanges with an http GET similar to this: .../restapi/v2/accounts//envelopes?from_date=&start_position=0&count=50

It works for envelopes owned by anyone when my current user has permission of DS Admin. It works for envelopes owned by my current user when my user has permission of DS Sender.

However, I have certain users who have shared their envelopes mo my current user. In the DocuSign user interface, I see these Shared Envelopes . But this sharing seems to have no impact on this API call. The shared envelopes are not visible unless I have DS Admin permission.

Is this working correctly? Is it a bug? Am I doing something wrong?

Thank you

Answer 1

If you know other user's userId then you can use below API call to see that user's shared envelopes. You must specifically call that out in the request through the user_id parameter, and only one other user can be queried for per API call.

/restapi/v2.1/accounts/{{accountId}}/envelopes?from_date=2019-07-15T08:00:00.000Z&user_id=87b00103-461d-487b-8928-1991dfdb8d20

where 87b00103-461d-487b-8928-1991dfdb8d20 is the userId of the other user whose envelopes you want to see.

Note the use of /v2.1/ in this call's URL. The /v2/ version of this call does not correctly respect Envelope Sharing, but /v2.1/ has corrected this issue and will not require the use of DS Admin permissions.

Answer 2

I reached Drew M. in DocuSign Developer Support. He provided this answer:

I've tested this on my account, and it does look like that API call doesn't correctly respect Sharing, so at this time it does require Admin rights. I'll be filing a product issue about this, and I'll let you know what I hear back.

Subsequently, Drew reported that this was in fact fixed in v2.1, per his comment below.