KYC DATA – API SPECIFICATIONS

1|Page Zillion Techno Systems India Ltd

API Documentation: KYC Data Submission System

1. Overview

This document describes the RESTful APIs for submitting KYC (Know Your Customer) data. The
API is secured using a token-based authentication system. The process is divided into three main
APIs:

 Login API: Used to authenticate and receive a Bearer token.

 KYC Check API: Used to Check whether KYC data exists using the received token.
 KYC Data API: Used to submit KYC data using the received token.

2. Login API

Overview:

Authenticate users and issue a Bearer token for secure access to subsequent APIs.

Endpoint:

POST [Link]

Headers:

Key Value
Content-Type application/x-www-form-urlencoded

Form Data Parameters:

Key Data Type Description Mandatory

username Char(16) Login ID Yes
password Char(50) Login Password Yes
grant_type Char(10) Grant Type (password) Yes

2|Page Zillion Techno Systems India Ltd

Example Request Parameters:

username=admin&password=admin123&grant_type=password

Response Json Structure: Success

Key Data Type Description

access_token string Access token
token_type string Token Type ( Bearer)
expires_in Int(32) Token expiry

Response JSON (Success):

"access_token":
"Ku7_noVB7XhCtj3jJo3pKm_QF2_8keHiv1Q3GYPfLRbwLSCG7g5hNAAtvreY4apeGc_ ",
"token_type": "bearer",
"expires_in": 86399
}

Response Json Structure: Failure

Key Data Type Description

error string Error Brief
error_description string Error Description

Response JSON (Failure):

{
"error": "invalid_grant",
"error_description": "Provided username and password is incorrect"
}

3|Page Zillion Techno Systems India Ltd

3. KYC Check API

Endpoint:

POST https:// [Link] / WebApiSecurity /WebAPI/KycCheckApi

Request Header:

Key Value
Content-Type application/json
Authorization Bearer : {Access Token}

Request Body Structure:

Key Data Type Description

Pan string Pan No of the KYC Data
Mobile string Mobile No of the KYC Data

Request JSON (Sample):

{
"Pan": "ESCPS1234D",
"Mobile": "9884012345"
}

Response Body Structure :

Key Data Type Description

MsgCode string Message Code
Message string Response Message

Response JSON (Sample):

{
"MsgCode ": "200",
"Mobile": “Client does not exist for this Pan : ESCPS1234D and Mobile No : 9884012345"
}

4|Page Zillion Techno Systems India Ltd

4. KYC Data Submission API

Endpoint:

POST https:// [Link] / WebApiSecurity /WebAPI/KycDataApi

Request Header:

Key Value
Content-Type application/json
Authorization Bearer : {Access Token}

Request Body Structure:

Zillion - Detail Record Format - EKYC

Sl. Field Maximum Mandatory/

No. Field Name Discription Length Optional Content in UCI
1 Kyc_App_No KYC Appl No Char(20) Mandatory KYC Application No.
2 Title TITLE Char (6) Mandatory Mr / Mrs / Miss / Master
Client Code must be unique
Only upper case allowed
3 Cl_Code Client Code Char (16) Mandatory No Special Characters allowed
Name of the Client must be in
full.
Client Name should not contain
all numbers or special
Characters.
Name of the PAN holder (As
declared in the PAN application)
4 Cl_FName Client First Name Char (50) Mandatory or Name on Card
Name of the Client must be in
full.
Client Name should not contain
all numbers or special
Characters.
Name of the PAN holder (As
Client Middle declared in the PAN application)
5 Cl_MName Name Char (50) Optional or Name on Card
Name of the Client must be in
full.
Client Name should not contain
all numbers or special
Characters.
Name of the PAN holder (As
declared in the PAN application)
6 Cl_LName Client Last Name Char (50) Mandatory or Name on Card
Refer Sheet 2 for list of category
7 Category Category Char (2) Mandatory codes

5|Page Zillion Techno Systems India Ltd

 Pan is mandatory for all clients.
Pan shall be 10 Characters and
shall have first 5 alphabets, next
8 Pan PAN Char (10) Mandatory 4 numeric and the last alphabet.
Name of the Client must be in
full.
Client Name should not contain
all numbers or special
Characters.
Name of the PAN holder (As
declared in the PAN application)
9 Pan_FName PAN First Name Char (45) Mandatory or Name on Card
Name of the Client must be in
full.
Client Name should not contain
all numbers or special
Characters.
Name of the PAN holder (As
PAN Middle declared in the PAN application)
10 Pan_MName Name Char (45) Mandatory or Name on Card
Name of the Client must be in
full.
Client Name should not contain
all numbers or special
Characters.
Name of the PAN holder (As
declared in the PAN application)
11 Pan_LName PAN Last Name Char (45) Mandatory or Name on Card
Client Photo Document to be sent in bytes
12 Cl_Photo Image VarChar(Max) Mandatory format
Client Signature Document to be sent in bytes
13 Cl_Sign Image VarChar(Max) Mandatory format
Valid Values are :
M – Male
F – Female
14 Gender Gender Char(2) Mandatory T - Transgender
Valid Values are :
Father's/Husband's F – Father
15 FH_Flag Flag Cha(1) Mandatory H – Husband
Name of the client must be in
full-surname, first name, middle
name.
Father's/Husband's Name should not contain all
16 FH_Name Name Char (150) Mandatory numbers or special Characters.
Name of the client must be in
full-surname, first name, middle
name.
Name should not contain all
17 Mo_Name Mother's Name Char (150) Mandatory numbers or special Characters.
Valid Values are :
S – Single
M– Married
W - Widow / Widower
18 Marital Marital status Char(2) Mandatory D - Divorce
19 Nationality Nationality Char (2) Mandatory Refer Sheet 3

6|Page Zillion Techno Systems India Ltd

 Email Id specifications:
1) Email ID shall be maximum of
60 Characters and minimum of 5
Characters
2) Email id should begin with
Alphanumeric Characters only.
3) Email id should have at least
one "."
4) "@" should be appear only
once
5) The below are the Characters
are not allowed in the email
address field.
~`#$%^&*()={}[]\|:;
”’<>,?/
6) Noemail’ should not
mentioned in email ID
7)Email ID should have at least
one ’@’ mentioned in email ID
8) Words - 'notprovided' and
'xyz' should not mentioned in
email id field
9) There should not be '.' (dot) at
the end of Email ID
10) There should not be '.' (dot)
after '@' and before domain
name
11)
notprovided@[Link] is
20 Email Client Email Id Char(60) Mandatory Invalid Email ID
It should not contain all numbers
Correspondence or special Characters.
Client Address Address line 1, 2 and 3 should
21 C_Addr1 line 1 Char(250) Mandatory not be same
Correspondence
Client Address It should not contain all numbers
22 C_Addr2 line 2 Char(150) Optional or special Characters.
Correspondence
Client Address It should not contain all numbers
23 C_Addr3 line 3 Char(150) Optional or special Characters.
Correspondence
Client Address - It should not contain all numbers
24 C_City City Char(50) Mandatory or special Characters.
Correspondence
Client Address -
25 C_State State Char(2) Mandatory Refer Sheet 3 for valid Codes list
Correspondence
Client Address -
26 C_Country Country Char(3) Mandatory Refer Sheet 3 for valid Codes list
Pin code should not contain all
zeros.
It should not contain special
Characters
Correspondence In these cases pin code shall be
Client Address - of 6 numbers. Also it should not
27 C_Pincode Pin code Number(6) Mandatory contain alphabets.

7|Page Zillion Techno Systems India Ltd

 Valid Values are :
"Y" - Denotes Correspondence
Flag Indicating if Address is same as Permanent
Correspondence Address
Address is same "N" - Denotes Correspondence
as Permanent Address is different from
28 Addr_Flag Address Char(1) Mandatory Permanent Address

If flag is Y - Permanent address

line 1 has to be NULL.
If flag is N - Permanent address
line 1 has to be mentioned

Client Address line 1 should be

provided for the particular client.
Permanent Client Mandatory/ It should not contain all numbers
29 P_Addr1 Address line 1 Char(250) Optional or special Characters.

If flag is Y - Permanent address

line 2 has to be NULL.
If flag is N - Permanent address
line 2 can be mentioned

Client Address line 2 may be

provided for the particular client.
Permanent Client It should not contain all numbers
30 P_Addr2 Address line 2 Char(150) Optional or special Characters.

If flag is Y - Permanent address

line 3 has to be NULL
If flag is N - Permanent address
line 3 can be mentioned

Client Address 3 line may be

provided for the particular client.
Permanent Client It should not contain all numbers
31 P_Addr3 Address line 3 Char(150) Optional or special Characters.

If flag is Y - Permanent client

address has to be NULL
If flag is N - Permanent address
city is mandatory

Client Address – City should be

provided for the client.
Permanent Client Mandatory/ It should not contain all numbers
32 P_City Address - City Char(50) Optional or special Characters.
If flag is Y - Permanent Client
Address - State field should be
NULL
If flag is N - Then this field is
Permanent Client Mandatory/ mandatory , Refer sheet 3 for list
33 P_State Address - State Char(2) Optional of codes
If flag is Y - then this field
should be NULL
Permanent Client If flag is N - Then this field is
Address - Mandatory/ mandatory , Refer sheet 3 for list
34 P_Country Country Char(3) Optional of codes

8|Page Zillion Techno Systems India Ltd

 If flag is Y - then this field
should be NULL
If flag is N - Then this field is
mandatory
Pin code should not contain all
zeros. It should not contain
special Characters

Permanent Client In these cases pin code shall be

Address - Pin Mandatory/ of 6 numbers. Also it should not
35 P_Pincode code Number(6) Optional contain alphabets.
If telephone number is provided,
then either ISD or STD code is
ISD code - Mandatory/ mandatory
36 ISD_Res Residence Number(14) Optional It should contain only numbers.
If telephone number is provided,
then either ISD or STD code is
mandatory
STD code should contain only
numbers and should not contain
STD code - Mandatory/ any alphabet or all zeros.
37 STD_Res Residence Number(10) Optional
It should not contain all
Telephone alphabets or zeros.
Number - Telephone No. can contain
38 Tel_Res Residence Char (60) Optional special Characters ( , - ( ) / space)
Mobile number should be
numeric
It should not contain all zeros or
1234567890.
single number should not be put
such as 6666666666 or
39 Mobile Mobile number Char (10) Mandatory 1111111111 etc.
If telephone number is provided,
then either ISD or STD code is
Mandatory/ mandatory
40 ISD_Off ISD code - Office Number(14) Optional It should contain only numbers.
If telephone number is provided,
then either ISD or STD code is
mandatory
STD code should contain only
numbers and should not contain
STD code - Mandatory/ any alphabet or all zeros.
41 STD_Off Office Number(10) Optional
It should not contain all
alphabets or zeros.
Telephone Telephone No. can contain
42 Tel_Off Number - Office Char (60) Optional special Characters ( , - ( ) / space)
DD-MM- Date format shall be DD-MM-
43 DOB Date of Birth YYYY Mandatory YYYY.
•Aadhaar/UID no should be
numeric and It should not contain
all same numbers like
44 UID UID NUMBER Char(12) Optional 0000000000 , 111111111111 etc
Bank Name should not contain
all numbers or special
Characters.
45 Bank_Name1 Bank Name 1 Char (60) Mandatory Bank Name should not contain

9|Page Zillion Techno Systems India Ltd

 comma

11-Char - first 4 alpha, 5th

Character shall be "0" (ZERO),
and last six Char - Alpha or
46 Bank_IFSC1 IFSC Code 1 Char (11) Mandatory numeric.
It should not contain all
alphabets, zeros or special
Characters.
Bank account no. should not be
only Characters & should not be
All Zeroes & Numeric Part of
Bank Account No. Bank Account Number should
47 Bank_Acno1 1 Char (30) Mandatory not be All Zeroes.
Bank Name 2 is mandatory if
IFSC code 2 or Bank Account
No. 2 is mentioned.
It should not contain all numbers
or special Characters.
Mandatory/ Bank Name should not contain
48 Bank_Name2 Bank Name 2 Char (60) Optional comma
IFSC Code 2 is mandatory if
Bank Name 2 or Bank Account
No. 2 is mentioned.
It should not contain all numbers
or special Characters.
Mandatory/ Bank Name should not contain
49 Bank_IFSC2 IFSC Code 2 Char (11) Optional comma
Bank Account No.2 is mandatory
if Bank Name 2 or IFSC Code 2
is mentioned
It should not contain all
alphabets, all zeros or special
Characters.
Bank account no. should not be
only Characters & should not be
All Zeroes & Numeric Part of
Bank Account No. Mandatory/ Bank Account Number should
50 Bank_Acno2 2 Char (30) Optional not be All Zeroes
Bank Name 3 is mandatory if
Bank IFSC code 3 or Bank
Account No. is mentioned.
It should not contain all numbers
or special Characters.
Mandatory/ Bank Name should not contain
51 Bank_Name3 Bank Name 3 Char (60) Optional comma
IFSC Code 3 is mandatory if
Bank Name 3 or Bank Account
No. 3 is mentioned.
It should not contain all numbers
or special Characters.
Mandatory/ Bank Name should not contain
52 Bank_IFSC3 IFSC Code 3 Char (11) Optional comma

10 | P a g e Zillion Techno Systems India Ltd

 Bank Account No.3 is mandatory
if Bank Name 3 or IFSC Code 3
is mentioned
It should not contain all
alphabets, all zeros or special
Characters.

Bank account no. should not be

only Characters & should not be
All Zeroes & Numeric Part of
Bank Account No. Mandatory/ Bank Account Number should
53 Bank_Acno3 3 Char (30) Optional not be All Zeroes
Depository Name is mandatory if
Depository ID or Beneficial
Owner Account No. is
mentioned.

Shall specify the name of the

depository in which the client has
a beneficial owner account.

Valid values are: -

--> NSDL
--> CDSL
Depository Name Mandatory/ Manadatory if Cash segment is
54 DP_Name1 1 Char (4) Optional enabled
Validation: It should not contain
all alphabets, zeros or special
Characters.
(no extra spaces must be
inserted)

Depository Mandatory/ Manadatory if Cash segment is

55 DP_Id1 Participant ID 1 Char(8) Optional enabled
Validation: It should not contain
all alphabets, zeros or special
Characters.
Beneficial Owner Mandatory/ (no extra spaces must be
56 DP_Acno1 Account No. 1 Char (8) Optional inserted)
Depository Name is mandatory if
Depository ID or Beneficial
Owner Account No. is
mentioned.

Shall specify the name of the

depository in which the client has
a beneficial owner account.

Valid values are: -

--> NSDL
--> CDSL
Depository name Mandatory/ Manadatory if Cash segment is
57 DP_Name2 2 Char (4) Optional enabled
Depository Mandatory/ If Depository name 2 has value
58 DP_Id2 Participant ID 2 Char(8) Optional then this filed is mandatory

11 | P a g e Zillion Techno Systems India Ltd

 Beneficial Owner Account No. 2
is mandatory id if Depository ID
2 or Depository Name 2 is
mentioned.

Validation: It should not contain

all alphabets, zeros or special
Characters.
Beneficial Owner Mandatory/ (no extra spaces must be
59 DP_Acno2 Account No. 2 Char (8) Optional inserted)
Depository Name is mandatory if
Depository ID or Beneficial
Owner Account No. is
mentioned.

Shall specify the name of the

depository in which the client has
a beneficial owner account.

Valid values are: -

--> NSDL
--> CDSL
Depository name Mandatory/ Manadatory if Cash segment is
60 DP_Name3 3 Char (4) Optional enabled
Depository ID 3 is mandatory if
Depository Name 3 is NSDL
Depository Mandatory/ In case of CDSL it should be
61 DP_Id3 Participant ID 3 Char(8) Optional blank
Beneficial Owner Account No. 3
is mandatory id if Depository
ID 3 or Depository Name 3 is
mentioned.

Validation: It should not contain

all alphabets, zeros or special
Characters.
Beneficial Owner Mandatory/ (no extra spaces must be
62 DP_Acno3 Account No. 3 Char (8) Optional inserted)
63 BSDA BSDA Char(1) Optional Values are "Y" / "N"

Valid Values are: -

0 - Not Applicable - This Lov is

allowed for category 10 only
1 - Below Rs. 1 Lac
2 - Btw Rs. 1 to Rs. 5 Lacs
3 - Btw Rs. 5 to Rs. 10 Lacs
4 - Btw Rs. 10 to Rs. 25 Lacs
Gross Annual Mandatory/ 5 - More than Rs. 25 Lacs
64 Income Income Range Number (1) Optional 6 - More than Rs. 1 Crore
'DD-MM-YYYY'
Mandatory if 'Gross Annual
Income' is specified.

For Gross Annual Income as on

Gross Annual DD-MM- Mandatory/ Date should not be older than the
65 Income_Date Income as on Date YYYY Optional previous calendar year

12 | P a g e Zillion Techno Systems India Ltd

 Net Worth (In Decimal
66 Networth Rs.) (15,3) Optional
'DD-MM-YYYY'
Mandatory if 'Net Worth' is
specified.

Net Worth as on DD-MM- Mandatory/ Date should not be older than 24

67 Networth_Date Date YYYY Optional months
Valid Values are: -
Politically 0 Not a PEP
Exposed Person 1 PEP
68 PEP (PEP) Number (1) Mandatory 2 Related to a PEP
69 Occupation Occupation Char(2) Mandatory Refer Sheet for Codes List
Occupation
Details (For Mandatory/
70 Occupation_oth others) Char(75) Optional Mandatory if Occupation is '99'
Inperson
Verification -
71 IPV_Empcode Employee Char(16) Mandatory
Inperson
Verification - DD-MM- Date format shall be DD-MM-
72 IPV_Date Dated YYYY Mandatory YYYY.
01- high
02- medium
73 Risk_Cat Risk category Char(2) Mandatory 03- low
Date format shall be DD-MM-
YYYY.
Client Agreement DD-MM- Agrrement date cannot be greater
74 Agree_Date Date YYYY Mandatory then current date

Valid Values for Proof type are:

Mapin Id – 1
Passport – 2
Voter Id – 3
Driving License – 4
Ration Card –5
Proof Type - Registration Details – 6
75 Proof_Id Indentity Char(2) Mandatory UID ( Aadhar ID) - 7
Valid Values are
Proof Type - 1) Jpeg
Indentity 2) PDF
76 Proof_Id_Type Document Type Char(10) Mandatory 3) BMP
Proof Type -
Indentity Document to be sent in bytes
77 Proof_Id_Doc Document VarChar(Max) Mandatory format

13 | P a g e Zillion Techno Systems India Ltd

 Valid Values for Proof type are:
Passport – 1
Driving License – 2
Ration Card – 3
Telephone Bill - 4
EB Bill - 5
Bank Pass book - 6
Bank Statement - 7
Credit Card Statement - 8
Gas Bill - 9
Voter Id – 10
Proof Type - Post office ID - 11
78 Proof_Addr Address Char(2) Mandatory UID ( Aadhar ID) - 12
Valid Values are
Proof Type - 1)Jpeg
Address 2)PDF
79 Proof_Addr_Type Document Type Char(10) Mandatory 3) BMP
Proof Type -
Address Document to be sent in bytes
80 Proof_Addr_Doc Document VarChar(Max) Mandatory format
It should not contain all
alphabets, zeros or special
Characters.
Proof number should be 9
81 Proof_no Proof Number Char(25) Mandatory Characters and alpha-numeric.

Issue Place of It should not contain all numbers

82 Iss_Place Proof Char(100) Mandatory or special Characters.
Issue Date of DD-MM-
83 Iss_date Proof YYYY Mandatory
Power of Attorney
84 POA_Funds (POA) for funds Char(1) Mandatory Valid values are Y or N
Power of Attorney
(POA) for
85 POA_Sec Securities Char(1) Mandatory Valid values are Y or N
Coordinates for
86 Lng Longitude char(100) Mandatory
Coordinates for
87 Lat Latitude char(100) Mandatory
Lead Reference
88 Lead_Ref No. Char(16) Optional
89 Lead_Code Lead Code Char(16) Optional
90 Lead_Source Lead Source Char(16) Optional
91 Emp_Code Employee Code Char(16) Optional
92 Nom1_Name Nominee name Char(50) Mandatory
Pan is mandatory for all clients.
Pan shall be 10 Characters and
shall have first 5 alphabets, next
93 Nom1_Pan Nominee PAN Char(10) Mandatory 4 numeric and the last alphabet.
Nominee
94 Nom1_Rel relationship Char(50) Mandatory
DD-MM- Mandatory/
95 Nom1_Dob Nominee DOB YYYY Optional

14 | P a g e Zillion Techno Systems India Ltd

 It should not contain all numbers
or special Characters.
Nominee Address Mandatory/ Address line 1, 2 and 3 should
96 Nom1_Addr1 1 Char(150) Optional not be same
Nominee Address Mandatory/ It should not contain all numbers
97 Nom1_Addr2 2 Char(150) Optional or special Characters.
Nominee Address Mandatory/ It should not contain all numbers
98 Nom1_Addr3 3 Char(150) Optional or special Characters.
Mandatory/ It should not contain all numbers
99 Nom1_City Nominee City Char(50) Optional or special Characters.
Mandatory/
100 Nom1_State Nominee State Char(2) Optional Refer Sheet 3 for valid Codes list
Pin code should not contain all
zeros.
It should not contain special
Characters
In these cases pin code shall be
Mandatory/ of 6 numbers. Also it should not
101 Nom1_Pincode Nominee pincode Number(6) Optional contain alphabets.
Mandatory/
102 Nom1_Country Nominee Country Char(3) Optional Refer Sheet 3 for valid Codes list
Mobile number should be
numeric
It should not contain all zeros or
1234567890.
single number should not be put
Mandatory/ such as 6666666666 or
103 Nom1_Cell Nominee Cell no char(10) Optional 1111111111 etc.
•Aadhaar/UID no should be
numeric and It should not contain
Nominee Aadhar Mandatory/ all same numbers like
104 Nom1_Aadhar no char(12) Optional 0000000000 , 111111111111 etc
Email Id specifications:
1) Email ID shall be maximum of
60 Characters and minimum of 5
Characters
2) Email id should begin with
Alphanumeric Characters only.
3) Email id should have at least
one "."
4) "@" should be appear only
once
5) The below are the Characters
are not allowed in the email
address field.
~`#$%^&*()={}[]\|:;
”’<>,?/
6) Noemail’ should not
mentioned in email ID
7)Email ID should have at least
one ’@’ mentioned in email ID
8) Words - 'notprovided' and
'xyz' should not mentioned in
email id field
9) There should not be '.' (dot) at
Mandatory/ the end of Email ID
105 Nom1_Email Nominee email ID Char(60) Optional 10) There should not be '.' (dot)

