Retrieve reference data used to populate SME onboarding dropdowns for Industry and Business Sector
This is a draft version of the SME Onboarding APIs. The final version is expected to be released by the end of September. The API specifications are subjected to go through a few more changes before the final version is released.
List of Values API provides the codes and names required for dropdown fields in the Corporate Digital onboarding journey. Use this API when your onboarding interface needs to retrieve the available industry or business sector values.
The available dropdown configurations include Industry (type: 170) and Business Sector (type: 176).
Environment | Domain | Rate/Limit |
|---|---|---|
Sandbox | 3 Calls per Minute | |
Production/LIVE | To be provided upon onboarding | Based on contract |
Endpoint | Method | Authentication requirements |
|---|---|---|
| POST | Header
Request body
|
curl --location 'https://sandboxapi.onesingleview.com/api/v2/smeonboarding/listofvalues' \
--header 'SVReferenceID: SV123456' \
--header 'CompanyId: SINGLEVIEW1234' \
--header 'Device: web' \
--header 'DateTimeStamp: 2025-01-07T10:20:39' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjoiTDNyMmpxV29JS2I4MTNodDBNeVN4WFRCZjlqUlNWQzFad3B5QnlkOVpHelZXR2ZwUmFQNUUrY3d6cVQ5bi9OV0lwR2V5STNNMkdPL1pqakd4ZG0yclJkVEZxY3lhWGNpWnZFejl0V1EySjQxK2VvSlk2ZjdJZkFsV3BKRi9VL1YydDEzMUtnRnVhcnd6MzVQY1UzbnFEV0p0UWlzIiwiaWF0IjoxNzY3NzYxODc3LCJleHAiOjE3Njc3NjU0Nzd9.lWDSB3Rk_TtdUbKyFcCdaE5XGo7UDiTu2kDcqEyU7vg' \
--header 'Content-Type: application/json' \
--data '{
"Message": {
"ListOfValuesRequest": {
"AgentId": "",
"Type": "170",
"Code1": "INDUSTRY",
"Code3": "CORP.DIGI",
"Code4": "Y"
}
},
"Signature": "rZZ9alg/2k9B5uWSdnW3AfYswAMqA4HXyNX3jIzckWb4o37uS4eKFEQ3xRn/dBarN6EGjfaXiMSOPdKyyjjrgT80K5ReXzQ7cC1INuU79ozlLgK8yTFz+nq785geQ+He4PR+hD35DkF9qnela9qmcr3GhAXpTjZG12hmaJEyzeofh6q3p+jqLFd208eAImubnL6SbSBDEAi5SLRH1K2I1U77OmFNirrfGV8qd+gsi+lqgyF9mpNj6lzy/fJNNe0qEr2WHvG1R7E2g3EhqovDNanQt6RFgkWegtlE37Eyi5qO3xlTqu76317ZWfMI7jHxs48fOLTNtBCOwUboVze5Tw=="
}Request parameters
JSON Tag | Requirement | Description | Data type |
|---|---|---|---|
ListOfValuesRequest | Mandatory | Root node containing information to request the list of values for industries and sectors | Object |
AgentId | Mandatory | Agent identifier to be left blank | String |
Type | Mandatory | Identifies the type of list to retrieve. | String |
Code1 | Mandatory | Identifies the list category. Use | String |
Code3 | Mandatory | Journey identifier to be specified as | String |
Code4 | Mandatory | Indicates the applicable configuration to be specified as | String |
{
"ListOfValuesResponse": {
"StatusCode": "Completed",
"StatusDetail": "List of values fetched successfully.",
"ListOfValues": [
{
"Code": "100",
"Name": "COMMERCIAL"
},
{
"Code": "1600",
"Name": "DAIRY"
},
{
"Code": "1610",
"Name": "POULTRY"
},
{
"Code": "1620",
"Name": "SLAUGHTERHOUSE AND MEAT PROCESSING"
},
{
"Code": "1630",
"Name": "GRAINS"
},
{
"Code": "1640",
"Name": "VEGETABLES"
},
{
"Code": "1650",
"Name": "FRUITS"
},
{
"Code": "1660",
"Name": "FISHING"
},
{
"Code": "1670",
"Name": "NURSERIES"
},
{
"Code": "1680",
"Name": "LANDSCAPING"
},
{
"Code": "1690",
"Name": "GARDENING"
},
{
"Code": "1700",
"Name": "ANIMAL FARMING"
},
{
"Code": "1799",
"Name": "OTHERS - AGRICULTURE & FISHING"
},
{
"Code": "1800",
"Name": "FOOD CANNING"
},
{
"Code": "1810",
"Name": "BEVERAGES BOTTLING & CANNING"
},
{
"Code": "1820",
"Name": "REFINED OIL AND FATS"
},
{
"Code": "1830",
"Name": "CHEMICAL PRODUCTS"
},
{
"Code": "1840",
"Name": "PETROCHEMICALS"
},
{
"Code": "1850",
"Name": "CAR ASSEMBLY"
},
{
"Code": "1870",
"Name": "FERTILIZERS"
},
{
"Code": "1880",
"Name": "CEMENT"
},
{
"Code": "1900",
"Name": "PIPES"
},
{
"Code": "1910",
"Name": "CERAMICS"
},
{
"Code": "1920",
"Name": "PLASTICS"
},
{
"Code": "1930",
"Name": "LEATHER & LEATHER PRODUCTS"
},
{
"Code": "1940",
"Name": "WOOD PRODUCTS & FURNITURE"
},
{
"Code": "1950",
"Name": "GLASS AND GLASS PRODUCTS"
},
{
"Code": "1960",
"Name": "FABRICATED METAL PRODUCTS"
},
{
"Code": "1970",
"Name": "OFFICE MACHINERY & COMPUTERS"
},
{
"Code": "1980",
"Name": "ELECTRICAL MACHINERY & COMPONENTS"
},
{
"Code": "1990",
"Name": "RECYCLING"
},
{
"Code": "2010",
"Name": "MEDICAL EQUIPMENT"
},
{
"Code": "2020",
"Name": "DRUGS PHARMACEUTICALS+B95+B49"
},
{
"Code": "2030",
"Name": "CARPETS AND RUGS"
},
{
"Code": "2050",
"Name": "IRON STEEL"
},
{
"Code": "2060",
"Name": "ALUMINUM & ALUMINUM PRODUCTS"
},
{
"Code": "2070",
"Name": "AIR-CONDITIONING AND COOLING APPL"
},
{
"Code": "2080",
"Name": "DOMESTIC APPLIANCES"
},
{
"Code": "2090",
"Name": "MACHINERY"
},
{
"Code": "2099",
"Name": "OTHERS - MANUFACTURING & PROCESS"
},
{
"Code": "2140",
"Name": "GRANITE"
},
{
"Code": "2160",
"Name": "MARBLE"
},
{
"Code": "2300",
"Name": "PRIVATE HOSPITALS"
},
{
"Code": "2310",
"Name": "CLINICS"
},
{
"Code": "2320",
"Name": "LABORATORIES"
},
{
"Code": "2399",
"Name": "OTHERS - HEALTH SERVICES"
},
{
"Code": "2400",
"Name": "CIVIL ENGINEERING & DESIGN"
},
{
"Code": "2410",
"Name": "ELECTRICAL INSTALLERS"
},
{
"Code": "2430",
"Name": "BUILDING AND CONSTRUCTION"
},
{
"Code": "2440",
"Name": "MECHANICAL"
},
{
"Code": "2480",
"Name": "PLUMBING"
},
{
"Code": "2550",
"Name": "FROZEN FOODS"
},
{
"Code": "2570",
"Name": "MOTORS , ACCESSORIES"
},
{
"Code": "2590",
"Name": "Buying/Selling Heavy Machinery,Eqpt"
},
{
"Code": "2600",
"Name": "CHINAWARE"
},
{
"Code": "2610",
"Name": "LEATHER GOODS"
},
{
"Code": "2620",
"Name": "ELECTRONICS/ELECTRICAL APPLIANCES"
},
{
"Code": "2630",
"Name": "TEXTILES"
},
{
"Code": "2670",
"Name": "DEPARTMENT STORES"
},
{
"Code": "2680",
"Name": "LIVESTOCK"
},
{
"Code": "2690",
"Name": "PAPER PRINTING/STATIONERY"
},
{
"Code": "2700",
"Name": "HARDWARE"
},
{
"Code": "2710",
"Name": "DRUGS & PHARMACEUTICALS"
},
{
"Code": "2720",
"Name": "FURNITURE"
},
{
"Code": "2740",
"Name": "CAR PARTS"
},
{
"Code": "2799",
"Name": "OTHERS - WHOLESALE TRADE"
},
{
"Code": "2900",
"Name": "Buying/Selling Car,Truck,Motorcycle"
},
{
"Code": "2910",
"Name": "FURNITURE"
},
{
"Code": "2920",
"Name": "HOME APPLIANCES"
},
{
"Code": "3000",
"Name": "TRANSPORTATION SUPPORT SERVICES"
},
{
"Code": "3010",
"Name": "TRUCKING/TRANSPORTATION"
},
{
"Code": "3020",
"Name": "SERVICE STATION"
},
{
"Code": "3030",
"Name": "TRAVEL AGENTS"
},
{
"Code": "3040",
"Name": "SEA TRANSPORT"
},
{
"Code": "3080",
"Name": "COURIER SERVICES"
},
{
"Code": "3099",
"Name": "OTHERS- TRANSPORTATION & COMMUNICAT"
},
{
"Code": "3100",
"Name": "MAINTENANCE"
},
{
"Code": "3120",
"Name": "CATERING"
},
{
"Code": "3130",
"Name": "RENT A CAR"
},
{
"Code": "3140",
"Name": "SECURITY SYSTEMS"
},
{
"Code": "3150",
"Name": "MARINE SERVICES"
},
{
"Code": "3160",
"Name": "ACCOUNTING & AUDIT"
},
{
"Code": "3190",
"Name": "MARKET RESEARCH"
},
{
"Code": "3210",
"Name": "PHOTOGRAPHING"
},
{
"Code": "3220",
"Name": "TRANSLATION"
},
{
"Code": "3230",
"Name": "RECREATIONAL, SPORTING"
},
{
"Code": "3240",
"Name": "ORGANIZATION & MANAGEMENT"
},
{
"Code": "3250",
"Name": "SOFTWARE PRODUCTION"
},
{
"Code": "3260",
"Name": "HOTELS"
},
{
"Code": "3270",
"Name": "REPAIRS/REPAINTING"
},
{
"Code": "3280",
"Name": "PUBLISHING & PRINTING"
},
{
"Code": "3290",
"Name": "ADVERTISING"
},
{
"Code": "4560",
"Name": "Contracting-Others"
},
{
"Code": "5010",
"Name": "Retail Trade"
},
{
"Code": "5090",
"Name": "Other transport"
},
{
"Code": "5100",
"Name": "Travel agencies"
},
{
"Code": "5110",
"Name": "Tour operators"
},
{
"Code": "5130",
"Name": "Telecommunications"
},
{
"Code": "6000",
"Name": "Real Estate & Rental-Commercial"
},
{
"Code": "6010",
"Name": "Estate agents in sales"
},
{
"Code": "6020",
"Name": "Estate agents in letting"
},
{
"Code": "6040",
"Name": "Renting of cars and light vans"
},
{
"Code": "6050",
"Name": "Renting of other transport"
},
{
"Code": "6060",
"Name": "Renting of oth machinery and equip"
},
{
"Code": "6070",
"Name": "Renting of pers and hsehold goods"
},
{
"Code": "6100",
"Name": "Real Estate & Rental-Residential"
},
{
"Code": "6120",
"Name": "Maint and repair of Computer"
},
{
"Code": "6130",
"Name": "Legal, Accounting, Auditing: tax"
},
{
"Code": "6140",
"Name": "Business and Mgt Consultancy"
},
{
"Code": "6150",
"Name": "Architectural and Engineering Activ"
},
{
"Code": "6160",
"Name": "Technical testing and Analysis"
},
{
"Code": "7320",
"Name": "Veterinary activities"
},
{
"Code": "7510",
"Name": "Sanitation, Sewage, Refuse disp"
},
{
"Code": "9900",
"Name": "E-Commerce"
}
]
}
}Response parameters
JSON Tag | Description | Data type |
|---|---|---|
ListOfValuesResponse | Root node containing information of response for list of values | Object |
StatusCode | Code representing status of the transaction in the request | String |
StatusDetail | Details of the status code represented for the transaction in the request | String |
ListOfValues | Contains the available list values for industries or sectors | Object |
Code | Code assigned to the list value for Industry or Sector | String |
Name | Display name of the list value for Industry or Sector | String |
StatusCode | StatusDetail |
|---|---|
Completed | List of values fetched successfully. |
Failed | Bank response description |
Response_Timeout | Timeout! Unable to get response from the bank. Please try again or contact SingleView support if issue persists. |
Call this API on demand when the onboarding UI needs to populate an Industry or Business Sector dropdown. Store the returned Code as the value submitted to subsequent APIs, while displaying the corresponding Name to the user.