Download audit trail
Returns the proof file of a request or of one signer.
MCP tool yousign_read → download_audit_trail
read
Returns a zip with one audit trail per signer for a completed request, or the PDF of one signer who has already signed. The audit trail holds the signer details, the authentication method, the signing context and the hash of the signed PDF. It needs a user with access to the request.
Parameters
| Name | Type | Description |
|---|---|---|
| signature_request_id string required | string | Signature request ID from list_signature_requests or create_signature_request. |
| signer_id string | string | Signer ID from get_signature_request. Leave out for the whole request, which works for a completed request. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "yousign_read",
"arguments": {
"operation": "download_audit_trail",
"arguments": {
"signature_request_id": "signature_request_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"file_name": "Service agreement audit trails.zip",
"signers": 3,
"size_bytes": 412672,
"download_url": "https://files.cotlet.dev/d/Hn4Zp7tRcB"
},
"isError": false
}