Get signature request
Returns one request with its signers, documents and settings.
GET https://cotlet.dev/api/v1/yousign/signature-requests/{signature_request_id}
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. |
Request
curl https://cotlet.dev/api/v1/yousign/signature-requests/signature_request_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY" result = client.call("yousign", "get_signature_request", {"signature_request_id":"signature_request_8c41d2"}) const result = await cotlet.call('yousign', 'get_signature_request', {"signature_request_id":"signature_request_8c41d2"}); cotlet call yousign get_signature_request --data '{"signature_request_id":"signature_request_8c41d2"}' Example response
{
"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"
}
]
}