1. VM Card operation V2 (available to all accounts, recommended)
VM_API
English
  • 简体中文
  • English
  • Integration Guide
  • Environment Configuration
  • Global Error Codes
  • Transaction Type Description
  • Card Status Description
  • VM Card operation V1 (only for accounts with a merchant public key configured before 2026-10-30)
    • Webhook Signature Verification
    • Get Account Balance
      POST
    • Get Card Product Code
      POST
    • Apply for Card
      POST
    • Card Details
      POST
    • Modify Card Limit(For credit line cards only)
      POST
    • Freeze/Unfreeze Card
      POST
    • Card Top-up(For prepaid cards only)
      POST
    • Card Refund(For prepaid cards only)
      POST
    • Transaction Records
      POST
    • Delete Card
      POST
    • Card List
      POST
    • Card Flow
      POST
  • VM Card operation V2 (available to all accounts, recommended)
    • Get Account Balance
      POST
    • Get Card Product Code
      POST
    • Apply for Card
      POST
    • Card Details
      POST
    • Modify Card Limit(For credit line cards only)
      POST
    • Freeze/Unfreeze Card
      POST
    • Card Top-up(For prepaid cards only)
      POST
    • Card Refund(For prepaid cards only)
      POST
    • Transaction Records
      POST
    • Delete Card
      POST
    • Card List
      POST
    • Card Flow
      POST
  • Notification
    • WebHook
    • Card 3DS Notification
  • Change Log
    • Change Log
  • FAQ
    • FAQ
  • Get accessToken
    GET
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
  1. VM Card operation V2 (available to all accounts, recommended)

Card List

POST
/v2/getCardList
最后修改时间:2026-11-04 08:36:45
v2 requires no encryption: submit the plaintext JSON shown on this page directly, and the returned data is the plaintext object shown on this page.
Retrieve the list of cards under an account, supporting conditional filtering and querying.

请求参数

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200成功
application/json
Bodyapplication/json

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://sandbox-api.vmcardio.com/v2/getCardList' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data '{
    "product_code": "P537***",
    "card_type": "save",
    "card_id": "abcd123456789",
    "vm_card_id": "v4Qg*************HHSfg",
    "start_time": "2026-05-01 00:00:00",
    "end_time": "2026-06-01 00:00:00",
    "page": 1,
    "page_size": 10
}'
响应示例响应示例
{
    "code": 0,
    "msg": "ok",
    "data": {
        "total": 1,
        "list": [
            {
                "card_id": "abce123456789",
                "card_number": "2234670329******",
                "product_code": "P537***",
                "card_type": "save",
                "available_amount": 100.01,
                "status": "ACTIVE",
                "create_time": "2026-05-01 15:51:11"
            }
        ]
    }
}
修改于 2026-11-04 08:36:45
上一页
Delete Card
下一页
Card Flow
Built with