curl --request GET \
--url https://api.docsautomator.co/esign/sessions/{sessionId} \
--header 'Authorization: Bearer <token>'{
"id": "<string>",
"documentName": "<string>",
"currentSignerIndex": 123,
"originalPdfUrl": "<string>",
"signedPdfUrl": "<string>",
"originalDocumentHash": "<string>",
"signedDocumentHash": "<string>",
"esignFields": [
{
"fieldId": "<string>",
"label": "<string>",
"required": true,
"value": "<string>",
"signedAt": "2023-11-07T05:31:56Z",
"signerIndex": 123
}
],
"signers": [
{
"index": 123,
"email": "<string>",
"name": "<string>",
"role": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"openedAt": "2023-11-07T05:31:56Z",
"signedAt": "2023-11-07T05:31:56Z",
"consentGivenAt": "2023-11-07T05:31:56Z",
"signingDurationSeconds": 123
}
],
"reminderEnabled": true,
"reminderDays": 123,
"webhookParams": {
"recId": "recAbC123XyZ",
"orderId": "ORD-123"
},
"expiresAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z"
}Get session details
Returns comprehensive signing session information including signer statuses, e-sign fields with positions, document hashes, and completion timestamps.
curl --request GET \
--url https://api.docsautomator.co/esign/sessions/{sessionId} \
--header 'Authorization: Bearer <token>'{
"id": "<string>",
"documentName": "<string>",
"currentSignerIndex": 123,
"originalPdfUrl": "<string>",
"signedPdfUrl": "<string>",
"originalDocumentHash": "<string>",
"signedDocumentHash": "<string>",
"esignFields": [
{
"fieldId": "<string>",
"label": "<string>",
"required": true,
"value": "<string>",
"signedAt": "2023-11-07T05:31:56Z",
"signerIndex": 123
}
],
"signers": [
{
"index": 123,
"email": "<string>",
"name": "<string>",
"role": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"openedAt": "2023-11-07T05:31:56Z",
"signedAt": "2023-11-07T05:31:56Z",
"consentGivenAt": "2023-11-07T05:31:56Z",
"signingDurationSeconds": 123
}
],
"reminderEnabled": true,
"reminderDays": 123,
"webhookParams": {
"recId": "recAbC123XyZ",
"orderId": "ORD-123"
},
"expiresAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z"
}Authorizations
API key from your workspace settings. Pass as Authorization: Bearer <key> or X-API-Key: <key>. Find it at app.docsautomator.co/settings/workspace/api.
Path Parameters
The signing session ID.
Response
Session details
pending, in_progress, completed, declined, cancelled sequential, parallel email, link Show child attributes
Show child attributes
Show child attributes
Show child attributes
Custom parameters passed in the original document creation request (webhookParams), returned verbatim. The trigger record identifier is folded in automatically — recId (Airtable, SmartSuite, Notion), taskId (ClickUp) or rowNumber (Google Sheets; positional at trigger time) — useful for correlating sessions with records in your data source. Caller-supplied keys are never overwritten. null when no identifier or parameters were provided.
{
"recId": "recAbC123XyZ",
"orderId": "ORD-123"
}