Skip to main content
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": "[email protected]",
  "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

Client ID. You can find your ID in the Merchant Dashboard.

​
x-client-secret
string
header
required

Client secret key. You can find your secret key in the 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

Response Body of VRS GetFormStatus API

​
name
string

It displays the name of the individual.

Example:

"John Doe"

​
phone
string

It displays the phone number of the individual.

Example:

9999999999

​
email
string

It displays the email address of the individual.

Example:

"[email protected]"

​
verification_id
string

It displays the unique ID you created to identify the form.

Example:

"testverificationid"

​
reference_id
integer

It displays the unique ID created by Cashfree Payments for reference purposes.

Example:

235461

​
link_expiry
string

It displays the expiry date of the link.

Example:

"2025-12-02"

​
form_link
string

It displays the URL of the form.

Example:

"https://forms.cashfree.com/"

​
form_status
string

It displays the status of the form.

Example:

"PENDING"

​
verification_details
object[]