如何通过DocuSign API获取委托/新分配签署人信息？

你提到用审计日志API处理多委托场景时不够高效，确实有更直接的方式来获取委托/新分配的签署人信息，下面是两个核心的API接口方案：

1. 获取当前所有收件人（含委托后的新签署人） #

调用GET /v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients接口，这个接口会返回信封当前所有的收件人信息，包括被委托的新签署人，而且能清晰看到委托关系。

关键字段说明：

• 每个收件人对象里的recipientId、name、email、recipientType是基础信息
• relatedRecipients字段是重点：它会记录委托的关联关系，比如被委托的收件人会有一个type为assignor的条目，指向原来发起委托的签署人ID、姓名等信息，同时还会包含委托操作的时间戳。

这个接口的优势是直接拿到当前生效的收件人状态，不需要从日志里筛选，适合快速获取最新的委托结果。

2. 获取完整的收件人变更/委托历史 #

如果需要追踪多委托的完整链路（比如多次转委托的记录），可以调用GET /v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients/history接口。

这个接口专门返回收件人的所有变更历史，每一条记录都会包含：

• 操作类型（比如Assign，明确是委托操作）
• 操作发起者（原签署人）
• 操作时间
• 新收件人的详细信息
• 变更的原因描述

相比审计日志API，这个接口的结果是已经按收件人变更维度整理好的，不需要自己筛选事件类型，处理多委托场景更高效。

补充说明 #

• 确保你的API调用账号拥有Envelope Read权限，否则可能无法访问这些接口的完整数据
• 如果你还是需要结合审计日志，记得筛选AssignRecipient类型的事件，但优先推荐上面两个专门针对收件人的接口，更贴合你的需求

内容的提问来源于stack exchange，提问作者Suhas