KYC application parameter dictionary - DCS Technical Documentation

📄 Guide

When you submit a KYC application (/open-api/kyc-ticket/v1/apply-kyc), fields such as the address document type, occupation, employment status and source of funds are all enumerations, and you must send the code shown in the tables below. This page lists those enumerations in full for you to work against during integration.

Address proof document type (poaDocType)

poaDocType values do not differ between integration models — both share one list. Which types are actually accepted depends on the user’s country or region: the accepted proof-of-address types vary by country, so follow the coverage list you confirmed with DCS.

code	Name	Notes
`UTILITY_BILL`	Utility bill	Water, electricity or gas; no older than 90 days (75 days in France)
`TELECOM`	Telecom bill	No older than 90 days
`BANK_STATEMENT`	Bank statement	No older than 90 days
`BANK_LETTER`	Bank letter	An official letter from a financial institution carrying account details, stamped or signed
`CREDIT_CARD_STATEMENT`	Credit card statement	No older than 90 days
`LEASE_AND_PAYMENT`	Lease agreement plus proof of payment	Proof of payment is also required, and must be no older than 90 days
`MORTGAGE_AND_PAYMENT`	Mortgage agreement plus proof of payment	Proof of payment is also required, and must be no older than 90 days
`SALARY_STATEMENT`	Salary statement	No older than 90 days
`ID_CARD`	Identity card	Accepted when it is not also used as the identity document
`DRIVING_LICENSE`	Driving license	Accepted when it is not also used as the identity document
`GOVERNMENT_STATEMENT`	Government statement	—
`GOVERNMENT_TAX_BILL`	Government tax bill	—

Format, size and file-count limits are covered in KYC document requirements.

Employment status (employmentStatus)

code	name	desc
`EMPLOYED`	Employed	In regular paid employment
`BUSINESS_OWNER`	Business owner	Owns and runs a business
`SELF_EMPLOYED`	Self-employed	Works for themselves, including freelancers
`UNEMPLOYED`	Unemployed	Not currently in work
`PENSIONER`	Pensioner	Retired and drawing a pension
`STUDENT`	Student	In full-time education

Industry (employmentJobIndustry)

code	name	desc
`INFORMATION`	Information and Communications	Information and Communications
`RETAIL_TRADE`	Retail Trade	Retail Trade
`FINANCIAL`	Financial and Insurance Activities	Financial and Insurance Activities
`ELECTRICITY`	Electricity	Electricity
`TRANSPORT`	Transport and Storage	Transport and Storage
`CONSTRUCTION`	Construction	Construction
`TRAVEL_RELATED`	Travel Related	Travel Related
`ACCOMMODATION`	Accommodation and Food Service	Accommodation and Food Service
`ENTERTAINMENT`	Entertainment	Entertainment
`PAYMENTS`	Payments	Payments
`PROFESSIONAL`	Professional Services	Professional Services
`LUXURY_GOODS`	Luxury Goods	Luxury Goods
`MANUFACTURING`	Manufacturing	Manufacturing
`MINING_AND_QUARRYING`	Mining and Quarrying	Mining and Quarrying
`AGRICULTURE_AND_FISHING`	Agriculture and Fishing	Agriculture and Fishing
`REAL_PROPERTY`	Real Property and Land Development	Real Property and Land Development
`WHOLESALE_TRADE`	Wholesale Trade	Wholesale Trade
`NON_EMPLOYED`	Non-Employed	Non-Employed

Occupation (occupation)