15 | P a g e Zillion Techno Systems India Ltd

 after '@' and before domain
name
11)
notprovided@[Link] is
Invalid Email ID

Nominee Mandatory/
106 Nom1_Iden identification Char(30) Optional
Nominee iden ref Mandatory/
107 Nom1_Iden_Refno no Char(30) Optional
108 Nom2_Name Nominee name Char(50) Mandatory
Pan is mandatory for all clients.
Pan shall be 10 Characters and
shall have first 5 alphabets, next
109 Nom2_Pan Nominee PAN Char(10) Mandatory 4 numeric and the last alphabet.
Nominee
110 Nom2_Rel relationship Char(50) Mandatory
DD-MM- Mandatory/
111 Nom2_Dob Nominee DOB YYYY Optional
It should not contain all numbers
or special Characters.
Nominee Address Mandatory/ Address line 1, 2 and 3 should
112 Nom2_Addr1 1 Char(150) Optional not be same
Nominee Address Mandatory/ It should not contain all numbers
113 Nom2_Addr2 2 Char(150) Optional or special Characters.
Nominee Address Mandatory/ It should not contain all numbers
114 Nom2_Addr3 3 Char(150) Optional or special Characters.
Mandatory/ It should not contain all numbers
115 Nom2_City Nominee City Char(50) Optional or special Characters.
Mandatory/
116 Nom2_State Nominee State Char(2) Optional Refer Sheet 3 for valid Codes list
Pin code should not contain all
zeros.
It should not contain special
Characters
In these cases pin code shall be
Mandatory/ of 6 numbers. Also it should not
117 Nom2_Pincode Nominee pincode Number(6) Optional contain alphabets.

