GET
/
esignature
Get E-Sign Status
curl --request GET \
  --url https://sandbox.cashfree.com/verification/esignature \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>'
{
  "status": "IN_PROGRESS",
  "reference_id": 32,
  "verification_id": "ESTestVERID34",
  "document_id": 36,
  "signers": [
    {
      "name": "John Doe",
      "status": "SUCCESS",
      "is_notified": true,
      "meta_data": {
        "name": "John Doe",
        "gender": "M",
        "year_of_birth": "1990",
        "postal_code": "560012",
        "state": "Karnataka",
        "country": "India",
        "serial_number": "ABC123456789",
        "ip_address": "192.168.1.1",
        "latitude": "12.9716",
        "longitude": "77.5946",
        "signing_time": "2023-10-01T12:00:00Z",
        "aadhaar_last_four_digits": "1234"
      }
    },
    {
      "name": "Frank Kelvin",
      "status": "SIGN_IN_PROGRESS",
      "is_notified": true,
      "meta_data": {
        "name": null,
        "gender": null,
        "year_of_birth": null,
        "postal_code": null,
        "state": null,
        "country": null,
        "serial_number": null,
        "ip_address": null,
        "latitude": null,
        "longitude": null,
        "signing_time": null,
        "aadhaar_last_four_digits": null
      }
    }
  ],
  "signed_doc_url": "SIGNED_DOC_URL"
}

Authorizations

​
x-client-id
string
header
required

Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.

​
x-client-secret
string
header
required

The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your Merchant Dashboard.

Headers

​
x-cf-signature
string

Send the signature if IP is not whitelisted.

Query Parameters

​
reference_id
integer
default:54321

It is the unique ID created by Cashfree Payments that you receive in the response of Create E-Sign Request API. format: int64

​
verification_id
string
default:ABC00123

It is the unique ID you create to identify the Create E-Sign Request API.

Response

200
application/json

Success response for retrieving the status of an e-signature request

The response is of type object.