> **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 `<article-url>.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\<Message\> | 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\<string\> | 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 completed i.e. signed by all required invitees.** 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\<TransactionStatusRequest\> | No | Array of invitee (signer/approver) status objects.  Each entry represents one invitee and their current signing status. See **TransactionStatusRequest** below. | — |
| `signers` | array\<TransactionStatusSigner\> | No | Certificate data of invitee's digital signature — one entry per signature embedded in the final PDF.  **Only present when the document has been completed (signed by all required invitees).** For unsigned, rejected, or expired documents, this field is absent from the response.  The values in each entry depend on the eSign type:  - **Aadhaar, Doc Signer, DSC, or NeSL** — Digital signature certificate details (name, pincode, state, title). - **Virtual, Visual, or Quick Sign** — Leegality's details, since these are signed with Leegality acting as the Application Service Provider (ASP), the entity providing the platform used to eSign. - **External Signature Details:** If the document already has a signature applied via other platforms like DocuSign or Adobe, then their details appear too. 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 single digital signature in the document.  Depending on the sign type, the fields reflect the individual signer's certificate (Aadhaar, Document Signer, DSC, NeSL), Leegality's details (Virtual, Visual, Quick Sign), or the details of another platform if the document was already signed via one (e.g., DocuSign, Adobe).

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `name` | string | No | Name recorded on the signing certificate.  - **Aadhaar, Document Signer, DSC, NeSL** — the signer's name as per digital certificate. - **Virtual, Visual, Quick Sign** — Leegality's details: "DS Grey Swift Private Limited" (the Leegality entity). - If the document already has a signature applied via other platforms like DocuSign or Adobe — that platform's organisation name (e.g., "DocuSign, Inc."). | `Abhishek Sharma` |
| `pincode` | string | No | Pincode as per digital signature certificate. Returns `null` when not present (e.g., Virtual, Visual, Quick Sign, or signatures applied via other platforms like DocuSign or Adobe).  - **Format:** 6-digit string. | `110053` |
| `state` | string | No | State as per digital signature certificate.  - Individual digital certificates (Aadhaar, Document Signer, DSC, NeSL). - Virtual, Visual, Quick Sign — "HR" (Haryana), where Leegality is registered. - Signatures applied via other platforms like DocuSign or Adobe — that platform's location. | `Delhi` |
| `title` | string | No | Title (last 4 Aadhaar number digits). - Returns `null` for Virtual, Visual, Quick Sign, or signatures applied via other platforms like DocuSign or Adobe. | `1234` |

### 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": "110053",
        "state": "Delhi",
        "title": "1234"
      }
    ]
  }
}
```