持卡人列表
POST
/{{version}}/openApi/holder/holderList
使用场景
获取持卡人列表。
请求参数
| 字段 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| customer_id | long | 是 | 客户id |
| app_id | long | 是 | 应用id |
| key | string | 是 | 授权key |
| status | int | 否 | 状态 0:待提交; 1:待审批 2:审批通过; 3:审批拒绝 |
| page_no | int | 是 | 页码 |
| page_size | int | 是 | 每页记录数 |
{
"customer_id": 10000011,
"app_id": 100001,
"key": "ae9ae3f5ad284ef4836de18aa3d41c47",
"page_no":1,
"page_size": 10
}
响应内容
| 字段 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| total | int | 是 | 总数 |
| page_no | int | 是 | 当前页码 |
| page_size | int | 是 | 当前每页记录数 |
| holder_list | array[object] | 是 | 持卡人数组 |
| holder_list.holder_id | string | 是 | 持卡人 id |
| holder_list.customer_id | long | 是 | 客户 id |
| holder_list.first_name | string | 是 | 中文 名 |
| holder_list.last_name | string | 是 | 中文 姓 |
| holder_list.first_name_en | string | 是 | 英文 名 |
| holder_list.last_name_en | string | 是 | 英文 姓 |
| holder_list.gender | int | 是 | 性别 1:男 2:女 |
| holder_list.birthday | date | 是 | 出生日期 |
| holder_list.marital_status | int | 是 | 婚姻状态 1:已婚; 2:未婚 |
| holder_list.nationality | string | 是 | 国籍, 如 USA |
| holder_list.contact_area | string | 是 | 联系号码区号 |
| holder_list.contact_no | string | 是 | 联系号码 |
| holder_list.email | string | 是 | 邮箱 |
| holder_list.address | string | 是 | 地址 |
| holder_list.province | string | 是 | 州/省 |
| holder_list.city | string | 是 | 城市 |
| holder_list.country | string | 是 | 国家 |
| holder_list.post_code | string | 是 | 邮编 |
| holder_list.id_card_type | int | 是 | 证件类型 1:中华人民共和国身份证 1:中华人民共和国身份证 2:香港永久性居民身份证 3:香港护照 4:香港内地旅行证 5:香港居留许可 6:其他 7:外国身份证 8:护照 |
| holder_list.id_card_no | string | 是 | 证件号 |
| holder_list.status | int | 是 | 状态 0:待提交; 1:待审批 2:审批通过; 3:审批拒绝 |
| holder_list.reject_reason | string | 是 | 拒绝原因 |
| holder_list.create_at | datetime | 是 | 创建时间 |
{
"code": 0,
"message": "success",
"data": {
"total": 1,
"page_no": 1,
"page_size": 10,
"holder_list": [
{
"holder_id": "hid_xfewewefwefwf",
"customer_id": 10000011,
"first_name": "first_name",
"last_name": "last_name",
"first_name_en": "first_name_en",
"last_name_en": "last_name_en",
"gender": 1,
"birthday": "1990-10-28",
"marital_status": 1,
"nationality": "CN",
"contact_area": "+86",
"contact_no": "13722338876",
"email": "xxx@xxx.com",
"address": "address......",
"province": "广东省",
"city": "深圳市",
"country": "CN",
"post_code": "518000",
"id_card_type": 1,
"id_card_no": "440304199010282934",
"status": 2,
"reject_reason": "",
"create_at": "2023-10-24 06:16:39"
}
]
}
}
请求参数
Body 参数application/json
请求示例代码
返回响应
修改于 2026-03-19 06:16:48