code	name	number
`PHYSIOTHERAPIST`	Physiotherapist	308
`SPECIALIST`	Specialist	309
`SURGEON`	Surgeon	303
`PATHOLOGIST`	Pathologist	304
`PLASTIC_SURGEON`	Plastic surgeon	318
`PSYCHOLOGIST`	Psychologist	314
`SR_EXECUTIVE`	Senior executive	180
`CHAIRMAN`	Chairman	106
`MANAGING_DIR`	Managing director	108
`JR_EXECUTIVE`	Junior executive	200
`TERTIARY_STUDENT`	Tertiary student	2222
`UNKNOWN`	Unknown occupation	1200
`GENERAL_WORKER`	General worker	1198
`UNEMPLOYED`	Unemployed	1199
`PILOT`	Pilot	1169
`AIR_STEWARD_STEWARDESS`	Air steward / stewardess	1170
`CLERK`	Clerk	1157
`CUST_SERVICE_CONSULTANT`	Customer service consultant	1156
`ARTIST_ENTERTAINMENT`	Artist / entertainer	1183
`BEAUTY_CONSULTNT_STYLIST`	Beauty consultant / stylist	1184
`SOCIAL_WORKER`	Social worker	1141
`TECHNICAL_CONSULTANT`	Technical consultant	1131
`IT_CONSULTANT`	IT consultant	1123
`COMPUTER_ANALYST`	Computer analyst	1124
`TECHNICIAN`	Technician	1151
`WAREHOUSING_PERSONNEL`	Warehousing personnel	1152
`SYSTEMS_PROGRAMMER`	Systems programmer	1121
`TEACHER`	Teacher	1113
`INSTRUCTOR`	Instructor	1114
`ASST_PROFESSOR`	Associate professor	1107
`VICE_DEAN`	Vice dean	1104
`PROFESSOR`	Professor	1106
`APPLICATION_PROGRAMMER`	Application programmer	1122
`OTHERS`	Other occupations	1100
`REMISIER`	Remisier	1040
`PROPERTY_AGENT`	Property agent	1050
`SALES_EXEC`	Sales executive	1020
`MARKETING_EXEC`	Marketing executive	1010
`HAWKER`	Hawker	990
`CONTRACTOR`	Contractor	985
`PARTNER`	Partner	970
`ARMY_SPECIALIST`	Army specialist	860
`CIVIL_SERVANT`	Civil servant	840
`DEPUTY_PM`	Deputy prime minister	807
`CABINET_MINISTER`	Cabinet minister	809
`BANKING_PROFESSIONAL`	Banking professional	660
`BANKER_FUND_MANAGER`	Banker / fund manager	650
`POLITICIAN_CIVIL_SERVANT`	Politician / civil servant	800
`DRAFTSMAN`	Draughtsman	740
`QUANTITY_SURVEYOR`	Quantity surveyor	750
`CHEM_ENGINEER`	Chemical engineer	540
`FIN_CONTROLLER`	Financial controller	610
`PROF_ACCOUNTANCY`	Accountancy professional	600
`HIGH_COURT_JUDGE`	High Court judge	406
`CHIEF_JUSTICE`	Chief Justice	401
`AUDITOR_GENERAL`	Auditor-General	403
`CIVIL_ENGINEER`	Civil engineer	510
`ELEC_ENGINEER`	Electrical engineer	520
`LEGAL_ADVISER`	Legal adviser	490
`PROF_ENGINEER`	Professional engineer	500
`JUDGE`	Judge	408
`LAWYER`	Lawyer	420
`DOCTOR`	Doctor	360
`GEN_PRACTITIONER`	General practitioner	365
`RESEARCHER`	Researcher	350
`BIOCHEMIST`	Biochemist	351
`GYNAECOLOGIST`	Gynaecologist	322
`MATRON`	Matron	380
`ORTHOPAEDICIAN`	Orthopaedic doctor	310
`OFFICER`	Military officer	250
`PROF_MEDICAL`	Medical professional	300
`OBSTETRICIAN`	Obstetrician	320
`PSYCHIATRIST`	Psychiatrist	316
`MGT_CONSULTANT`	Management consultant	160
`REG_MANAGER`	Regional manager	140
`DIV_MANAGER`	Divisional manager	150
`TOP_EXECUTIVE`	Top executive	110
`GENERAL_MGR`	General manager	130
`DEPT_MANAGER`	Department manager	210
`EXEC_OFFICER`	Executive officer	230
`PRESIDENT`	President	102
`V_PRESIDENT_DIR`	Vice-president / director	104
`SECURITY_SAFETY_PERSON`	Security and safety personnel	1196
`HOSPITALITY_PERSONNEL`	Hospitality personnel	1197
`HOUSEWIFE`	Housewife	1190
`STUDENT`	Student	1191
`COOK_CHEF`	Cook / chef	1180
`DRIVER`	Driver	1181
`DIVER`	Diver	1160
`SECRETARY`	Secretary	1155
`DESIGNER`	Designer	1182
`SUPERVISOR`	Supervisor	1150
`EDITOR`	Editor	1145
`JOURNALIST`	Journalist	1146
`PASTOR`	Pastor	1140
`PROJECT_CO_ORDINATOR`	Project co-ordinator	1130
`SYSTEMS_ANALYST`	Systems analyst	1120
`PRINCIPAL`	Principal	1110
`V_PRINCIPAL`	Vice-principal	1111
`LECTURER`	Lecturer	1108
`DEAN`	Dean	1103
`CHANCELLOR`	Chancellor	1101
`INSURANCE_AGENT`	Insurance agent	1030
`SALESMAN`	Salesperson	1000
`SOLE_PROPRIETOR`	Sole proprietor	980
`SELF_EMPLOYED`	Self-employed	910
`BUSINESS`	Business owner	900
`POLICE`	Police officer	850
`AMBASSADOR`	Ambassador	820
`PARLIAMENTARY_SECRETARY`	Parliamentary secretary	830
`AUDITOR`	Auditor	640
`V_PRESIDENT`	Vice-president	803
`PRIME_MINISTER`	Prime minister	805
`PROF_ARCHITECT`	Professional architect	700
`ARCHITECT`	Architect	701
`MECH_ENGINEER`	Mechanical engineer	550
`SYSTEMS_ENGINEER`	Systems engineer	560
`PROCESS_ENGINEER`	Process engineer	530
`ASST_ACCOUNTANT`	Assistant accountant	622
`CREDIT_ANALYST`	Credit analyst	630
`TREASURER`	Treasurer	612
`ACCOUNTANT`	Accountant	620
`FIN_CONSULTANT`	Financial consultant	601
`HEALTHCARE_PROFESSIONAL`	Healthcare professional	390
`PROF_LAW`	Legal professional	400
`DENTIST`	Dentist	340
`CHIEF_NURSE`	Chief nurse	382
`NURSE`	Nurse	383
`RADIOGRAPHER`	Radiographer	370
`PHARMACIST`	Pharmacist	368

