List signature requests
Lists signature requests with their status and signers.
GET https://cotlet.dev/api/v1/yousign/signature-requests
read
Returns each request with its ID, name, status, creation date and a signer count. Requests come as the Signatures page lists them. Any role in the workspace can read the list it can see in the app.
Parameters
| Name | Type | Description |
|---|---|---|
| status string | string | Only requests with this status, as the Signatures page shows it, for example In progress or Completed. Leave out for all. |
Request
curl https://cotlet.dev/api/v1/yousign/signature-requests \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("yousign", "list_signature_requests")const result = await cotlet.call('yousign', 'list_signature_requests');cotlet call yousign list_signature_requestsExample response
{
"signature_requests": [
{
"id": "8c1d4e7a-52b9-4f03-a6d8-91e0b3c5f274",
"name": "Service agreement",
"status": "In progress",
"created_at": "2026-10-14T09:12:00Z",
"signers": 3,
"signed": 1
},
{
"id": "2a7f9e10-3b4c-4d85-a6e1-7c90d2b8f351",
"name": "Lease renewal",
"status": "In progress",
"created_at": "2026-10-19T14:40:00Z",
"signers": 2,
"signed": 1
}
]
}