16 | P a g e Zillion Techno Systems India Ltd

 Mandatory/
118 Nom2_Country Nominee Country Char(2) Optional Refer Sheet 3 for valid Codes list
Mobile number should be
numeric
It should not contain all zeros or
1234567890.
single number should not be put
Mandatory/ such as 6666666666 or
119 Nom2_Cell Nominee Cell no char(10) Optional 1111111111 etc.
•Aadhaar/UID no should be
numeric and It should not contain
Nominee Aadhar Mandatory/ all same numbers like
120 Nom2_Aadhar no char(12) Optional 0000000000 , 111111111111 etc
Email Id specifications:
1) Email ID shall be maximum of
60 Characters and minimum of 5
Characters
2) Email id should begin with
Alphanumeric Characters only.
3) Email id should have at least
one "."
4) "@" should be appear only
once
5) The below are the Characters
are not allowed in the email
address field.
~`#$%^&*()={}[]\|:;
”’<>,?/
6) Noemail’ should not
mentioned in email ID
7)Email ID should have at least
one ’@’ mentioned in email ID
8) Words - 'notprovided' and
'xyz' should not mentioned in
email id field
9) There should not be '.' (dot) at
the end of Email ID
10) There should not be '.' (dot)
after '@' and before domain
name
11)
Mandatory/ notprovided@[Link] is
121 Nom2_Email Nominee email ID char(60) Optional Invalid Email ID
Nominee Mandatory/
122 Nom2_Iden identification char(30) Optional
Nominee iden ref Mandatory/
123 Nom2_Iden_Refno no char(30) Optional
124 Nom3_Name Nominee name Char(50) Mandatory
Pan is mandatory for all clients.
Pan shall be 10 Characters and
shall have first 5 alphabets, next
125 Nom3_Pan Nominee PAN Char(10) Mandatory 4 numeric and the last alphabet.
Nominee
126 Nom3_Rel relationship Char(50) Mandatory
DD-MM- Mandatory/
127 Nom3_Dob Nominee DOB YYYY Optional

17 | P a g e Zillion Techno Systems India Ltd

 It should not contain all numbers
or special Characters.
Nominee Address Mandatory/ Address line 1, 2 and 3 should
128 Nom3_Addr1 1 Char(150) Optional not be same
Nominee Address Mandatory/ It should not contain all numbers
129 Nom3_Addr2 2 Char(150) Optional or special Characters.
Nominee Address Mandatory/ It should not contain all numbers
130 Nom3_Addr3 3 Char(150) Optional or special Characters.
Mandatory/ It should not contain all numbers
131 Nom3_City Nominee City Char(50) Optional or special Characters.
Mandatory/
132 Nom3_State Nominee State Char(2) Optional Refer Sheet 3 for valid Codes list
Pin code should not contain all
zeros.
It should not contain special
Characters
In these cases pin code shall be
Mandatory/ of 6 numbers. Also it should not
133 Nom3_Pincode Nominee pincode Number(6) Optional contain alphabets.
Mandatory/
134 Nom3_Country Nominee Country Char(2) Optional Refer Sheet 3 for valid Codes list
Mobile number should be
numeric
It should not contain all zeros or
1234567890.
single number should not be put
Mandatory/ such as 6666666666 or
135 Nom3_Cell Nominee Cell no char(10) Optional 1111111111 etc.
•Aadhaar/UID no should be
numeric and It should not contain
Nominee Aadhar Mandatory/ all same numbers like
136 Nom3_Aadhar no char(12) Optional 0000000000 , 111111111111 etc
Email Id specifications:
1) Email ID shall be maximum of
60 Characters and minimum of 5
Characters
2) Email id should begin with
Alphanumeric Characters only.
3) Email id should have at least
one "."
4) "@" should be appear only
once
5) The below are the Characters
are not allowed in the email
address field.
~`#$%^&*()={}[]\|:;
”’<>,?/
6) Noemail’ should not
mentioned in email ID
7)Email ID should have at least
one ’@’ mentioned in email ID
8) Words - 'notprovided' and
'xyz' should not mentioned in
email id field
9) There should not be '.' (dot) at
Mandatory/ the end of Email ID
137 Nom3_Email Nominee email ID char(60) Optional 10) There should not be '.' (dot)

