List signature requests
Lists signature requests with their status and signers.
MCP tool yousign_read → list_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. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "yousign_read",
"arguments": {
"operation": "list_signature_requests",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"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
}
]
},
"isError": false
}