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

Parameters: get_signature_request
NameTypeDescription
signature_request_id string required string Signature request ID from list_signature_requests or create_signature_request.

Request

cURL
curl https://cotlet.dev/api/v1/yousign/signature-requests/signature_request_8c41d2 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("yousign", "get_signature_request", {"signature_request_id":"signature_request_8c41d2"})
Node.js
const result = await cotlet.call('yousign', 'get_signature_request', {"signature_request_id":"signature_request_8c41d2"});
CLI
cotlet call yousign get_signature_request --data '{"signature_request_id":"signature_request_8c41d2"}'

Example response

JSON

{
  "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"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.