18 | P a g e Zillion Techno Systems India Ltd

 after '@' and before domain
name
11)
notprovided@[Link] is
Invalid Email ID

Nominee Mandatory/
138 Nom3_Iden identification char(30) Optional
Nominee iden ref Mandatory/
139 Nom3_Iden_Refno no char(30) Optional
Guardian of
140 NG_Name Nominee name Char(50) Mandatory
Pan is mandatory for all clients.
Pan shall be 10 Characters and
Guardian of shall have first 5 alphabets, next
141 NG_Pan Nominee PAN Char(10) Mandatory 4 numeric and the last alphabet.
Guardian of
Nominee
142 NG_Rel relationship Char(50) Mandatory
Guardian of DD-MM- Mandatory/
143 NG_DOB Nominee DOB YYYY Optional
It should not contain all numbers
Guardian of or special Characters.
Nominee Address Mandatory/ Address line 1, 2 and 3 should
144 NG_Addr1 1 Char(150) Optional not be same
Guardian of
Nominee Address Mandatory/ It should not contain all numbers
145 NG_Addr2 2 Char(150) Optional or special Characters.
Guardian of
Nominee Address Mandatory/ It should not contain all numbers
146 NG_Addr3 3 Char(150) Optional or special Characters.
Guardian of Mandatory/ It should not contain all numbers
147 NG_City Nominee City Char(50) Optional or special Characters.
Guardian of Mandatory/
148 NG_State Nominee State Char(2) Optional Refer Sheet 3 for valid Codes list
Pin code should not contain all
zeros.
It should not contain special
Characters
In these cases pin code shall be
Guardian of Mandatory/ of 6 numbers. Also it should not
149 NG_Pincode Nominee pincode Number(6) Optional contain alphabets.
Guardian of Mandatory/
150 NG_Country Nominee Country Char(2) Optional Refer Sheet 3 for valid Codes list
Mobile number should be
numeric
It should not contain all zeros or
1234567890.
single number should not be put
Guardian of Mandatory/ such as 6666666666 or
151 NG_Cell Nominee Cell no char(10) Optional 1111111111 etc.
•Aadhaar/UID no should be
Guardian of numeric and It should not contain
Nominee Aadhar Mandatory/ all same numbers like
152 NG_Aadhar no char(12) Optional 0000000000 , 111111111111 etc

