如何通过DocuSign API按多个自定义字段过滤信封？

要实现多自定义字段的AND逻辑过滤，直接在请求URL中重复使用custom_field参数即可，每个参数对应一个自定义字段的键值对，多个参数默认是“且”的关系。

示例请求（已URL编码）：

https://demo.docusign.net/restapi/v2.1/accounts/ACCOUNT_ID_NUMBER/envelopes?status=sent&custom_field=FIELD1%3DVALUE1&custom_field=FIELD2%3DVALUE2

如果需要OR逻辑过滤，DocuSign REST API v2.1的列表接口不支持直接通过URL参数实现，你可以选择两种方式：

• 先分别获取符合单个字段条件的信封列表，再在本地进行二次筛选合并；
• 使用DocuSign的Envelope Search API，通过构建搜索查询语句实现OR逻辑。

比如搜索API的POST请求体示例（请求地址为/restapi/v2.1/accounts/{accountId}/searches/envelopes）：

{
  "search_query": "custom_field(FIELD1,VALUE1) OR custom_field(FIELD2,VALUE2)",
  "statuses": ["sent"]
}

注意：搜索API需要确保账号具备对应权限，且查询语句格式要严格遵循DocuSign的规范。

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