get
https://sandboxapi.legendtrading.com/v2/app/kyc/individual/tin
查询个人用户的税号(TIN)收集状态
接口详情
查询个人用户的税号(TIN)收集状态:已收集的税号、收集状态、提交时间,以及该账户当前是否必须提供税号。
适用范围
税号收集适用于账户区域为 EU 的个人用户,不适用于 Non-EU 账户或企业(KYB)账户。账户区域以账户本身为准,而不是请求中传入的国家——账户无法通过传入其他国家的代码来规避或触发该要求。
返回字段
| 字段 | 说明 |
|---|---|
tin | 已收集的税号,始终以 ****** 返回;尚未收集时为字符串 ''。任何查询类接口都不会返回明文税号 |
tin_status | 收集状态:not_provided(尚未收集)、submitted(已收集)。收集仅代表已记录该值,不代表税号已通过核验 |
tin_submitted_at | 税号收集的 UTC 时间;尚未收集时为 null |
tin_required | 该账户是否必须提供税号:EU 个人账户且尚未收集时为 true,其余情况为 false |
税号对调用方而言是只写的。所有查询与保存响应中,已收集的值一律返回
******——不存在返回明文税号的接口,也不提供部分位数回显。
相关接口
- POST /kyc/individual/tin — 为已有账户保存税号
- POST /kyc/individual/pi — 保存基本信息时也可同时传入
tin - GET /kyc/individual/fields — 该账户仍需税号时,会在必填项中返回
tin