📄 Guide
The values below apply to thekycInfosub-fields ofPOST /card/v1/virtual-card/apply. Submit the value from thecodecolumn.
Proof of address 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.
A proof of address must be no older than three months, and screenshots are not accepted.
| code | Name | Validity / notes |
|---|---|---|
UTILITY_BILL | Utility bill | 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 | — |
Employment status (employmentStatus)
| code | Name | Description |
|---|---|---|
EMPLOYED | Employed | In regular paid employment |
BUSINESS_OWNER | Business owner | Owns and runs a business |
SELF_EMPLOYED | Self-employed | Works independently or freelances |
UNEMPLOYED | Unemployed | Currently out of work |
PENSIONER | Pensioner | Retired and drawing a pension |
STUDENT | Student | Currently in education |
WhenemploymentStatus = EMPLOYED,employerNamebecomes required.
Industry (employmentJobIndustry)
| code | Name | English label |
|---|---|---|
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)
Submit thecodevalue; thenumbercolumn is the internal code for that occupation and is provided for cross-reference only.
| 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 | Flight attendant | 1170 |
CLERK | Clerk | 1157 |
CUST_SERVICE_CONSULTANT | Customer service consultant | 1156 |
ARTIST_ENTERTAINMENT | Artist or entertainer | 1183 |
BEAUTY_CONSULTNT_STYLIST | Beauty consultant or 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 | Assistant professor | 1107 |
VICE_DEAN | Vice dean | 1104 |
PROFESSOR | Professor | 1106 |
APPLICATION_PROGRAMMER | Application programmer | 1122 |
OTHERS | Other occupation | 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 or fund manager | 650 |
POLITICIAN_CIVIL_SERVANT | Politician or civil servant | 800 |
DRAFTSMAN | Draftsman | 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 surgeon | 310 |
OFFICER | 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 or director | 104 |
SECURITY_SAFETY_PERSON | Security and safety personnel | 1196 |
HOSPITALITY_PERSONNEL | Hospitality personnel | 1197 |
HOUSEWIFE | Homemaker | 1190 |
STUDENT | Student | 1191 |
COOK_CHEF | Cook or 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 | English label |
|---|---|---|
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 |
Purpose of account (purposeOfAccount)
| code | Name | English label |
|---|---|---|
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 | Others | others |
Source of funds (sourceOfFunds)
| code | Name | English label |
|---|---|---|
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 deposit | Crypto Top Up |
DUSD | DUSD | DUSD |
Source of wealth (sourceOfWealth)
| code | Name | English label |
|---|---|---|
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
- Issuing Cards — how these enum fields fit into
kycInfoand the card issuing request body - Authentication guide — the common response envelope and how to judge errors