Job seniority (jobSeniority)

code	name	desc
`SENIOR_MANAGEMENT`	Senior management	Senior Management
`DIRECTOR`	Director	Director
`PARTNER`	Partner	Partner
`EXECUTIVE`	Executive	Executive
`TEACHER`	Teacher	Teacher
`MANAGERIAL`	Managerial	Managerial
`NON_EMPLOYED`	Non-employed	Non Employed
`SALES`	Sales	Sales
`ASSOCIATE`	Associate	Associate
`DIPLOMAT`	Diplomat	Diplomat
`SUPERVISOR`	Supervisor	Supervisor

Purpose of account (purposeOfAccount)

code	name	desc
`CASH_ADVANCE_PROGRAM`	Cash advance programme	Cash Advance Program
`INVESTMENT`	Investment	Investment
`DAILY_SPENDING`	Daily spending	Daily Spending
`BILL_PAYMENT`	Bill payment	Bill Payment
`OTHERS`	Other	others

Source of funds (sourceOfFunds)

code	name	desc
`OWN_BANK_ACCOUNT`	Own bank account	Own Bank Account
`THIRD_PARTY_BANK_ACCOUNT`	Third-party bank account	Third Party Bank Account
`CRYPTO_TOP_UP`	Crypto top-up	Crypto Top Up
`DUSD`	DUSD	DUSD

Source of wealth (sourceOfWealth)

code	name	desc
`EMPLOYMENT`	Employment income	Employment
`SAVINGS`	Savings	Savings
`INHERITANCE`	Inheritance	Inheritance
`BUSINESS`	Business income	Business
`INVESTMENT`	Investment income	Investment
`TRUST_FUND`	Trust fund	Trust Fund
`CRYPTOCURRENCIES`	Cryptocurrencies	Cryptocurrencies

Next steps

For where these enumerations are used, see the request parameter tables in Apply for KYC.
For how proof of address (POA) is submitted during the KYC flow, see Apply for KYC.

​📄 Guide

​Address proof document type (poaDocType)

​Employment status (employmentStatus)

​Industry (employmentJobIndustry)

​Occupation (occupation)

​Job seniority (jobSeniority)

​Purpose of account (purposeOfAccount)

​Source of funds (sourceOfFunds)

​Source of wealth (sourceOfWealth)

​Next steps