19 | P a g e Zillion Techno Systems India Ltd

 Email Id specifications:
1) Email ID shall be maximum of
60 Characters and minimum of 5
Characters
2) Email id should begin with
Alphanumeric Characters only.
3) Email id should have at least
one "."
4) "@" should be appear only
once
5) The below are the Characters
are not allowed in the email
address field.
~`#$%^&*()={}[]\|:;
”’<>,?/
6) Noemail’ should not
mentioned in email ID
7)Email ID should have at least
one ’@’ mentioned in email ID
8) Words - 'notprovided' and
'xyz' should not mentioned in
email id field
9) There should not be '.' (dot) at
the end of Email ID
10) There should not be '.' (dot)
after '@' and before domain
name
11)
Guardian of Mandatory/ notprovided@[Link] is
153 NG_Email Nominee email ID Char(60) Optional Invalid Email ID
Guardian of
Nominee Mandatory/
154 NG_Id identification char(30) Optional
155 Brok_Type Brokerage type char(2) Mandatory Normal = "N" / Flat = "F"
Brokerage for Mandatory If brokerage type is
Cash Segment - Decimal Mandatory/ "N" and Cash segment field
156 Cash_Intra Intraday (18,5) Optional value is "1"
Brokerage for Mandatory If brokerage type is
Cash Segment - Decimal Mandatory/ "N" and Cash segment field
157 Cash_Del Delivery (18,5) Optional value is "1"
Brokerage for
Equity Derivities Mandatory If brokerage type is
Segment - Decimal Mandatory/ "N" and FAO segment field
158 FAO_Per Perentage Wise (18,5) Optional value is "1"
Brokerage for
Equity Derivities Mandatory If brokerage type is
Segment - Lot Decimal Mandatory/ "N" and FAO segment field
159 FAO_Lot Wise (18,5) Optional value is "1"
Brokerage for Mandatory If brokerage type is
Currency Segment Decimal Mandatory/ "N" and Currency segment field
160 Cur_Per - Perentage Wise (18,5) Optional value is "1"
Brokerage for Mandatory If brokerage type is
currency Segment Decimal Mandatory/ "N" and Currency segment field
161 Cur_Lot - Lot Wise (18,5) Optional value is "1"
Brokerage for
Commodity Mandatory If brokerage type is
Segment - Decimal Mandatory/ "N" and Commodity segment
162 Com_Per Perentage Wise (18,5) Optional field value is "1"

20 | P a g e Zillion Techno Systems India Ltd

 Brokerage for
Commodity Mandatory If brokerage type is
Segment - Lot Decimal Mandatory/ "N" and Commodity segment
163 Com_Lot Wise (18,5) Optional field value is "1"
Brokerage for Per Decimal Mandatory If brokerage type is
164 POB Order Category (8,2) Optional "F"
Brokerage for Per Decimal Mandatory/ Mandatory If brokerage type is
165 PTB Trade Category (8,2) Optional "F"
Brokerage for Per Decimal Mandatory/ Mandatory If brokerage type is
166 PLB Lot Category (8,2) Optional "F"
167 Cash Segment - Cash Bit Mandatory Values are "0" / "1"
168 Fao Segment - FAO Bit Mandatory Values are "0" / "1"
Segment -
169 Cur Currency Bit Mandatory Values are "0" / "1"
Segment -
170 Com Commodity Bit Mandatory Values are "0" / "1"
Temp Boid for
registering
Dpid and
171 Instaboid DpacNo varchar(20) Mandatory
Nominee 1
Share Mandatory / Mandatory if Nominee 1
172 Nom1_SharePer Percentage decimal(8,2) Optional Details are given.
Nominee 2
Share Mandatory / Mandatory if Nominee 2
173 Nom2_SharePer Percentage decimal(8,2) Optional Details are given.
Nominee 3
Share Mandatory / Mandatory if Nominee 3
174 Nom3_SharePer Percentage decimal(8,2) Optional Details are given.
Guardian of
175 NG1_Name Nominee name Char(50) Mandatory
Pan is mandatory for all clients.
Pan shall be 10 Characters and
Guardian of shall have first 5 alphabets, next
176 NG1_Pan Nominee PAN Char(10) Mandatory 4 numeric and the last alphabet.
Guardian of
Nominee
177 NG1_Rel relationship Char(50) Mandatory
Guardian of DD-MM- Mandatory/
178 NG1_DOB Nominee DOB YYYY Optional
It should not contain all numbers
Guardian of or special Characters.
Nominee Address Mandatory/ Address line 1, 2 and 3 should
179 NG1_Addr1 1 Char(150) Optional not be same
Guardian of
Nominee Address Mandatory/ It should not contain all numbers
180 NG1_Addr2 2 Char(150) Optional or special Characters.
Guardian of
Nominee Address Mandatory/ It should not contain all numbers
181 NG1_Addr3 3 Char(150) Optional or special Characters.
Guardian of Mandatory/ It should not contain all numbers
182 NG1_City Nominee City Char(50) Optional or special Characters.
183 NG1_State Guardian of Char(2) Mandatory/ Refer Sheet 3 for valid Codes list

21 | P a g e Zillion Techno Systems India Ltd

 Nominee State Optional
Pin code should not contain all
zeros.
It should not contain special
Characters
In these cases pin code shall be
Guardian of Mandatory/ of 6 numbers. Also it should not
184 NG1_Pincode Nominee pincode Number(6) Optional contain alphabets.
Guardian of Mandatory/
185 NG1_Country Nominee Country Char(2) Optional Refer Sheet 3 for valid Codes list
Mobile number should be
numeric
It should not contain all zeros or
1234567890.
single number should not be put
Guardian of Mandatory/ such as 6666666666 or
186 NG1_Cell Nominee Cell no char(10) Optional 1111111111 etc.
•Aadhaar/UID no should be
Guardian of numeric and It should not contain
Nominee Aadhar Mandatory/ all same numbers like
187 NG1_Aadhar no char(12) Optional 0000000000 , 111111111111 etc
Email Id specifications:
1) Email ID shall be maximum of
60 Characters and minimum of 5
Characters
2) Email id should begin with
Alphanumeric Characters only.
3) Email id should have at least
one "."
4) "@" should be appear only
once
5) The below are the Characters
are not allowed in the email
address field.
~`#$%^&*()={}[]\|:;
”’<>,?/
6) Noemail’ should not
mentioned in email ID
7)Email ID should have at least
one ’@’ mentioned in email ID
8) Words - 'notprovided' and
'xyz' should not mentioned in
email id field
9) There should not be '.' (dot) at
the end of Email ID
10) There should not be '.' (dot)
after '@' and before domain
name
11)
Guardian of Mandatory/ notprovided@[Link] is
188 NG1_Email Nominee email ID Char(60) Optional Invalid Email ID
Guardian of
Nominee Mandatory/
189 NG1_Id identification char(30) Optional
Guardian of
190 NG2_Name Nominee name Char(50) Mandatory

