Get signature request
Returns one request with its signers, documents and settings.
MCP tool yousign_read → get_signature_request
read
Returns the status, expiration date, each signer with name, email and status, and the documents. Use it to see who has not signed. A request in Draft shows no signer progress yet.
Parameters
| Name | Type | Description |
|---|---|---|
| signature_request_id string required | string | Signature request ID from list_signature_requests or create_signature_request. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "yousign_read",
"arguments": {
"operation": "get_signature_request",
"arguments": {
"signature_request_id": "signature_request_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"id": "8c1d4e7a-52b9-4f03-a6d8-91e0b3c5f274",
"name": "Service agreement",
"status": "In progress",
"expires_at": "2027-04-14",
"signers": [
{
"id": "b7e2a9d4-1c63-4a58-8f0e-d35c6a41b2f9",
"name": "Tom Becker",
"email": "tom@example.com",
"status": "Notified"
},
{
"id": "e41c8d70-9a2b-4f6e-b153-6d0a7c2e98f4",
"name": "Maya Chen",
"email": "maya@example.com",
"status": "Signed"
},
{
"id": "0f93b6d2-4e17-4a8c-95d1-a8e3c7b02f65",
"name": "Lena Ortiz",
"email": "lena@example.com",
"status": "Notified"
}
],
"documents": [
{
"name": "Service agreement.pdf"
}
]
},
"isError": false
}