GET
/
form
Get KYC Link Status
curl --request GET \
  --url https://sandbox.cashfree.com/verification/form \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>'
{
  "name": "John Doe",
  "phone": 9999999999,
  "email": "test@cashfree.com",
  "verification_id": "testverificationid",
  "reference_id": 235461,
  "link_expiry": "2025-12-02",
  "form_link": "https://forms.cashfree.com/",
  "form_status": "PENDING",
  "verification_details": [
    {
      "reference_id": 234,
      "type": "OFFLINE_AADHAAR_VERIFICATION",
      "status": "SUCCESS"
    }
  ]
}

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

​
verificationID
string
default:ABC00123

It is the unique ID you created to identify the KYC link.

Example:

"ABC00123"

​
referenceID
string
default:235461

It is the unique ID you receive in the response of Generate KYC Link API.

Example:

"235461"

Response

200
application/json

Response Body of VRS GetFormStatus API

The response is of type object.