CKYC Fetch v3
CKYC Fetch API is a powerful tool designed to simplify the extraction of essential customer information based on their unique CKYC number. With just a single API call, you can access a comprehensive set of data points, providing you with a deeper understanding of your customer's identity. You can access the individual’s details such as Date of Birth, PAN number, address, Parent’s details, Contact details, KYC declaration details ensuring compliance with regulatory requirements, identity details, and images associated with the CKYC account, enhancing identity verification and personalization.
API details
Endpoint
POST https://api.signzy.app/api/v3/ckyc-onprem/fetchPOST https://api-preproduction.signzy.app/api/v3/ckyc-onprem/fetchRequest headers
Name | Value | Required | Description |
|---|---|---|---|
Content-Type | application/json | Mandatory | The type of content that the request body contains. |
Authorization | XXXXXXXXXXXXXXX | Mandatory | An authentication token to authorize the request. Reach out to the Signzy support team to get one created. |
Request body parameters
Parameter | Data Type | Description | Required |
|---|---|---|---|
ckycNumber | String | 14-digit Central KYC number associated with the individual. | Mandatory |
authFactorType | String | The type of authentication to be used. For possible inputs, Refer to the table Authorization Factor Types below. | Mandatory |
authFactorValue | String | The value associated with the authentication factor type used. For possible inputs, Refer to the table Authorization Factor Types below. | Mandatory |
env | String | "preproduction" (Pass specifically "preproduction" only if you want to hit CERSAI Sandbox, else do not pass this field) | Mandatory |
{
"ckycNumber": "LEVWXI96290429",
"authFactorType": "01",
"authFactorValue": "06-01-1999",
"env": "preproduction"
}Authorization Factor Types
authFactorType | authFactorValue | authFactorValue-Format |
|---|---|---|
01 | Date of Birth of the Individual. | DD-MM-YYYY |
02 | Pincode of the registered address and Year of Birth. | XXXXXXYYYY Where XXXXXX is the Pincode and YYYY is the Birth Year. |
03 | 10-digit Mobile number corresponding to the CKYC number. | 0000000000 |
Code samples
curl --location 'https://api-preproduction.signzy.app/api/v3/ckyc-onprem/fetch' \
--header 'Content-Type: application/json' \
--header 'Authorization: <authkey>' \
--data '{
"ckycNumber": "LEVWXI96290429",
"authFactorType": "01",
"authFactorValue": "06-01-1999",
"env": "preproduction"
}'Request body parameters
Parameter | Data Type | Description | Required |
|---|---|---|---|
result | Object | An object containing the result of the task | Mandatory |
requestId | String | Request ID generated | Mandatory |
message | String | Response message received from CKYC | Mandatory |
// For INDIVIDUAL
{
"result": {
"requestId": "489329",
"message": "OTP has been sent to the registered mobile number XXXXXX6045"
}
}
// For LEGAL ENTITY
{
"result": {
"personalDetails": {
"constitutionType": "01",
"accountHolderType": "04",
"ckycNumber": 00000000000000,
"prefix": "MR",
"firstName": "FIRST NAME",
"middleName": "",
"lastName": "LAST NAME",
"fullName": "FULL NAME",
"maidenPrefix": "",
"maidenFirstName": "",
"maidenMiddleName": "",
"maidenLastName": "",
"maidenFullName": "",
"fatherSpouseFlag": "01",
"fatherSpousePrefix": "Mr",
"fatherSpouseFirstName": "FATHER/SPOUSE FIRST NAME",
"fatherSpouseMiddleName": "",
"fatherSpouseLastName": "",
"fatherSpouseFullName": "FATHER/SPOUSE FULL NAME",
"motherPrefix": "Ms",
"motherFirstName": "MOTHER FIRST NAME",
"motherMiddleName": "",
"motherLastName": "",
"motherFullName": "MOTHER FULL NAME",
"gender": "M",
"dob": "DD/MM/YYYY",
"pan": "XXXX0000X",
"formSixty": "",
"address": {
"permLine1": 00000,
"permLine2": "ADDRESS LINE",
"permLine3": "HYDERABAD 506003",
"permCity": "HYDERABAD",
"permDistrict": "Warangal",
"permState": "TS",
"permCountry": "IN",
"permPin": 00000,
"permPoa": "09",
"permCorresFlag": "Y",
"corresLine1": 000000,
"corresLine2": "ADDRESS LINE",
"corresLine3": "HYDERABAD 506003",
"corresCity": "HYDERABAD",
"corresDistrict": "Warangal",
"corresState": "TS",
"corresCountry": "IN",
"corresPin": 506003,
"corresPoa": "09"
},
"residenceStdCode": "",
"residenceTelephoneNumber": "",
"officeStdCode": "",
"officeTelephoneNumber": "",
"mobileCode": 91,
"mobileNumber": 0000000000,
"email": "[email protected]",
"remarks": "ADDL File",
"declarationDate": "DD/MM/YYYY",
"declarationPlace": "HYDERABAD",
"kycDate": "********",
"documentSubmitted": "02",
"kycName": "********",
"kycDesignation": "********",
"kycBranch": "********",
"kycEmpCode": "********",
"numberOfIdentity": 1,
"numberOfRelatedPersons": "",
"numberOfImages": 4
},
"identityDetails": [
{
"sequenceNumber": 1,
"identityType": "H",
"identityNumber": "XXXXXXXX0000",
"idVerificationStatus": "02"
}
],
"imageDetails": [
{
"sequenceNo": 1,
"imageType": "jpeg",
"imageCode": "02",
"globalFlag": "01",
"branchCode": "<Branch code>",
"imageData": "https://files.signzy.tech/api/files/707440923/download/0000000.jpeg"
}
],
"relatedPersonDetails": []
}
}Supporting ID Type
idType | idNumber |
|---|---|
A | Format: “Last 4 digits in Aadhaar Number|FirstName+ MiddleName + Lastname|DOB|Gender”. Name cannot be more than 150 characters. Date Of Birth in format DD-MM-YYYY. Gender can be M or F or T Example: “0000|Ayush Kumar|23-02-1990|M” |
P | Pan Number |
D | Driving License |
V | Voter ID |
F | NREGA Job Card |
G | National Population Register Letter |
Z | CKYC Identifier |
I | Certificate of Incorporation/Formation |
R | Registration Certificate |
PP | Passport Number |
CKYC Image Codes Description
Image Code Description
Image Code | Description |
|---|---|
02 | Photograph |
03 | PAN |
04 | Proof of Possession of Aadhaar |
05 | Passport |
06 | Driving License |
07 | Voters Identity Card |
08 | NREGA Job Card |
09 | Signature |
10 | Simplified Measures Account - Identity card with applicant’s photograph issued by Central/ State Government Departments, Statutory/ Regulatory Authorities, Public Sector Undertakings, Scheduled Commercial Banks, and Public Financial Institutions. |
11 | Simplified Measures Account - Letter issued by a gazetted officer, with a duly attested photograph of the person. |
12 | Utility bill which is not more than two months old of any service provider (electricity, telephone, post-paid mobile phone, piped gas, water bill). |
13 | Property or Municipal Tax receipt. |
14 | Bank account or Post Office savings bank account statement. |
15 | Pension or family pension payment orders (PPOs) issued to retired employees by Government Departments or Public Sector Undertakings, if they contain the address. |
16 | Letter of allotment of accommodation from employer issued by State or Central Government departments, statutory or regulatory bodies, public sector undertakings, scheduled commercial banks, financial institutions and listed companies. Similarly, leave and license agreements with such employers allotting official accommodation. |
17 | Documents issued by Government departments of foreign jurisdictions and letter issued by Foreign Embassy or Mission in India. |
18 | Officially valid document(s) in respect of person authorized to transact |
19 | Certificate of Incorporation/Formation |
20 | Registration Certificate |
21 | Memorandum and Articles of Association |
22 | Partnership Deed |
23 | Trust Deed |
24 | Resolution of Board/ Managing Committee |
25 | Power of Attorney granted to its manager, officers or employees to transact on its behalf. |
26 | Activity Proof – 1 (For Sole Proprietorship only) |
27 | Activity Proof – 2 (For Sole Proprietorship only) |
35 | National Population Registry Letter |
36 | E-KYC Authentication |
37 | Offline verification of Aadhaar |
98 | Other |
Contact Us for Any Assistance
If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!