/kyc/individual/fields

返回用户提交KYC需要完成的字段

接口详情

检查字段完成进度,获取Legend Trading要求的个人用户基本信息字段及其完成状态。


参数说明

country_iso2_codeuid 参数为二选一必填项,具体使用场景如下:

参数名适用场景说明
country_iso2_code用户未开始注册根据国家/地区代码,返回该地区用户需要填写的全部字段列表
uid用户已部分完成 KYC根据用户唯一标识,返回该用户尚未完成的必填字段清单

如果两个参数都传递了,则以country_iso2_code为准,但是同时也会检查uid是否有效。

API返回值中的特殊字段说明

字段名说明操作
questionnaire需要完成调查问卷。-
veriff_id完成人脸识别验证。如果有ID文件,则调用File 接口上传证件; 否则用 IDV 接口来获得人脸识别链接
proof_of_address上传地址证明文件。调用 File 接口上传证件

使用示例

// 场景一:新用户注册
{
  "country_iso2_code": "US"
}

// 场景二:已注册用户进度查询
{
  "uid": "12345"
}

注意事项

1. 居住国变更与字段重验证

当用户的居住国家country_iso2_code信息发生变更时,其必填字段集合可能会相应调整。在此情况下,必须重新调用本接口以获取最新的字段要求,并验证用户资料是否已填写完整。

提示:为确保资料符合最新规范,请在用户更新 country_iso2_code 后,触发本接口的重新调用与验证流程。

2. 手机号码字段结构

phone 参数为一个复合对象,包含以下两个子字段:

字段名类型必填说明
phone_isd_codeString国际区号(例如:86)
phone_numberString手机号码(不包含区号)


Query Params
string
Defaults to US

Required without uid. ISO 3166-1 alpha-2 standard codes or response of countries API

string

Required without country_iso2_code

Headers
string
required
Defaults to Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjVhMDRhYmI3YWI5ZjZjMzg3NDljOTU3ZDkzNDgxZDg5YmE0NDliZmQwYTM3MjRjZGI2NmNjM2EwMDc5MDExZDM5Y2VmN2VmYmI1MzcxN2Y5In0.eyJhdWQiOiIyNCIsImp0aSI6IjVhMDRhYmI3YWI5ZjZjMzg3NDljOTU3ZDkzNDgxZDg5YmE0NDliZmQwYTM3MjRjZGI2NmNjM2EwMDc5MDExZDM5Y2VmN2VmYmI1MzcxN2Y5IiwiaWF0IjoxNzUxMDA1NzAyLCJuYmYiOjE3NTEwMDU3MDIsImV4cCI6MTc4MjU0MTcwMiwic3ViIjoiMjY0NyIsInNjb3BlcyI6WyIqIl19.OfzxnZRXaACiInxtOQ8lNsZvsKzDBfUhBumH366hJR9Wa-WbzZcU2RFhOoBL_H66pkK8UE3WUKSPCnNfVuUkakU_46eURx3BzaIlJm4k6XJHZ0uJoQZW3xUxEv6uqFGSX2dVPsUCo7Pxo94VX9N-yiNaQBbp44lmHy-h0kGe_VWq7PBxPvkDMVldbYkDg3UGXfRoJz-j4WTbodL3Hi53VdyprPnN45rxhu9tt3603L260ozc-aJAWQkHVKIe-YgR0AfKtCQUcjSvkwXyEUQ6SN90blnZLow2yPzuYXkJvmJD8EYyOb1_a8Bb4bOEnYSZQR4fzfHdeHDuiGY1k3fqThgWhtBlsikpkNMQ-gUjb1022Yj7Kv5bbkbds4RsWn1kWsE7BShdHYBlnns3KnnXOdBhXzSGqgLYML5ri1T5zNEMuMRgErU3L8_QHwoR4VmPkdrFQiaoIoH4Wp7C5J_788BnhXDJk01lxJnuiMeBPanBeRTvE3PZmjdRLTvYTzWgnDqn3SnbG1KiQdmyLnWuW_vDnuYiqu8Cc2HRbBkS1h_HuPybP7AcP1NBgatJZb7sXk6nuwKibx8SJIQTImdSIPuy5A1T3DxclbG_qwFPQpHpSDsLjSUCu01lpD3wmtinOi5OATkCPsXgSm69NQeV4-_qwMku-Ih8d8kMwHmgDfs

API Token received from Legend Trading

string
required
Defaults to 12.34.56.78

User's most recent access/login IP address

Responses

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