> **Source:** https://knowledge.leegality.com/document-execution/api/check-transaction-status > **Site:** Leegality Knowledge Base — https://knowledge.leegality.com > **About:** Leegality is a document execution platform covering eSigning, stamps, NeSL, workflows, and REST API integration. > **Navigation:** Every article on this site has a plain-text version at `.txt` (this format). To get an index of all articles with their `.txt` links, read: https://knowledge.leegality.com/llms.txt > **AI Guide:** For instructions on how to navigate this knowledge base as an AI agent, read: https://knowledge.leegality.com/ai-readable.txt --- # GET /v3.2/sign/request — Check transaction status Returns a lightweight summary of a document's transaction status, including signing state, download URLs, and signer certificate data. **Authentication:** `X-Auth-Token` header required on every request. ## Request URL ``` GET https://app1.leegality.com/api/v3.2/sign/request?documentId={documentId} ``` **Environments:** - Production: `https://app1.leegality.com/api/v3.2/sign/request` - Sandbox: `https://sandbox.leegality.com/api/v3.2/sign/request` --- ## Parameters | Name | In | Required | Type | Description | Example | |------|----|----------|------|-------------|---------| | `documentId` | query | Yes | string | Unique identifier of the document to check. **Format:** Alphanumeric string (e.g., `01KJCHZ1Z3XRFP04DPT195AJH6`). Get from the **Create eSigning request** API response or from the dashboard. | — | --- ## Responses ### 200 — Transaction status retrieved successfully. Response wrapper for the Transaction Status API. Contains the transaction data, status code, and any messages. | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `status` | integer | No | Indicates API response status. `1` = success, `0` = failure. Allowed: `0`, `1`. | `1` | | `messages` | array\ | No | Array of response messages. Empty array on success. See **Message** below. | — | | `data` | TransactionStatusData | No | Transaction status data for a document. Contains the document identifier, signing status of each invitee, download URLs for files and audit trail, and signer certificate data for signed documents. See **TransactionStatusData** below. | — | #### Message Message object containing a machine-readable code and a human-readable description. Used for success confirmations, errors, and warnings. | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `code` | string | No | Response message code. | `simpleWorkFlow.success` | | `message` | string | No | Human-readable success or error message. | `Invitations sent successfully.` | #### TransactionStatusData Transaction status data for a document. Contains the document identifier, signing status of each invitee, download URLs for files and audit trail, and signer certificate data for signed documents. | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `documentId` | string | No | Unique identifier of the document. - **Format:** Alphanumeric string. | `01KJCHZ1Z3XRFP04DPT195AJH6` | | `irn` | string | No | Invitation Reference Number — the unique reference you passed when creating the eSigning request. Returns `null` if no IRN was set during document creation. | `INV-2026-001` | | `folderId` | string | No | Unique identifier of the folder the document belongs to. Returns `null` if the document is not assigned to any folder. | — | | `files` | array\ | No | CDN download URLs for the document PDF(s). Always present in the response, even for unsigned or rejected documents. URLs are time-limited and will expire. | — | | `auditTrail` | string | No | CDN download URL for the audit trail PDF. **Only present when the document has been signed/completed.** For unsigned, rejected, or expired documents, this field is absent from the response. The URL is time-limited and will expire. | `https://sandbox-downloads.leegality.com/export/2026/03/02/a4` | | `requests` | array\ | No | Array of invitee (signer/approver) status objects. Each entry represents one invitee and their current signing status. See **TransactionStatusRequest** below. | — | | `signers` | array\ | No | Certificate data extracted from the digital signature of each signer. **Only present when the document has been signed/completed.** For unsigned, rejected, or expired documents, this field is absent from the response. Contains verified identity information from the signer's Aadhaar certificate. See **TransactionStatusSigner** below. | — | ##### TransactionStatusRequest Signing status of an individual invitee. Uses boolean fields (`signed`, `rejected`, `expired`) to indicate the invitee's current state. | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `name` | string | No | Full name of the invitee. | `Abhishek Sharma` | | `email` | string | No | Email address of the invitee. | `signer@example.com` | | `phone` | string | No | Mobile number of the invitee. - **Format:** 10-digit Indian mobile number. | `9876543210` | | `signUrl` | string | No | Unique signing URL for this invitee. The invitee uses this URL to access the signing page. | `https://sandbox.leegality.com/sign/2bdcc3ef-661f-440c-b059-8` | | `signed` | boolean | No | Whether the invitee has signed the document. - `true` — signed - `false` — not yet signed | `true` | | `rejected` | boolean | No | Whether the invitee has rejected the document. - `true` — explicitly rejected by the invitee - `false` — not rejected | `false` | | `expired` | boolean | No | Whether the invitee's signing invitation has expired. - `true` — expired (time-based expiry or verification failure) - `false` — not expired - **Note:** Also set to `true` when certificate verification fails during signing (e.g., Aadhaar details mismatch, DSC details mismatch). | `false` | | `expiryDate` | string | No | Expiry date and time for the signing invitation. - **Format:** `dd-MM-yyyy HH:mm:ss` | `08-03-2026 23:59:59` | | `signType` | string | No | Type of signature used by the invitee. Returns `null` if the invitee has not signed yet. - **Possible values:** `AADHAAR`, `VIRTUAL`, `DSC` Allowed: `AADHAAR`, `VIRTUAL`, `DSC`. | `AADHAAR` | | `active` | boolean | No | Whether it is currently the invitee's turn to act. - `true` — the invitee can currently sign or approve the document | `true` | ##### TransactionStatusSigner Certificate data extracted from a signer's digital signature. Contains verified identity information from the Aadhaar certificate used during signing. | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `name` | string | No | Full name as it appears on the signer's Aadhaar certificate. | `Abhishek Sharma` | | `pincode` | string | No | Pincode from the signer's Aadhaar certificate. - **Format:** 6-digit string. | `247667` | | `state` | string | No | State from the signer's Aadhaar certificate. | `Uttarakhand` | | `title` | string | No | Title/locality code from the signer's Aadhaar certificate. This is typically a numeric code representing the locality. | `3870` | ### Sample Response (200) ```json { "status": 1, "messages": [ { "code": "simpleWorkFlow.success", "message": "Invitations sent successfully." } ], "data": { "documentId": "01KJCHZ1Z3XRFP04DPT195AJH6", "irn": "INV-2026-001", "folderId": "string", "files": [ "https://sandbox-downloads.leegality.com/export/2026/03/02/c9845ec1-..." ], "auditTrail": "https://sandbox-downloads.leegality.com/export/2026/03/02/a441a5e8-...", "requests": [ { "name": "Abhishek Sharma", "email": "signer@example.com", "phone": "9876543210", "signUrl": "https://sandbox.leegality.com/sign/2bdcc3ef-661f-440c-b059-82c0ff6ce4d8", "signed": true, "rejected": false, "expired": false, "expiryDate": "08-03-2026 23:59:59", "signType": "AADHAAR", "active": true } ], "signers": [ { "name": "Abhishek Sharma", "pincode": "247667", "state": "Uttarakhand", "title": "3870" } ] } } ```