Global KYB - Asia Pacific

Overview and Purpose
Overview:
The Global KYB API, known as "Global Know Your Business," is a robust and comprehensive solution designed to facilitate Know Your Business (KYB) verifications on organizations worldwide. It offers a rich set of data that enables businesses and organizations to assess and verify critical information about other companies. The API provides detailed insights into a company's background, ownership, financial status, and more, making it an essential tool for due diligence, risk mitigation, and compliance.
Purpose:
The primary purpose of the Global KYB API is to empower businesses with accurate and up-to-date information about their business counterparts. Here are the key objectives and usecases:
Business Verification: The API retrieves crucial details such as company registration, legal status, contact information, and industry specifics. This facilitates the verification of business entities, ensuring that they are legitimate and compliant with local regulations.
Risk Assessment: Global KYB assists in evaluating the financial health and stability of a company by providing information on registered capital, shareholders, and subsidiaries. This aids in risk assessment and decision-making processes for partnerships, investments, and trade relationships.
Due Diligence: The API supports due diligence efforts by offering insights into a company's history, ownership, and associated individuals. It enables organizations to make informed choices regarding potential business engagements.
Compliance: Global KYB helps businesses adhere to regulatory requirements and industry standards by providing data on business types, licenses, and regulatory authorities. This ensures that companies operate within the bounds of applicable laws.
Global Reach: With coverage spanning various countries and regions, the API offers an extensive dataset, facilitating KYB checks on entities operating worldwide.
By integrating the Global KYB API, businesses can enhance their risk management strategies, improve decision-making processes, and ensure compliance with local and international regulations. This API serves as a valuable asset for organizations seeking to establish secure and trustworthy business relationships on a global scale.
Supported Countries
Country
Country Code
Supported Company Numbers
Coverage 
Singapore
SG
Unique Entity Number
95 %
China
CN
Unified Social Credit Code
100 %
Hong Kong
HK
Company Registration Number
100 %
Taiwan
TW
Unified Business number
100 %
Japan
JP
National Tax Agency Company Number
95 %
India
IN
Corporate Identification Number
95 %
New Zealand
NZ
Newzealand Business Number
95 %
Vietnam
VN
Enterprise Code Number
95 %
Thailand
TH
Corporate Registration Number
95 %
Australia
AU
Australian Business Number
95 %
API Details
Sample cURL
pre-production
curl --location 'https://api-preproduction.signzy.app/api/v3/global/kybAsia' \
--header 'Authorization: --Auth - Token--' \
--header 'Content-Type: application/json' \
--data '{
    "companyNumber": "91110000710926094P",
    "companyName": "中国石油化工股份有限公司",
    "countryCode": "<ALPHA 2 Country Code>",
    "language": "<EN or OG>",
    "agency" : "", //Required for Taiwan Only
    "codeField" : "", //Reuired for Australia Only
    "template": "kybStandard",
    "fetchUBO": false,
    "uboDetails": {
        "threshold": "15",
        "layers": "10",
        "realtimeFlag": true,
        "cachePeriod": 30,
        "notifyURL": "https://webhook.site/184dceba-dea8-4e4e-bf99-bff829334288"
    }
}'
curl --location 'https://api-preproduction.signzy.app/api/v3/global/kybAsia' \
--header 'Authorization: --Auth - Token--' \
--header 'Content-Type: application/json' \
--data '{
    "companyNumber": "91110000710926094P",
    "companyName": "中国石油化工股份有限公司",
    "countryCode": "<ALPHA 2 Country Code>",
    "language": "<EN or OG>",
    "agency" : "", //Required for Taiwan Only
    "codeField" : "", //Reuired for Australia Only
    "template": "kybStandard",
    "fetchUBO": false,
    "uboDetails": {
        "threshold": "15",
        "layers": "10",
        "realtimeFlag": true,
        "cachePeriod": 30,
        "notifyURL": "https://webhook.site/184dceba-dea8-4e4e-bf99-bff829334288"
    }
}'
﻿
Request Body
pre-production
{
    "companyNumber": "91110000710926094P",
    "companyName": "Name in Native or English",
    "countryCode": "CN",
    "language": "EN",
    "template": "kybStandard",
    "fetchUBO": false,
    "uboDetails": {
        "threshold": "15",
        "layers": "10",
        "realtimeFlag": true,
        "cachePeriod": 30,
        "notifyURL": "https://webhook.site/184dceba-dea8-4e4e-bf99-bff829334288"
    }
}
{
    "companyNumber": "91110000710926094P",
    "companyName": "Name in Native or English",
    "countryCode": "CN",
    "language": "EN",
    "template": "kybStandard",
    "fetchUBO": false,
    "uboDetails": {
        "threshold": "15",
        "layers": "10",
        "realtimeFlag": true,
        "cachePeriod": 30,
        "notifyURL": "https://webhook.site/184dceba-dea8-4e4e-bf99-bff829334288"
    }
}
﻿
Request Body Parameters
Request Parameter
Data Type
Manadory/Optional
Description
companyName
String
Optional
It is Legal name of company. Can be inputed in Local language as well as in English
companyNumber
String
Mandatory (Optional in some cases)
Company's registration number, can be varied from country to country
agency
String
Mandatory (Applicable for Taiwan only)
This field is mandatory for Taiwan only (Can be left blank)
codeField
String
Mandatory (Applicable for Australia only)
Mandatory for australia only(Can not be left blank)
countryCode
String
Mandatory
User needs to input Alpha - 2 Country code in the request body
language
String
Mandatory
Language can be EN (English) or OG (Native Language per country
Response language will depend on language field of input
template
String
Mandatory
For LITE request, template will be KYBLite
For Standard requests, template will be KYBStandard
fetchUBO
Boolean
Mandatory
If true then will recieve UBO details on mentioned notifyURL
uboDetails
Object
Optional
﻿
threshold
Number
Optional
This field represents minimum % of shares one must own to be classified as UBO
Cane be 10, 15 or 25
layers
String
Optional
This will represnt how many layers of UBO details one wants to retrive
realtimeFlag
Boolean
Optional
If true then API will retrive realtime data from authorized data source,
Else data will be served from cache of the authorized source
cacheperiod
Number
Optional
The user is required to specify the number of days for which the cache will be searched to retrieve data.
The minimum value will be 30 and maximum is 365 days
notifyURL
String
Mandatory (If Fetch UBO is True)
The callback url on which the UBO details will be sent
Mandatory paramters per country
This table mentions which parameter except country code, template, language, fetchUbo are mandatory and optional for each country, as some countries need company number whereas some countries either of company name or number
Country
Mandatory Parameters
Singapore
Company Number
China
Either Company name or Company Number
Taiwan
Either Company name or Company Number + Agency Code
Hongkong
Either Company name or Company Number
Japan
Either Company name or Company Number
India
Company Number (Mandatory for MSME, Optional for MCA)
New Zealand
Company Name & Company Number
Australia
Company Number & Code Field
Thailand
Either Company name or Company Number
Vietnam
Either Company name or Company Number
﻿
Response Body (Global KYB - LITE)
JSON
{
    "result": {
        "crnNumber": "34144373",
        "companyName": "STANDARD CHARTERED BANK (HONG KONG) LIMITED",
        "ogName": "渣打銀行(香港)有限公司",
        "businessStatus": "Live",
        "establishDate": "2003-12-12",
        "companyAddress": "Hong Kong"
    }
}
{
    "result": {
        "crnNumber": "34144373",
        "companyName": "STANDARD CHARTERED BANK (HONG KONG) LIMITED",
        "ogName": "渣打銀行(香港)有限公司",
        "businessStatus": "Live",
        "establishDate": "2003-12-12",
        "companyAddress": "Hong Kong"
    }
}
﻿
Response Body Parameters (Global KYB - LITE)
Response Parameter
Description
crnNumber
This field Provides company number. The name of this field can change according to country 
e.g. usccNumber for China, abnNumber for Australia
companyName
This field provides company name in English
ogName
This field provides company name in Native Language
businessStatus
This field provides current status of business
establishDate
This field returns date of establishment of a particular business
companyAddress
This field returns registered address for a particular business
Response Body (Global KYB - Standard/Basic)
JSON
{
    "result": {
        "companyInformation": {
            "total": 1,
            "data": [
                {
                    "historyNames": [],
                    "stockNumber": "",
                    "regCapital": "119,896,407,646.00 RMB",
                    "contactInfo": {
                        "phoneNumber": "010-59960114",
                        "webSites": [
                            {
                                "webSite": "http://www.sinopec.com"
                            }
                        ],
                        "email": "[email protected]"
                    },
                    "regAuthority": "Beijing Municipal Administration for Market Regulation",
                    "industry": {
                        "subIndustry": "Petroleum, coal and other fuel processing industry",
                        "industry": "manufacturing",
                        "smallCategory": "",
                        "middleCategory": "Refined petroleum product manufacturing"
                    },
                    "revokeDate": "",
                    "personScope": "More than 10,000 people",
                    "legalPersonName": "Ma Yongsheng",
                    "revokeReason": "",
                    "entType": "",
                    "orgType": "Other Limited Company By Shares (Public Listed)",
                    "regNumber": "100000000032985",
                    "creditCode": "91110000710926094P",
                    "province": "Beijing",
                    "orgCode": "71092609-4",
                    "enName": "China Petroleum&Chemical Corporation",
                    "insuredEmployee": "394144",
                    "impExpCode": "",
                    "bizStatus": "Existing (In Operation, Open, Registered)",
                    "regAddress": "No. 22, Chaoyangmen North Street, Chaoyang District, Beijing",
                    "area": {
                        "province": "Beijing",
                        "city": "Beijing",
                        "county": "Chaoyang District, Beijing"
                    },
                    "stockType": "China A-Stock",
                    "toDate": "No fixed term",
                    "businessScope": "Bottled gas operation (limited to branches with licenses); hazardous chemicals production, oil and gas exploration, development and production safety management (limited to branches with safety production licenses); railway transportation; port operations; edible salt production, Wholesale and retail (operated only by branches with licenses and not in this city); food additive manufacturing (operated only by branches in other places); insurance agency business (operated only by branches in other places); insurance brokerage business (operated only by branches in other places) ); Accommodation (operated only by branches in other places); Catering services (operated only by branches in other places); Thermal power generation (not operated in this city); Electricity supply (operated only by branches); Power generation, transmission, and power supply business; Hazardous chemical operations (Limited to branches that have obtained hazardous chemicals business licenses); oil and gas exploration; petroleum mining (the mining area and validity period are subject to the license); retail of prepackaged food, bulk food, and dairy products (including infant formula milk powder) ) (limited to branches with a food circulation license), health food (limited to branches with a food circulation license); retail sales of cigarettes and cigars (limited to branches with a tobacco monopoly retail license); books , newspapers, periodicals, electronic publications, audio and video products retail; road transportation (limited to branch operations, business scope is subject to road transportation business license); petroleum refining; heavy oil, rubber and other petrochemical raw materials (excluding hazardous chemicals) products) and the production, sale and storage of products; daily necessities convenience store operations; lottery agent sales, entrusted agents to collect water and electricity bills, ticket agency services; design, production, agency and advertising; car cleaning services; petroleum and petrochemical machinery and equipment Manufacturing, supervision and installation; procurement and sales of petroleum and petrochemical raw and auxiliary materials, equipment and parts; research, development, application and consulting services of technology and information, alternative energy products; contracting of overseas electromechanical and petrochemical industry projects and domestic and international Bidding projects; automobile repair and decoration services; coastal engineering auxiliary operations; oil spill emergency, safety guarding, ship pollution removal operations; quality inspection technical services, environmental and ecological testing services in the professional and technical service industry; cargo transportation agency; shale gas, coal seam Exploration, development, storage and transportation, pipeline transportation, and sales of gas, shale oil, flammable ice and other resources (not operated in this city); power technology development and services; installation and maintenance of power facilities (limited to branch operations); sales of furniture and building decoration Materials (operated only by branches in other places); household labor services (operated only by branches in other places); warehousing services (operated only by branches in other places); leasing of gas storage facilities (operated only by branches in other places); leasing of commercial buildings and offices Housing; car rental (excluding passenger cars with more than nine seats); machinery and equipment rental; import and export of goods; import and export agency; technology import and export. Sales of lubricants, fuel oil, asphalt, textiles, clothing, daily necessities, hardware, household appliances and electronic products, recharge cards, culture, sporting goods and equipment, automobiles, motorcycles and spare parts, motor vehicle charging, batteries, new energy vehicles Power exchange facilities. (Market entities independently select business projects and carry out business activities in accordance with the law; power generation, transmission, power supply business and projects that require approval in accordance with the law shall carry out business activities in accordance with the approved content after approval by the relevant departments; they shall not engage in activities prohibited by the national and this city’s industrial policies and Business activities of restricted projects.)",
                    "branches": [
                        {
                            "creditCode": "",
                            "belongOrg": "Xiangfen County Market Supervision and Administration Bureau",
                            "name": "China Petroleum & Chemical Corporation Shanxi Xiangfen Zhaokang Gas Station",
                            "operName": ""
                        },
                        {
                            "creditCode": "",
                            "belongOrg": "Youxian Food and Drug Administration for Industry and Commerce Quality Supervision",
                            "name": "China Petroleum & Chemical Corporation, Jiashan Gas Station, You County, Hunan Province",
                            "operName": ""
                        },
                        {
                            "creditCode": "",
                            "belongOrg": "Zhumadian City Shangcai County Market Supervision and Administration Bureau",
                            "name": "China Petroleum & Chemical Corporation Henan Zhumadian Shangcai Yangji Gas Station",
                            "operName": ""
                        },
                        
                        {
                            "creditCode": "",
                            "belongOrg": "Dingyuan County Market Supervision and Administration Bureau",
                            "name": "Sinopec Dingyuan Luqiao Oil Depot",
                            "operName": ""
                        },
                        {
                            "creditCode": "",
                            "belongOrg": "Xuyi County Administrative Approval Bureau",
                            "name": "China Petroleum & Chemical Corporation, Jiangsu Huaian Xuyi Mingzuling Gas Station",
                            "operName": ""
                        },
                        {
                            "creditCode": "",
                            "belongOrg": "Longyan City Administration for Industry and Commerce of Fujian Province",
                            "name": "China Petroleum & Chemical Corporation Fujian Longyan Baisha Gas Station",
                            "operName": ""
                        },
                        {
                            "creditCode": "",
                            "belongOrg": "Loudi Administration for Industry and Commerce",
                            "name": "Sinopec Hunan Loudi Tea Garden Gas Station",
                            "operName": ""
                        }
                    ],
                    "establishDate": "2000-02-25",
                    "approvedDate": "2023-09-18",
                    "fromDate": "2000-02-25",
                    "tagList": [],
                    "isListed": "Listed",
                    "ogName": "中国石油化工股份有限公司",
                    "contactInfoARList": [
                        {
                            "emailAddress": "[email protected]",
                            "address": "No. 22, Chaoyangmen North Street, Chaoyang District, Beijing City",
                            "contactNo": "010-59960114"
                        },
                        {
                            "emailAddress": "[email protected]",
                            "address": "No. 22, Chaoyangmen North Street, Chaoyang District, Beijing City",
                            "contactNo": "010-59960114"
                        },
                        {
                            "emailAddress": "[email protected]",
                            "address": "No. 22, Chaoyangmen North Street, Beijing City",
                            "contactNo": "010-59960114"
                        },
                        {
                            "emailAddress": "[email protected]",
                            "address": "No. 22, Chaoyangmen North Street, Beijing City",
                            "contactNo": "010-59960114"
                        }
                    ]
                }
            ]
        },
        "majorPersonsData": {
            "total": 19,
            "data": [
                {
                    "staffName": "Bi Mingjian",
                    "positions": "Independent Director"
                },
                {
                    "staffName": "Ma Yongsheng",
                    "positions": "Chairman"
                },
                {
                    "staffName": "Lv Lianggong",
                    "positions": "Director"
                },
                {
                    "staffName": "Yu Baocai",
                    "positions": "Director,Manager"
                },
                {
                    "staffName": "Wu Jianing",
                    "positions": "Independent Director"
                },
                {
                    "staffName": "Shi Dan",
                    "positions": "Independent Director"
                },
                {
                    "staffName": "Shou Donghua",
                    "positions": "Financial manager"
                },
                {
                    "staffName": "Zhao Dong",
                    "positions": "Director"
                },
                {
                    "staffName": "Ling Yiqun",
                    "positions": "Director"
                },
                {
                    "staffName": "Cai Hongbin",
                    "positions": "Independent Director"
                }
            ]
        },
        "shareholdersData": {
            "total": 2,
            "data": [
                {
                    "shareholderSource": "Public Displayed Shareholder",
                    "amount": "80,587,000,000 Shares",
                    "shoudDate": "",
                    "StockName": "China Petrochemical Corporation",
                    "UltBenefitPer": "",
                    "CountryRegion": "China",
                    "StockTag": [],
                    "StockPercent": "67.23%",
                    "realCapiType": "",
                    "shareType": "Number of Shares",
                    "ShouldCapi": "",
                    "creditCode": "9111000010169286X1",
                    "CapiDate": "",
                    "StockType": "Corporate Shareholder",
                    "RealCapi": "",
                    "shouldCapiType": ""
                },
                {
                    "shareholderSource": "Public Displayed Shareholder",
                    "amount": "24,600,000,000 Shares",
                    "shoudDate": "",
                    "StockName": "HKSCC NOMINEES LIMITED",
                    "UltBenefitPer": "",
                    "CountryRegion": "",
                    "StockTag": [],
                    "StockPercent": "20.52%",
                    "realCapiType": "",
                    "shareType": "Number of Shares",
                    "ShouldCapi": "",
                    "creditCode": "",
                    "CapiDate": "",
                    "StockType": "Corporate Shareholder",
                    "RealCapi": "",
                    "shouldCapiType": ""
                }
            ]
        }
    }
}
{
    "result": {
        "companyInformation": {
            "total": 1,
            "data": [
                {
                    "historyNames": [],
                    "stockNumber": "",
                    "regCapital": "119,896,407,646.00 RMB",
                    "contactInfo": {
                        "phoneNumber": "010-59960114",
                        "webSites": [
                            {
                                "webSite": "http://www.sinopec.com"
                            }
                        ],
                        "email": "master@sinopec.com"
                    },
                    "regAuthority": "Beijing Municipal Administration for Market Regulation",
                    "industry": {
                        "subIndustry": "Petroleum, coal and other fuel processing industry",
                        "industry": "manufacturing",
                        "smallCategory": "",
                        "middleCategory": "Refined petroleum product manufacturing"
                    },
                    "revokeDate": "",
                    "personScope": "More than 10,000 people",
                    "legalPersonName": "Ma Yongsheng",
                    "revokeReason": "",
                    "entType": "",
                    "orgType": "Other Limited Company By Shares (Public Listed)",
                    "regNumber": "100000000032985",
                    "creditCode": "91110000710926094P",
                    "province": "Beijing",
                    "orgCode": "71092609-4",
                    "enName": "China Petroleum&Chemical Corporation",
                    "insuredEmployee": "394144",
                    "impExpCode": "",
                    "bizStatus": "Existing (In Operation, Open, Registered)",
                    "regAddress": "No. 22, Chaoyangmen North Street, Chaoyang District, Beijing",
                    "area": {
                        "province": "Beijing",
                        "city": "Beijing",
                        "county": "Chaoyang District, Beijing"
                    },
                    "stockType": "China A-Stock",
                    "toDate": "No fixed term",
                    "businessScope": "Bottled gas operation (limited to branches with licenses); hazardous chemicals production, oil and gas exploration, development and production safety management (limited to branches with safety production licenses); railway transportation; port operations; edible salt production, Wholesale and retail (operated only by branches with licenses and not in this city); food additive manufacturing (operated only by branches in other places); insurance agency business (operated only by branches in other places); insurance brokerage business (operated only by branches in other places) ); Accommodation (operated only by branches in other places); Catering services (operated only by branches in other places); Thermal power generation (not operated in this city); Electricity supply (operated only by branches); Power generation, transmission, and power supply business; Hazardous chemical operations (Limited to branches that have obtained hazardous chemicals business licenses); oil and gas exploration; petroleum mining (the mining area and validity period are subject to the license); retail of prepackaged food, bulk food, and dairy products (including infant formula milk powder) ) (limited to branches with a food circulation license), health food (limited to branches with a food circulation license); retail sales of cigarettes and cigars (limited to branches with a tobacco monopoly retail license); books , newspapers, periodicals, electronic publications, audio and video products retail; road transportation (limited to branch operations, business scope is subject to road transportation business license); petroleum refining; heavy oil, rubber and other petrochemical raw materials (excluding hazardous chemicals) products) and the production, sale and storage of products; daily necessities convenience store operations; lottery agent sales, entrusted agents to collect water and electricity bills, ticket agency services; design, production, agency and advertising; car cleaning services; petroleum and petrochemical machinery and equipment Manufacturing, supervision and installation; procurement and sales of petroleum and petrochemical raw and auxiliary materials, equipment and parts; research, development, application and consulting services of technology and information, alternative energy products; contracting of overseas electromechanical and petrochemical industry projects and domestic and international Bidding projects; automobile repair and decoration services; coastal engineering auxiliary operations; oil spill emergency, safety guarding, ship pollution removal operations; quality inspection technical services, environmental and ecological testing services in the professional and technical service industry; cargo transportation agency; shale gas, coal seam Exploration, development, storage and transportation, pipeline transportation, and sales of gas, shale oil, flammable ice and other resources (not operated in this city); power technology development and services; installation and maintenance of power facilities (limited to branch operations); sales of furniture and building decoration Materials (operated only by branches in other places); household labor services (operated only by branches in other places); warehousing services (operated only by branches in other places); leasing of gas storage facilities (operated only by branches in other places); leasing of commercial buildings and offices Housing; car rental (excluding passenger cars with more than nine seats); machinery and equipment rental; import and export of goods; import and export agency; technology import and export. Sales of lubricants, fuel oil, asphalt, textiles, clothing, daily necessities, hardware, household appliances and electronic products, recharge cards, culture, sporting goods and equipment, automobiles, motorcycles and spare parts, motor vehicle charging, batteries, new energy vehicles Power exchange facilities. (Market entities independently select business projects and carry out business activities in accordance with the law; power generation, transmission, power supply business and projects that require approval in accordance with the law shall carry out business activities in accordance with the approved content after approval by the relevant departments; they shall not engage in activities prohibited by the national and this city’s industrial policies and Business activities of restricted projects.)",
                    "branches": [
                        {
                            "creditCode": "",
                            "belongOrg": "Xiangfen County Market Supervision and Administration Bureau",
                            "name": "China Petroleum & Chemical Corporation Shanxi Xiangfen Zhaokang Gas Station",
                            "operName": ""
                        },
                        {
                            "creditCode": "",
                            "belongOrg": "Youxian Food and Drug Administration for Industry and Commerce Quality Supervision",
                            "name": "China Petroleum & Chemical Corporation, Jiashan Gas Station, You County, Hunan Province",
                            "operName": ""
                        },
                        {
                            "creditCode": "",
                            "belongOrg": "Zhumadian City Shangcai County Market Supervision and Administration Bureau",
                            "name": "China Petroleum & Chemical Corporation Henan Zhumadian Shangcai Yangji Gas Station",
                            "operName": ""
                        },
                        
                        {
                            "creditCode": "",
                            "belongOrg": "Dingyuan County Market Supervision and Administration Bureau",
                            "name": "Sinopec Dingyuan Luqiao Oil Depot",
                            "operName": ""
                        },
                        {
                            "creditCode": "",
                            "belongOrg": "Xuyi County Administrative Approval Bureau",
                            "name": "China Petroleum & Chemical Corporation, Jiangsu Huaian Xuyi Mingzuling Gas Station",
                            "operName": ""
                        },
                        {
                            "creditCode": "",
                            "belongOrg": "Longyan City Administration for Industry and Commerce of Fujian Province",
                            "name": "China Petroleum & Chemical Corporation Fujian Longyan Baisha Gas Station",
                            "operName": ""
                        },
                        {
                            "creditCode": "",
                            "belongOrg": "Loudi Administration for Industry and Commerce",
                            "name": "Sinopec Hunan Loudi Tea Garden Gas Station",
                            "operName": ""
                        }
                    ],
                    "establishDate": "2000-02-25",
                    "approvedDate": "2023-09-18",
                    "fromDate": "2000-02-25",
                    "tagList": [],
                    "isListed": "Listed",
                    "ogName": "中国石油化工股份有限公司",
                    "contactInfoARList": [
                        {
                            "emailAddress": "master@sinopec.com",
                            "address": "No. 22, Chaoyangmen North Street, Chaoyang District, Beijing City",
                            "contactNo": "010-59960114"
                        },
                        {
                            "emailAddress": "master@sinopec.com",
                            "address": "No. 22, Chaoyangmen North Street, Chaoyang District, Beijing City",
                            "contactNo": "010-59960114"
                        },
                        {
                            "emailAddress": "master@sinopec.com",
                            "address": "No. 22, Chaoyangmen North Street, Beijing City",
                            "contactNo": "010-59960114"
                        },
                        {
                            "emailAddress": "master@sinopec.com",
                            "address": "No. 22, Chaoyangmen North Street, Beijing City",
                            "contactNo": "010-59960114"
                        }
                    ]
                }
            ]
        },
        "majorPersonsData": {
            "total": 19,
            "data": [
                {
                    "staffName": "Bi Mingjian",
                    "positions": "Independent Director"
                },
                {
                    "staffName": "Ma Yongsheng",
                    "positions": "Chairman"
                },
                {
                    "staffName": "Lv Lianggong",
                    "positions": "Director"
                },
                {
                    "staffName": "Yu Baocai",
                    "positions": "Director,Manager"
                },
                {
                    "staffName": "Wu Jianing",
                    "positions": "Independent Director"
                },
                {
                    "staffName": "Shi Dan",
                    "positions": "Independent Director"
                },
                {
                    "staffName": "Shou Donghua",
                    "positions": "Financial manager"
                },
                {
                    "staffName": "Zhao Dong",
                    "positions": "Director"
                },
                {
                    "staffName": "Ling Yiqun",
                    "positions": "Director"
                },
                {
                    "staffName": "Cai Hongbin",
                    "positions": "Independent Director"
                }
            ]
        },
        "shareholdersData": {
            "total": 2,
            "data": [
                {
                    "shareholderSource": "Public Displayed Shareholder",
                    "amount": "80,587,000,000 Shares",
                    "shoudDate": "",
                    "StockName": "China Petrochemical Corporation",
                    "UltBenefitPer": "",
                    "CountryRegion": "China",
                    "StockTag": [],
                    "StockPercent": "67.23%",
                    "realCapiType": "",
                    "shareType": "Number of Shares",
                    "ShouldCapi": "",
                    "creditCode": "9111000010169286X1",
                    "CapiDate": "",
                    "StockType": "Corporate Shareholder",
                    "RealCapi": "",
                    "shouldCapiType": ""
                },
                {
                    "shareholderSource": "Public Displayed Shareholder",
                    "amount": "24,600,000,000 Shares",
                    "shoudDate": "",
                    "StockName": "HKSCC NOMINEES LIMITED",
                    "UltBenefitPer": "",
                    "CountryRegion": "",
                    "StockTag": [],
                    "StockPercent": "20.52%",
                    "realCapiType": "",
                    "shareType": "Number of Shares",
                    "ShouldCapi": "",
                    "creditCode": "",
                    "CapiDate": "",
                    "StockType": "Corporate Shareholder",
                    "RealCapi": "",
                    "shouldCapiType": ""
                }
            ]
        }
    }
}
﻿
Error Code Response & Mapping
400(Bad Request)
409(Upstream Down)
404(Data not found)
{
  "error": {
     "name": "error",
     "message": "Data not found",
     "status": 400,
     "reason": "ERRO",
     "type": "Not Found",
     "statusCode": 400
  }
}
{
  "error": {
     "name": "error",
     "message": "Data not found",
     "status": 400,
     "reason": "ERRO",
     "type": "Not Found",
     "statusCode": 400
  }
}
﻿
Field
Type
Description
name
string
Text displayed on the screen explaining error type.
reason
string
Reason for the error.
status
message
type
statusCode
number
string
string
number
HTTP status code.
Error message indicating an upstream error.
Error type.
Status code representing the error scenario.
﻿
Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!
﻿
Country	Country Code	Supported Company Numbers	Coverage
Singapore	SG	Unique Entity Number	95 %
China	CN	Unified Social Credit Code	100 %
Hong Kong	HK	Company Registration Number	100 %
Taiwan	TW	Unified Business number	100 %
Japan	JP	National Tax Agency Company Number	95 %
India	IN	Corporate Identification Number	95 %
New Zealand	NZ	Newzealand Business Number	95 %
Vietnam	VN	Enterprise Code Number	95 %
Thailand	TH	Corporate Registration Number	95 %
Australia	AU	Australian Business Number	95 %
Request Parameter	Data Type	Manadory/Optional	Description
companyName	String	Optional	It is Legal name of company. Can be inputed in Local language as well as in English
companyNumber	String	Mandatory (Optional in some cases)	Company's registration number, can be varied from country to country
agency	String	Mandatory (Applicable for Taiwan only)	This field is mandatory for Taiwan only (Can be left blank)
codeField	String	Mandatory (Applicable for Australia only)	Mandatory for australia only(Can not be left blank)
countryCode	String	Mandatory	User needs to input Alpha - 2 Country code in the request body
language	String	Mandatory	Language can be EN (English) or OG (Native Language per country Response language will depend on language field of input
template	String	Mandatory	For LITE request, template will be KYBLite For Standard requests, template will be KYBStandard
fetchUBO	Boolean	Mandatory	If true then will recieve UBO details on mentioned notifyURL
uboDetails	Object	Optional
threshold	Number	Optional	This field represents minimum % of shares one must own to be classified as UBO Cane be 10, 15 or 25
layers	String	Optional	This will represnt how many layers of UBO details one wants to retrive
realtimeFlag	Boolean	Optional	If true then API will retrive realtime data from authorized data source, Else data will be served from cache of the authorized source
cacheperiod	Number	Optional	The user is required to specify the number of days for which the cache will be searched to retrieve data. The minimum value will be 30 and maximum is 365 days
notifyURL	String	Mandatory (If Fetch UBO is True)	The callback url on which the UBO details will be sent
Country	Mandatory Parameters
Singapore	Company Number
China	Either Company name or Company Number
Taiwan	Either Company name or Company Number + Agency Code
Hongkong	Either Company name or Company Number
Japan	Either Company name or Company Number
India	Company Number (Mandatory for MSME, Optional for MCA)
New Zealand	Company Name & Company Number
Australia	Company Number & Code Field
Thailand	Either Company name or Company Number
Vietnam	Either Company name or Company Number
Response Parameter	Description
crnNumber	This field Provides company number. The name of this field can change according to country e.g. usccNumber for China, abnNumber for Australia
companyName	This field provides company name in English
ogName	This field provides company name in Native Language
businessStatus	This field provides current status of business
establishDate	This field returns date of establishment of a particular business
companyAddress	This field returns registered address for a particular business
Field	Type	Description
name	string	Text displayed on the screen explaining error type.
reason	string	Reason for the error.
status message type statusCode	number string string number	HTTP status code. Error message indicating an upstream error. Error type. Status code representing the error scenario.
Did this page help you?
Business Verification US - Document Fetch
Global Business Lite - Index Search