详情版

API 方式#

Base URL

新加坡节点：https://sg.apitd.net/verification/persona/aml/detail/v1
美国节点：https://us.apitd.net/verification/persona/aml/detail/v1
德国节点：https://de.apitd.net/verification/persona/aml/detail/v1

API

URL	请求方式	Content-Type	输出格式	字符集
api-base-url? partner_code=xxx&partner_key=xxx	POST	application/json	JSON	UTF-8

示例：https://sg.apitd.net/verification/persona/aml/detail/v1?partner_code=test_code&partner_key=test_key

认证参数

字段	类型	含义	建议	备注
partner_code	String	合作方标识	必须	由 TD 分配
partner_key	String	合作方密钥	必须	由 TD 分配

请求参数#

字段名称	类型	含义	必填	备注
name	String	实体名称	是	最小值：2个字符最大值：100个字符约束：名称不能全为特殊字符或数字。
entity_type	Array	实体类型	是	需要筛查的实体类型枚举值： person：个人 company：公司 organization：组织 crypto_wallet：加密钱包 vessel：船舶 aircraft：航空器
category_list	Array	筛查名单类别	是	按筛查名单的类别过滤结果枚举值： professional_integrity regulatory_enforcement sanctions pep sip sie insolvency 筛查名类别释义见附录-筛查名单类别
country_list	Array	国家	否	按国家过滤结果；国家代码见附录；示例：[“CA”、“IN”]
birth_incorporation_date	String	出生/成立日期	否	个人的出生日期或企业/组织的成立日期；按日期过滤结果；格式：DD-MM-YYYY 示例: 10-03-1947 \| 10-03-0000 \| 00-03-1947 \| 00-00-1947
unique_identifier	String	唯一标识	否	包括护照号码、国民身份证号码、驾驶证、企业/组织注册号等最小值：2个字符最多：50个字符约束：唯一标识不能全为特殊字符；示例：EA1234567
match_score	Integer	匹配分数	否	搜索词与命中词的相似度匹配门槛；输入值应为整数。默认值：80 0：最宽松匹配 100：最严格匹配取值范围：0–100 数值越高，匹配条件越严格；如需精确匹配，可设置分数为100。
alias_search	Boolean	别名搜索	否	是否同时匹配实体的主名称及已知别名注意：默认值为true。
rca_search	Boolean	RCA搜索	否	是否检索政治公众人物的亲属及密切关联人 RCA (Relatives and Close Associates)：指政治公众人物的亲属及密切关联人，包括配偶、父母、子女、兄弟姐妹等。注意：默认值为true。

请求示例#

JSON

