/app/kyc/entity/general


该接口用于企业级客户的KYB(Know Your Business,了解你的企业)基本信息收集。通过提交企业的注册信息、联系方式、地址等多维度数据,完成企业身份信息的初步采集与验证。

请求参数字段说明

数据来源字典 表示读取字典接口数据,参数名 field 为当前字段名,字段存储之为字典的code。

字段名类型必填说明数据来源
uidstring是用户ID
account_emailstring是账户电子邮箱
entity_typestring是公司类型字典
entity_legal_namestring是企业法定全称
entity_legal_identifierstring是企业法定注册号/识别码
trade_namestring否企业商号/经营用名称
tax_identification_numberstring否税号,仅注册国家(country_of_formation)是US的需要,其他即使传递了,也不会保存。
country_of_formationstring是企业注册国家/地区,ISO2 country code,两位字符串,例如:US国家接口
date_of_formationstring是企业成立日期,格式:YYYY-MM-DD
phone_country_codestring是电话国家代码(带+号),可以读取国家接口的phone_calling_code字段国家接口
phone_country_code_shortstring是电话国家代码(短格式,如US),可以读取国家接口的country_iso2_code字段国家接口
phone_numberstring是联系电话号码
company_websitestring否企业官网地址
num_of_employeesstring否员工规模区间字典
telegramstring是Telegram联系方式
registered_countrystring是注册地址国家,ISO2 country code,两位字符串,例如:US国家接口
registered_citystring是注册地址城市
registered_statestring是注册地址州/省,纽约(NY)和加利福尼亚(CA)暂不支持注册州接口
registered_zipcodestring是注册地址邮政编码
registered_address1string是注册地址第一行,最少5个字符
registered_address2string否注册地址第二行
business_countrystring是实际经营地址国家,ISO2 country code,两位字符串,例如:US国家接口
business_citystring是实际经营地址城市
business_statestring是实际经营地址州/省州接口
business_zipcodestring是实际经营地址邮政编码
business_address1string是实际经营地址第一行,最少5个字符
business_address2string否实际经营地址第二行

请求示例

{
  "uid": "123456",
  "account_email": "[email protected]",
  "entity_type": "holding_company",
  "entity_legal_name": "Acme Corporation Ltd",
  "entity_legal_identifier": "ACM123456789",
  "trade_name": "Acme Corp",
  "tax_identification_number": "12-3456789",
  "country_of_formation": "FI",
  "date_of_formation": "2020-01-15",
  "phone_country_code": "+1",
  "phone_country_code_short": "US",
  "phone_number": "4155550123",
  "company_website": "https://www.acmecorp.com",
  "num_of_employees": "51_100_employees",
  "telegram": "@acmecorp123",
  "registered_country": "US",
  "registered_city": "test city name",
  "registered_state": "American Samoa",
  "registered_zipcode": "94102",
  "registered_address1": "123 Main Street, Suite 100, Downtown",
  "registered_address2": "Building A, Floor 5",
  "business_country": "AT",
  "business_city": "test city name",
  "business_state": "Bundesland Tirol",
  "business_zipcode": "94103",
  "business_address1": "456 Market Street, Office Tower",
  "business_address2": "Suite 200"
}
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json