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/fetch

POST https://api-preproduction.signzy.app/api/v3/ckyc-onprem/fetch

Request 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!