{
  "name": "David Beckham",
  "category_list": [
    "sanctions",
    "pep",
    "sip"
  ],
  "entity_type": ["person"],
  "country_list": [],
  "birth_incorporation_date": "",
  "unique_identifier": "",
  "match_score": 100,
  "alias_search": true,
  "rca_search": true

响应参数#

字段	类型	含义	备注
code	Integer	API 状态码
message	String	状态信息	在 API 异常状态下会输出具体的异常原因
sequence_id	String	响应唯一码	用于跟踪每次请求记录的唯一标识
data	Object	响应数据主体	参考data 输出参数

data

字段	类型	含义	备注
case_status	String	案例状态	表示AML搜索案例的总体结果；案例结果一般为：Passed、Failed、For Review；由相关AML案例的结果决定
language_code	String	语言
match_status	String	匹配状态	匹配的状态； “Potential Match”表示搜索的案例是匹配的
results	Array	搜索结果	结果对象的数组；每个对象都包含有关案例的详细信息；详见 data.results 响应参数
searched_name	String	搜索的名称
total_records	Integer	总记录数

data.results

字段	类型	含义	备注
birth_incorporation_date	Array	出生/成立日期
category_list	Array	筛查名单类别
country_list	Array	国家
created_at	String	记录创建时间
data	Object	详细数据	详见 data.results.data 响应参数
entity_type	Array	实体类型
hio	Boolean	国际组织负责人	Head of International Organisation
id	String	记录唯一标识
match_status	String	匹配状态
matched_alias	String	匹配的别名	匹配的别名
matched_names	Array	匹配名称	详见 matched_names 响应参数
matched_rca	String	匹配的关联人	匹配实体的关联人信息
name	String	实体名称	实体的名称
risk_decision	String	风险决策	针对该实体的风险决策
risk_level	String	风险等级	实体的风险水平
risk_score	Integer	风险评分	实体的风险分数
source_details	Array

data.results.data

字段	类型	含义	备注
additional_information	Object	附加信息	详见 additional_information 响应参数
case_details	Array	案件细节	详见 case_details 响应参数
crypto_wallets	Array	加密钱包地址	详见 crypto_wallets 响应参数
identification_documents	Array	身份证件信息	详见 identification_documents 响应参数
linked_entities	Array	关联实体	详见 linked_entities 响应参数
role	Array	职务信息	详见 role响应参数
sanction_details	Array	制裁详情	详见 sanction_details 响应参数
election_details	Array	选举信息	详见 election_details 响应参数
employment_records	Array	就业记录	详见 employment_records 响应参数
vehicles	Array	车辆信息	详见 vehicles 响应参数
aliaes	Array	别名信息	详见 aliaes 响应参数
summary	Object	摘要信息	详见 summary 响应参数

additional_information

字段	类型	含义
flag_summary	Array	风险标记摘要
notes_remarks	Array	备注说明
twitter_handle	Array	Twitter 账号

case_details

字段	类型	含义	备注
authority	Array	监管机构
case_number	Array	官方案件编号
case_status	Array	案件当前状态
crime	Array	犯罪行为
decision	Array	案件结果
description	Array	案件描述
reference_link	Array	案件参考链接
status	Array	案件状态
type	Array	案件类型
watchlist_type	Array	观察名单类型	比如通缉犯、罪犯等

crypto_wallets

字段	类型	含义
amount_usd	Array	等值美元额
balance	Array	钱包余额
crypto_wallet_address	Array	加密货币钱包地址
currency	Array	加密货币类型

identification_documents

字段	类型	含义
document_type	Array	证件类型
issuing_country	Array	签发国家
license_number	Array	许可证件编号
national_id	Array	国民证件号
passport_number	Array	护照号

linked_entities

字段	类型	含义	备注
active	Array	关联主体制裁状态是否生效	标识制裁状态是否为生效中
details	Array	关联主体的详细信息
name	Array	关联人/实体名称
relation	Array	与主筛查实体的关系
status	Array	关联主体的状态	标识关联主体是否受到制裁

role

字段	类型	含义
designation	Array	职务头衔
institution_address	Array	机构地址
institution_name	Array	机构名称
tenure	Array	任期

sanction_details

字段	类型	含义
delisted_on	Array	移出清单日期
legal_basis	Array	制裁法律依据
listed_on	Array	最初列入日期
listing_id	Array	制裁名单唯一标识
reason	Array	制裁原因
sanction_program	Array	制裁计划名称
sanction_source	Array	制裁记录数据来源
sanction_type	Array	制裁类型
sanctioning_authority	Array	发布制裁的机构
status	Array	制裁当前状态

election_details

字段	类型	含义
election	Array	选举名称
party	Array	所属党派
position_held	Array	担任职位

employment_records

字段	类型	含义
firm_name	Array	公司或组织名称
firm_address	Array	公司或组织地址
role	Array	在组织内的职务/角色
capital_share	Array	所有权或资本股份占比

vehicles

字段	类型	含义
year	Array	车辆制造年份
color	Array	车辆颜色
model	Array	车辆型号
tag	Array	车辆登记号码

aliaes

字段	类型	含义
name	Array	别名或化名
type	Array	别名类别
quality	Array	可信度
detail	Array	额外的别名细节

summary

字段	类型	含义
address	Array	已知地址信息
alias	Array	曾用名、别名
appointment_date	Array	任职就任日期
category_list	Array	主体风险类别
citizenship	Array	公民身份
country_list	Array	国家/地区
date_of_birth	Array	出生日期
date_of_death	Array	死亡日期
death_date	Array	个人逝世日期
description	Array	主体综合描述
designation	Array	官方职务 / 职位名称
education	Array	教育背景详情
email	Array	联系邮箱
entity_type	Array	主体类型
ethnicity	Array	种族
first_name	Array	名
gender	Array	个人性别
image_url	Array	档案或主体头像链接

matched_names

字段	类型	含义	备注
matched_name	String	匹配到的名称
matching_fields	Object	匹配字段详情	详见 matching_fields 响应参数
record_id	String	记录 ID
score	String	匹配分数
source_ids	Array	数据源 ID

matching_fields

字段	类型	含义
alias	Boolean	别名是否匹配
birth_incorporation_date	Boolean	出生日期是否匹配
profile_name	Boolean	档案名称是否匹配
exact_match	Boolean	实体是否精确匹配

source_details

字段	类型	含义	备注
additional_sources	Array	附加数据源
category_list	Array	筛查名单类别
country_list	Array	国家
created_at	String	创建时间
data	Object	数据源关联的详细信息	详见 source_details.data 响应参数
description	String	数据源描述
entity_id	String	实体 ID
publisher	String	数据发布者
source_categories	Array	类别的数据来源
updated_at	String	更新时间
url	String	数据来源参考链接

source_details.data
source_details.data 下的字段结构可复用前文同名输出参数说明，由于 source_details.data 表示单个数据来源下的明细信息，实际返回字段可能会随数据来源不同而存在差异。

字段	类型	含义	备注
additional_information	Object	数据源附加信息	参考前文
crypto_wallets	Array	加密钱包	参考前文
identification_documents	Array	身份文件	参考前文
linked_entities	Array	关联实体	参考前文
sanction_details	Array	制裁详情	参考前文
summary	Object	数据源摘要	参考前文

API状态码

状态码	含义
200	成功
301	未购买此服务
302	流量已被禁用
303	流量不足
304	服务已过期
305	日流量已封顶
600	限流
9600	系统错误
9606	参数非法

响应示例#

JSON

{
    "code": 200,
    "data": {
        "language_code": "en",
        "searched_name": "David Beckham",
        "case_status": "Failed",
        "total_records": 13,
        "match_status": "Potential Match",
        "results": [
            {
                "data": {
                    "summary": {
                        "website": [
                            "https://www.davidbeckham.com/"

附录#

筛查名单类别

类别	说明	备注
professional_integrity	职业诚信	评估金融从业人员的能力、技能、诚信和职业道德
regulatory_enforcement	监管执法	监管机构对违规者发出的警告及处罚措施
sanctions	制裁名单	政府或国际组织对个人/实体/国家实施的惩罚性限制
pep	政治公众人物	politically exposed person 各级政府官员等政界相关人员
sip	特别关注个人	special interest person 因涉嫌或确已参与犯罪活动而具有较高风险的自然人
sie	特别关注实体	special interest entity 因涉嫌或确已参与犯罪活动而具有较高风险的公司或组织
insolvency	破产清算	无力偿还债务或已被法院宣告破产的公司/组织

国家代码

国家名字	国家编码
阿富汗	AF
阿尔巴尼亚	AL
阿尔及利亚	DZ
奥兰群岛	AX
美属萨摩亚	AS
安道尔	AD
安哥拉	AO
安圭拉	AI
安提瓜和巴布达	AG
阿根廷	AR
亚美尼亚	AM
阿鲁巴	AW
澳大利亚	AU
奥地利	AT
阿塞拜疆	AZ
巴林	BH
孟加拉国	BD
巴巴多斯	BB
白俄罗斯	BY
比利时	BE
伯利兹	BZ
贝宁	BJ
百慕大	BM
不丹	BT
玻利维亚	BO
波斯尼亚和黑塞哥维那	BA
博茨瓦纳	BW
巴西	BR
英属维尔京群岛	VG
文莱	BN
保加利亚	BG
布基纳法索	BF
布隆迪	BI
柬埔寨	KH

支持语言

语言
阿拉伯语
保加利亚语
加泰罗尼亚语
简体中文
繁体中文
克罗地亚语
捷克语
丹麦语
荷兰语
英语
爱沙尼亚语
芬兰语
法语
弗里西语
德语
希腊语
希伯来语
匈牙利语
冰岛语
意大利语
日语
韩语
拉丁语
拉脱维亚语
立陶宛语
挪威语
挪威尼诺斯克语
波兰语
葡萄牙语（巴西）
葡萄牙语（葡萄牙）
罗马尼亚语
俄语
塞尔维亚语
斯洛伐克语
斯洛文尼亚语
西班牙语
瑞典语
土耳其语