KYC Check

Check your investor's kyc status

Use this API to check if your investor's identity detail exists in any of the KRAs (KYC Registration Agencies) database. If it exists, you'll get certain demographic information of the investor and the status of the KYC in the response object.

Check kyc status

Call the KYC Check with the investor's Income Tax Permanent Account Number (PAN)

{

    "pan": "ARRPP1115N",
    "date_of_birth": "1955-10-25"

}

Status

# Displaying only a part of the object for brevity
{
  "id": "5620fd1f-eb14-442e-b0ee-da96a6c305c0",
  "pan": "BNBPP9384M",
  "status": false,
  "reason":"unavailable",
  "action":"create"
}

If the status in the response object is true, it means that the investor is either KYC compliant or his KYC application is successfully accepted for review and is under process (with proof of address as any document except Aadhaar). You can go ahead and onboard the investor and place purchase and redemption orders if status is true.

If the value of the status attribute in the response object is false, the investor is not kyc compliant and you cannot accept investments from the investor. In such cases, the value of the attribute reason tells us the reason why the investor is non-compliant and the value of the attribute action tells us what action you can take to help investor become kyc compliant.

Note: If status is true, the values of reason and action will always be null.

Non compliance reasons

Action required for compliance

Investor Details

The entity_details in the response object will contain the investor's demographic information. If you are checking for the KYC status, you'll get the name of the investor. If you are fetching the KYC details of an investor, then the entity_details list in the response object will contain Identity, Address and Contact information of the investor as shown below:

# Displaying only a part of the object for brevity

"entity_details": {
        "name": "Tony Soprano",
        "gender": "male",
        "date_of_birth": "1955-10-25",
        "father_name": "James Soprano",
        "marital_status": "married",
        "nationality": "indian",
        "residential_status": "resident_individual",
        "correspondence_address": {
            "line_1": "19th main, 33rd cross",
            "line_2": "Jayanagar 4th T block",
            "line_3": null,
            "city": "Bengaluru",
            "pincode": "560041",
            "state": "Karnataka",
            "country": "India"
        },
        "permanent_address": null,
        "email": "tony.soprano@gmail.com",
        "mobile": "9123498765"
}

Testing

To test the various scenarios in your application during the development process, use the following formats of PAN number and date of birth in the sandbox environment.