---
title: "Use this API to check transaction status"
method: GET
path: "/v2.1/sign/request"
tags: ["Document Execution Platform"]
---

# Use this API to check transaction status

`GET /v2.1/sign/request`

You need to call this API with the documentId to get the status of the transaction and/or to fetch the latest version of the document, and the Audit Trail if the document has been completed.
Response for the Details API is also the same as the Success Webhook Data apart from the signType parameter. signType parameter will only be provided in the Webhook Data, and not in the Response to the Details API.
    
**Note:** This API cannot retrieve data for documents that were deleted manually from the dashboard or automatically using the "delete on complete" option.

  **Important:** Fair use limits may apply to GET APIs to ensure system stability.

## Query parameters

- `documentId` string, required

## Response `200`

Response Data

- DetailsApiResponse
  - `status` integer — if success then 1, else 0.
  - `messages` Message[]
    - `code` string — Message Code.
    - `message` string — Success/Error Message.
  - `data` DetailsApiResponseData
    - `documentId` string — Same as the documentId passed in GET call.
    - `irn` string — Internal Reference Number.
    - `folderId` string — Folder ID.
    - `requests` InviteeRequest[]
      - `name` string — Name of the invitee.
      - `email` string — Email of the invitee.
      - `phone` string — Phone Number of the invitee.
      - `signUrl` string — User specfic URL unique to the request.
      - `active` boolean — Status of the URL.
      - `signed` boolean — Request eSigning status.
      - `rejected` boolean — Request rejection status.
      - `expired` boolean — Request expiration status.
      - `expiryDate` string — Expiry date of the signing invite - DD-MM-YYYY HH:MM:SS. Note: If expiryDate is null, expiry is set as 45 minutes.
      - `signType` string — This parameter will be there only for Webhook when the document has been signed. In case the transaction was of approver transaction then the value will be NULL. Possible values are- AADHAAR, VIRTUAL_SIGN, DSC, DOC_SIGNER, AUTOMATED_SIGN, QUICK_SIGN
    - `files` string[] — Base64 encoded string format of latest version of the document.
    - `auditTrail` string — Base64 encoded string format of the Audit Trail generated on completion of the document.
    - `signers` Signer[]
      - `name` string — Name of signer as contained in the Digital Signature Certificate in case of Aadhaar, DSC, Doc Signer and Automated Signer. In case of Virtual Sign, Quick Sign and Automated Virtual Sign, the name will be the name used for eSigning the document.
      - `pincode` string — PIN Code of signer as contained in the Digital Signature Certificate in case of Aadhaar, DSC, Doc Signer and Automated Signer. Value will be provided only if available in the certificate.
      - `state` string — State of signer as contained in the Digital Signature Certificate in case of Aadhaar, DSC, Doc Signer and Automated Signer. Value will be provided only if available in the certificate.
      - `title` string — Last 4 digit of the unique identifier of signer as contained in the Digital Signature Certificate issued after Aadhaar authentication. Only works for Aadhaar eSign. Value will be provided only if available in the Certificate.

---

[API](https://skmtc.dev/leegality/apis/leegality-documentation-gateway.md) · [All operations](https://skmtc.dev/leegality/apis/leegality-documentation-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/leegality/leegality-documentation-gateway/revisions/0290f3a2dc73/schema)