22 | P a g e Zillion Techno Systems India Ltd

 Pan is mandatory for all clients.
Pan shall be 10 Characters and
Guardian of shall have first 5 alphabets, next
191 NG2_Pan Nominee PAN Char(10) Mandatory 4 numeric and the last alphabet.
Guardian of
Nominee
192 NG2_Rel relationship Char(50) Mandatory
Guardian of DD-MM- Mandatory/
193 NG2_DOB Nominee DOB YYYY Optional
It should not contain all numbers
Guardian of or special Characters.
Nominee Address Mandatory/ Address line 1, 2 and 3 should
194 NG2_Addr1 1 Char(150) Optional not be same
Guardian of
Nominee Address Mandatory/ It should not contain all numbers
195 NG2_Addr2 2 Char(150) Optional or special Characters.
Guardian of
Nominee Address Mandatory/ It should not contain all numbers
196 NG2_Addr3 3 Char(150) Optional or special Characters.
Guardian of Mandatory/ It should not contain all numbers
197 NG2_City Nominee City Char(50) Optional or special Characters.
Guardian of Mandatory/
198 NG2_State Nominee State Char(2) Optional Refer Sheet 3 for valid Codes list
Pin code should not contain all
zeros.
It should not contain special
Characters
In these cases pin code shall be
Guardian of Mandatory/ of 6 numbers. Also it should not
199 NG2_Pincode Nominee pincode Number(6) Optional contain alphabets.
Guardian of Mandatory/
200 NG2_Country Nominee Country Char(2) Optional Refer Sheet 3 for valid Codes list
Mobile number should be
numeric
It should not contain all zeros or
1234567890.
single number should not be put
Guardian of Mandatory/ such as 6666666666 or
201 NG2_Cell Nominee Cell no char(10) Optional 1111111111 etc.
•Aadhaar/UID no should be
Guardian of numeric and It should not contain
Nominee Aadhar Mandatory/ all same numbers like
202 NG2_Aadhar no char(12) Optional 0000000000 , 111111111111 etc
Email Id specifications:
1) Email ID shall be maximum of
60 Characters and minimum of 5
Characters
2) Email id should begin with
Alphanumeric Characters only.
3) Email id should have at least
one "."
4) "@" should be appear only
once
5) The below are the Characters
are not allowed in the email
Guardian of Mandatory/ address field.
203 NG2_Email Nominee email ID Char(60) Optional ~`#$%^&*()={}[]\|:;

23 | P a g e Zillion Techno Systems India Ltd

 ”’<>,?/
6) Noemail’ should not
mentioned in email ID
7)Email ID should have at least
one ’@’ mentioned in email ID
8) Words - 'notprovided' and
'xyz' should not mentioned in
email id field
9) There should not be '.' (dot) at
the end of Email ID
10) There should not be '.' (dot)
after '@' and before domain
name
11)
notprovided@[Link] is
Invalid Email ID
Guardian of
Nominee Mandatory/
204 NG2_Id identification char(30) Optional

Request Json (Sample) :

{
"Kyc_App_No": "ABCD0000123",
"Title": "MR",
"Cl_Code": A0000001",
"Cl_FName": "VASANTH",
"Cl_MName": "",
"Cl_LName": "RAJAPANDIYAN",
"Category": "01",
"Pan": "ABCDE9200F",
"Pan_FName": "VASANTH",
"Pan_MName": "",
"Pan_LName": "RAJAPANDIYAN",
"Cl_Photo": "",
"Cl_Sign": "",
"Gender": "M",
"FH_Flag": "F",
"FH_Name": "RAJAPANDIYAN",
"Mo_Name": "VASANTHA",
"Marital": "S",
"Nationality": "85",
"Email": "XYZ@[Link]",
"C_Addr1": "DOOR NO.123",
"C_Addr2": "XYZ STREET",
"C_Addr3": "ABC NAGAR",
"C_City": "Madurai",
"C_State": "31",
"C_Country": "85",
"C_PinCode": 625107,
"Addr_Flag": "1",
"P_Addr1": "DOOR NO.123",
"P_Addr2": "XYZ STREET",
"P_Addr3": "ABC NAGAR",
"P_City": "Madurai",
"P_State": "31",
"P_Country": "85",

24 | P a g e Zillion Techno Systems India Ltd

 "P_PinCode": 625107,
"ISD_Res": 0,
"STD_Res": 0,
"Tel_Res": "0",
"Mobile": "6381499573",
"ISD_Off": 0,
"STD_Off": 0,
"Tel_Off": "0",
"DOB": "19-09-2000",
"UID": "8560",
"Bank_Name1": "TAMILNAD MERCANTILE BANK LTD",
"Bank_IFSC1": "TMBL0000123",
"Bank_Acno1": "1234567890123456",
"Bank_Name2": "",
"Bank_IFSC2": "",
"Bank_Acno2": "",
"Bank_Name3": "",
"Bank_IFSC3": "",
"Bank_Acno3": "",
"DP_Name1": "",
"DP_Id1": "",
"DP_Acno1": "",
"DP_Name2": "",
"DP_Id2": "",
"DP_Acno2": "",
"DP_Name3": "",
"DP_Id3": "",
"DP_Acno3": "",
"BSDA": "",
"Income": "3",
"Income_Date": "31-12-2025",
"Networth": "0.00",
"Networth_Date": "",
"PEP": "0",
"Occupation": "4",
"Occupation_oth": "",
"IPV_Empcode": "3214569",
"IPV_Date": "",
"Risk_Cat": "3",
"Agree_Date": "",
"Proof_Id": "7",
"Proof_Id_Type": "jpg",
"Proof_Id_Doc": "",
"Proof_Addr": "12",
"Proof_Addr_Type": "jpg",
"Proof_Addr_Doc": "",
"Proof_no": "",
"Iss_Place": "",
"Iss_date": "",
"POA_Funds": "N",
"POA_Sec": "N",
"Lng": "78.187985",
"Lat": "9.9572217",
"Lead_Ref": "",
"Lead_Code": "2038",
"Lead_Source": "",
"Emp_Code": "",
"Nom1_Name": "",
"Nom1_Pan": "",

25 | P a g e Zillion Techno Systems India Ltd

 "Nom1_Rel": "",
"Nom1_Dob": "",
"Nom1_Addr1": "",
"Nom1_Addr2": "",
"Nom1_Addr3": "",
"Nom1_City": "",
"Nom1_State": "",
"Nom1_Pincode": 0,
"Nom1_Country": "",
"Nom1_Cell": "",
"Nom1_Aadhar": "",
"Nom1_Email": "",
"Nom1_Iden": "",
"Nom1_Iden_Refno": "",
"Nom2_Name": "",
"Nom2_Pan": "",
"Nom2_Rel": "",
"Nom2_Dob": "",
"Nom2_Addr1": "",
"Nom2_Addr2": "",
"Nom2_Addr3": "",
"Nom2_City": "",
"Nom2_State": "",
"Nom2_Pincode": 0,
"Nom2_Country": "",
"Nom2_Cell": "",
"Nom2_Aadhar": "",
"Nom2_Email": "",
"Nom2_Iden": "",
"Nom2_Iden_Refno": "",
"Nom3_Name": "",
"Nom3_Pan": "",
"Nom3_Rel": "",
"Nom3_Dob": "",
"Nom3_Addr1": "",
"Nom3_Addr2": "",
"Nom3_Addr3": "",
"Nom3_City": "",
"Nom3_State": "",
"Nom3_Pincode": 0,
"Nom3_Country": "",
"Nom3_Cell": "",
"Nom3_Aadhar": "",
"Nom3_Email": "",
"Nom3_Iden": "",
"Nom3_Iden_Refno": "",
"NG_Name": "",
"NG_Pan": "",
"NG_Rel": "",
"NG_DOB": "",
"NG_Addr1": "",
"NG_Addr2": "",
"NG_Addr3": "",
"NG_City": "",
"NG_State": "",
"NG_Pincode": 0,
"NG_Country": "",
"NG_Cell": "",
"NG_Aadhar": "",

26 | P a g e Zillion Techno Systems India Ltd

 "NG_Email": "",
"NG_Id": "",
"Brok_Type": "",
"Cash_Intra": "0.05",
"Cash_Del": "0.5",
"FAO_Per": "0.00",
"FAO_Lot": 0,
"Cur_Per": 0,
"Cur_Lot": 0,
"Com_Per": 0,
"Com_Lot": 0,
"POB": 0,
"PTB": 0,
"PLB": 0,
"Cash": 1,
"Fao": 0,
"Cur": 0,
"Com": 0,
"Instaboid": "IN12365478901236",
"Nom1_SharePer": 0,
"Nom2_SharePer": 0,
"Nom3_SharePer": 0,
"NG1_Name": "",
"NG1_Pan": "",
"NG1_Rel": "",
"NG1_DOB": "",
"NG1_Addr1": "",
"NG1_Addr2": "",
"NG1_Addr3": "",
"NG1_City": "",
"NG1_State": "",
"NG1_Pincode": 0,
"NG1_Country": "",
"NG1_Cell": "",
"NG1_Aadhar": "",
"NG1_Email": "",
"NG1_Id": "",
"NG2_Name": "",
"NG2_Pan": "",
"NG2_Rel": "",
"NG2_DOB": "",
"NG2_Addr1": "",
"NG2_Addr2": "",
"NG2_Addr3": "",
"NG2_City": "",
"NG2_State": "",
"NG2_Pincode": 0,
"NG2_Country": "",
"NG2_Cell": "",
"NG2_Aadhar": "",
"NG2_Email": "",
"NG2_Id": ""
}

27 | P a g e Zillion Techno Systems India Ltd

Response Body Structure :

Key Data Type Description

MsgCode string Message Code
Message string Response Message

Response JSON (Success):

{
"msgcode": "200",
"message": "KYC data submitted successfully"
}

Response JSON (Error):

{
"msgcode": "515",
"message": " Data already exist"

Standard HTTP Response Codes

Following are the standard HTTP Response codes

HTTP Code Description

200 Success
400 Bad Request
401 Mandatory field value Missing
402 Size of the fields is more than the specified length
500 Internal Server Error
501 Not Implemented
503 Service Unavailable

28 | P a g e Zillion Techno Systems India Ltd