列出签名请求

返回您可以访问的 SignatureRequest 列表。这包括您已发送和收到的签名请求，但不包括您抄送的签名请求。请查看我们的[搜索指南](/api/reference/search/)，了解有关查询签名请求的更多信息。

通过完整的 Dropbox Sign v3 API 管理账户、签名请求、模板、团队、批量发送、文件下载、传真和事件回调；Hub 仅提供文档与本地 SDK/CLI。

请求

operationId: signatureRequestList
服务器: https://api.hellosign.com/v3
认证: api_key, oauth2

请求参数

`account_id`

querystring

向哪个账户返回 SignatureRequests。必须是团队成员。使用 `all` 表示所有团队成员。默认为您的账户。

example-account-id

`page`

queryinteger

返回 SignatureRequest 列表的页码。默认为 `1`。

`page_size`

queryinteger

每页要返回的对象数。必须在 `1` 和 `100` 之间。默认为 `20`。

`query`

querystring

包含用于过滤 SignatureRequest 对象的搜索词和/或字段的字符串。

响应

`200`

SignatureRequestListResponseapplication/json

成功响应

字段: signature_requestslist_infowarnings

`4XX`

ErrorResponseapplication/json

操作失败

字段: error

{
  "signature_requests": [
    {
      "test_mode": false,
      "signature_request_id": "example-signature-request-id",
      "requester_email_address": "developer@example.com",
      "title": "Example document",
      "original_title": "Example document",
      "subject": "Example document",
      "message": "Example message",
      "metadata": {}
    }
  ],
  "list_info": {
    "num_pages": 0,
    "num_results": 0,
    "page": 0,
    "page_size": 0
  },
  "warnings": [
    {
      "warning_name": "Example Name"
    }
  ]
}