Response Parameters
Returns following user details in JSON format:
#
Response Parameter
Description
Mandatory (Yes/ No)
1
FI Code
ID Provided by CKYC to client
Yes
2
Session ID
Unique ID for the Request session
Yes
3
CKYC_Request_ID
dd-MM-yyyy
Yes
4
Status
Status Code of API Response
Yes
5
Status Description
Status Description of API Response
Yes
6
CKYC Number
As received in response from CKYC
Yes
7
Applicant Prefix
As received in response from CKYC
Yes
8
Full Name
As received in response from CKYC
Yes
9
Gender
As received in response from CKYC
Yes
10
Father/Spouse Type
As received in response from CKYC
Yes
11
Father/Spouse Prefix
As received in response from CKYC
Yes
12
Father/Spouse Full Name
As received in response from CKYC
Yes
13
Mother Prefix
As received in response from CKYC
Yes
14
Mother Full Name
As received in response from CKYC
Yes
15
DOB
As received in response from CKYC
Yes
16
PAN Number
As received in response from CKYC
Yes
17
Proof of Identity Number
As received in response from CKYC
Yes
18
Proof of Identity Type
As received in response from CKYC
Yes
19
Photo
As received in response from CKYC
Yes
20
KYC Verification Date
As received in response from CKYC
Yes
21
Location of KYC
As received in response from CKYC
Yes
22
Proof of Identity Image
As received in response from CKYC
No
23
Proof of Identity Image code
As received in response from CKYC
No
24
Proof of Current Address Image
As received in response from CKYC
Yes
25
Proof of Current Address Image code
As received in response from CKYC
Yes
26
Signature Image
As received in response from CKYC
Yes
27
Permanent Address 1
As received in response from CKYC
Yes
28
Permanent Address 2
As received in response from CKYC
Yes
29
Permanent Address 3
As received in response from CKYC
Yes
30
Permanent Address - City/Town/Village
As received in response from CKYC
Yes
31
Permanent Address - District
As received in response from CKYC
Yes
32
Permanent Address - State
As received in response from CKYC
Yes
33
Permanent Address - Country
As received in response from CKYC
Yes
34
Permanent Address - Pin code
As received in response from CKYC
Yes
35
Permanent Address - PoA Type
As received in response from CKYC
Yes
36
Current Address 1
As received in response from CKYC
Yes
37
Current Address 2
As received in response from CKYC
Yes
38
Current Address 3
As received in response from CKYC
Yes
39
Current Address -City/ Town/ Village
As received in response from CKYC
Yes
40
Current Address - District
As received in response from CKYC
Yes
41
Current Address - State
As received in response from CKYC
Yes
42
Current Address - Country
As received in response from CKYC
Yes
43
Current Address - Pin code
As received in response from CKYC
Yes
44
Current Address - PoA Type
As received in response from CKYC
Yes
45
Mobile Number
As received in response from CKYC
No
46
email ID
As received in response from CKYC
No
47
Photo image Type
As received in response from CKYC , image format ex: jpg,pdf,etc...
No
No
Signature Image Code
As received in response from CKYC
Yes
49
Signature Image Type
As received in response from CKYC , image format ex: jpg,pdf,etc...
Yes
50
Proof of Identity Image Type
As received in response from CKYC , image format ex: jpg,pdf,etc...
Yes
51
Proof of Current Address Image Type
As received in response from CKYC , image format ex: jpg,pdf,etc...
Yes
Sample Decryption Response:
{
OiDyaAXtRU5DFSm8D6RbUj6PU0EL9gf/dIIP2YPRcf7a/PNPOOysumrUYxtr00FcvuhLUynsaffPgCOjr83Rx UuwIgPDvMNSLoVz4HhNDw+dwvqNZ3+CmSV9U68C+abkWUWPF2ZNZSrIXXPsbQPp+5pMRZgz6JiviJ hXnhYanb+sdAiSvv2di+MyFanhMWhvQWygdYTDiTYGNp4PPh8NE0NRdXK1NN80T48bPxVxcsEbPwh5 UWQRJdzKn66KQWN8MFgdqWf3D09+tKivqxLWyVsCcajLnF4YTs9PHsyxH0GoYKx5WyD8lAomoH9Tvs Rj7F6hm6qoriQplcibEkNj................QGkYQQ55XhUD2lgqEYSU0ZJBymMcOxYb97Vn1xRCrebzg2COW3l OkZ5c/A==
}
Sample Plain Response:
{
"Status":"CSS000",
"StatusDecription":"Success",
"SessionID":"202301111322397xxxxxx",
"Res_Ref_No":"202301111336599xxxxxxxxxx",
"FI_Code":"IN100xx",
"CKYC_Request_ID":”xxxxxxxx”,
"CKYC_No":”xxxxxxxxxx”, "Applicant_Prefix":”xxxxxxxxxx ”,
"Applicant_FullName":”xxxxxxxxxx ”,
"DOB":”xxxxxxxxxx ”,
"Gender":”xxxxxxxxxx”,
"PAN":”xxxxxxxxxx”,
"Mobile":”xxxxxxxxxx”,
"email_id":”xxxxxxxxxx”,
"Fatherspouse_Flag":”xxxxxxxxxx ”,
"Father_Spouse_Prefix":”xxxxxxxxxx ”,
"Father_Spouse_FullName":”xxxxxxxxxx ”,
"Mother_Prefix":”xxxxxxxxxx ”,
"Mother_FullName":”xxxxxxxxxx ”,
"Proof_Id_Type":”xxxxxxxxxx ”,
"Proof_Id_Num":”xxxxxxxxxx ”,
"KYC_Date":”xxxxxxxxxx ”,
"Location_of_Kyc":”xxxxxxxxxx ”,
"Perm_Type":”xxxxxxxxxx ”,
"Perm_Address_1":”xxxxxxxxxx ”,
"Perm_Address_2":”xxxxxxxxxx ”,
"Perm_Address_3":”xxxxxxxxxx ”,
"Perm_City":”xxxxxxxxxx ”,
"Perm_District":”xxxxxxxxxx ”,
"Perm_State":”xxxxxxxxxx ”,
"Perm_Country":”xxxxxxxxxx ”,
"Perm_Pincode":”xxxxxxxxxx ”,
"Corres_Type":”xxxxxxxxxx ”,
"Corres_Address_1":”xxxxxxxxxx ”,
"Corres_Address_2":”xxxxxxxxxx ”,
"Corres_Address_3":”xxxxxxxxxx ”,
"Corres_City":”xxxxxxxxxx ”,
"Corres_District":”xxxxxxxxxx ”,
"Corres_State":”xxxxxxxxxx ”,
"Corres_Country":”xxxxxxxxxx ”,
"Corres_Pincode":”xxxxxxxxxx ”,
"Sign_Img":”Base64String”,
"Sign_Img_Code":”xx”,
"Sign_Img_Type":”xxx”,
"Proof_Id_Img":”Base64String”,
"Proof_Id_Img_Code":”xx”,
"Proof_Id_Img_Type":”xxx”,
"Proof_Addr_Img":”Base64String”,
"Proof_Addr_Img_Code":”xx”,
"Proof_Addr_Img_Type":”xxx”,
"Photo_Img":”Base64String”,
"Photo_Img_Type":”xxx”
}
Sample Failure Plain Response:
{
"Status": "CSS002",
"StatusDecription": "Invalid request",
"SessionID": "20220426145353738_BoTVKsp0yz",
"Res_Ref_No":"20221128181023618_CLhXXXXX"
}
{
"Status":"CSS134",
"StatusDecription":"RequestType should not be empty",
"SessionID":"20221128174XXX_XXXX",
"Res_Ref_No":"20221128181023618_CLhXXXXX"
}
{
"Status":"CSS135",
"StatusDecription":"Reached Maximum Given Length, Maximum Length For RequestType is 10",
"SessionID":"20221128174XXX_XXXX",
"Res_Ref_No":"20221128181023618_CLhXXXXX"
}
Response Status Code and Status Description:
If the request fails, corresponding status code will be returned along with the status description in the response parameter.
The following table lists the possible response status codes and description.
#
Status Code
Status Description
1
CSS500
Internal Error
2
CSS400
Request is empty
3
CSS999
“ {Error message directly from CKYC API’ s}”
4
CSS143
Failed to Retrieve Data
5
CSS142
Either Mobile or DOB must be provided in request
6
CSS141
Id Type does not match with Database
7
CSS135
Reached Maximum Given Length, Maximum Length For {Parameter Name and length Value}
8
CSS134
{Parameter Name} should not be empty
9
CSS061
Invalid Mobile Number
10
CSS059
Invalid Date of Birth
11
CSS018
SessionID is mandatory field
12
CSS008
Unauthorized API access
13
CSS007
Your password is expired
14
CSS006
Client is currently Inactive
15
CSS005
Client setup pending
16
CSS004
API authentication failed
17
CSS003
User id or password is mandatory field
18
CSS002
Invalid Request
19
CSS001
Your request decryption failed
20
CSS000
Success
Last updated