/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,两位字符串,例如:国家接口
date_of_formationstringUS企业成立日期,格式:YYYY-MM-DD
phone_country_codestring电话国家代码(带+号),可以读取国家接口的phone_calling_code字段国家接口
phone_country_code_shortstring电话国家代码(短格式,如US),可以读取国家接口的country_iso2_code字段国家接口
phone_numberstring联系电话号码
company_websitestring企业官网地址
num_of_employeesstring员工规模区间字典
telegramstringTelegram联系方式
registered_countrystring注册地址国家,ISO2 country code,两位字符串,例如:国家接口
registered_citystring注册地址城市
registered_statestring注册地址州/省,纽约禁止注册州接口
registered_zipcodestring注册地址邮政编码
registered_address1string注册地址第一行,最少5个字符
registered_address2string注册地址第二行
business_countrystring实际经营地址国家,ISO2 country code,两位字符串,例如:国家接口
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