跳到主要内容

概述​

查询当前帐户下所有卡的列表。

查询账户卡列表​

cURL -X POST /card-api/v1/cards
-H 'Content-Type: application/json'
-H 'Authorization: {token}'
-d '{
      "card_status_list": [],
      "card_holder_id_list": [],
      "program_value_list": [],
   }'
参数名类型长度是否必填描述示例
card_status_listarray-否卡片状态
  • Blocked：暂停
  • Activate：激活
  • Deactivated：注销
  • Blocking：暂停（处理中）
  • Activating：激活（处理中）
  • Deactivating：注销（处理中）
card_holder_id_listarray-否持卡人id[1955930998425718784]
program_value_listarray-否账户持卡人列表[2,5]
card_numberstring0-20否卡号110110 **** 5678
card_nostring0-20否卡片编号12345
from_created_atstring0-20否开始时间2026-05-22T14:51:31+08:00
to_created_atstring0-20否结束时间2026-06-01T00:00:00+08:00
{
    "code": "200",
    "msg": "操作成功",
    "trace_id": "cd60b294f3f24be2b8e894a511c4b73d",
    "data": {
        "data": [
            {
                "card_id": 1087,
                "card_number": "527375 **** 2625",
                "card_no": "2716020776676196990",
                "card_name": "test",                
                "card_status": "Deactivated",
                "create_time": "2024-10-22T14:51:31+08:00",
                "card_remark": "123",
                "card_validity_time": "2025-10-01T00:00:00+08:00",
                "program_value": 6,
                "program_cn_name": "美金单币卡",
                "program_en_name": "USD Single Card-XA",
                "holder_name": ""
            },
        ],
        "next_cursor": "1096",
        "has_more": true
    }
}
字段描述
next_cursor分页游标
has_more是否有下一页
card_id卡片唯一标识符
card_number卡号
card_no卡编号
card_name卡片名称
card_status卡片状态
create_time创建时间
card_remark卡备注
card_validity_time卡有效期
program_value账户持卡人列表
program_cn_nameprogram中文名称
program_en_nameprogram英文名称
holder_name持卡人姓名