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	UBOs Available
Singapore	SG	Unique Entity Number	95 %	Yes
China	CN	Unified Social Credit Code	100 %	Yes
Hong Kong	HK	Company Registration Number	100 %	Yes
Taiwan	TW	Unified Business number	100 %	Yes
Japan	JP	National Tax Agency Company Number	95 %	No
India	IN	Corporate Identification Number	95 %	No Available in different service
New Zealand	NZ	Newzealand Business Number	95 %	Yes
Vietnam (Unavailable currently)	VN	Enterprise Code Number	95 %	Yes (Unavailable currently)
Thailand	TH	Corporate Registration Number	95 %	No
Australia	AU	Australian Business Number	95 %	Yes Not available for public companies as that is not disclosed to ASIC.

API Details

Sample cURL

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

{
    "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	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) This field format will be companynumber_companyname for eg. 1234567_ABC_Limited
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	Company Number
Taiwan	Cmpany name & Company Number + Agency Code
Hongkong	Either Company name or Company Number
Japan	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	Company name & Company Number (Unavailable currently)

Response Body (Global KYB - LITE)

{
    "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)

{
    "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": ""
                }
            ]
        }
    }
}

Error Code Response & Mapping

{
  "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!