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" } }' 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" } } 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" } } 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" "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) { "error" { "name" "error", "message" "bad input and description ", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" 400 } } 409(upstream down) { "error" { "name" "error", "message" "upstream down", "status" 409, "reason" "error", "type" "bad request", "statuscode" 409 } } 404(data not found) { "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 help\@signzy com 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!