Skip to main content

Overview​

Retrieve detailed card information, including the card product name, card type, masked card number, cardholder information, card transaction restrictions, balance, and other related details. Use the card_id returned by the Add Card to query the corresponding card details.

cURL -X GET /cards/{card_id}/detail
-H 'Content-Type: application/json'
-H 'Authorization: {token}'

Card Product Name​

Card Product Name, which represents the card product, card range, or card issuance program to which the card belongs. It is used to distinguish different card types or card issuance plans.

"data": {
  "product_name": "***26452HKMastercard"
}

Account ID​

Returns the Account ID associated with the current card.

"data": {
  "account_id": "1016X10037037910494"
}

Cardholder​

Returns the card_holder_id of the cardholder associated with the current card.

"data": {
  "card_holder_id": "2069738512683974656",
}

Card Reference Number​

Returns the card_no, which represents the Virtual Card Number in the current account system.

"data": {
  "card_no": 2716020776676196990,
}

Card Number Details​

Retrieve the card_number and card_validity_time.

"data": {
  "card_id": 1954802358738284544,
  "card_number": "527375 **** 4392",
  "card_validity_time": "2027-08-01T00:00:00+08:00"
}

Account Card Type​

Retrieve the current account card type (program_value).

"data": {
  "program_value": 15,
  "program_cn_name": "OTA",
  "program_en_name": "USD OTA"
}

Card Status​

Retrieve the current card status.

"data": {
   "card_status": "Activate",
}

Card Transaction Limits​

Retrieve all transaction limits currently set on the card risk_list.

"data": {
  "risk_list": [
    {
      "trade_risk_name": "purchase_1d",
      "trade_risk_value": "100"
    },
    {
      "trade_risk_name": "blocked_countries",
      "trade_risk_value": "US"
    }
  ],
}

Card Limits​

Retrieve the current card limit information:

  • max_value: Total card limit.
  • current_value: Used amount.
  • available_value: Available Amount.
"data": {
  "max_value": "",
  "current_value": "",
  "available_value": "",
}

Response Example​

{
    "code": "200",
    "msg": "SUCCESS",
    "trace_id": "daf5560f9f5f4da7b80eaa5b9059158a",
    "data": {
        "card_id": 2070330939392872448,
        "card_number": "222333 **** 1955",
        "card_name": "TEST",
        "card_status": "Activate",
        "create_time": "2026-06-26T10:18:56+08:00",
        "card_remark": null,
        "card_validity_time": "2026-07-01T00:00:00+08:00",
        "card_desc": "",
        "risk_list": [
        	{
		      "trade_risk_name": "purchase_1d",
		      "trade_risk_value": "100"
    		},
    		{
		      "trade_risk_name": "blocked_countries",
		      "trade_risk_value": "US"
    		}
        ],
        "program_value": 2,
        "program_cn_name": "OTA",
        "program_en_name": "OTA_USD",
        "card_holder_id": 2069738512683974656,
        "create_status": 1,
        "create_resp_msg": null,
        "account_id": "1016X10037037910494",
        "card_no": "9122031273929585023",
        "max_value": null,
        "current_value": null,
        "available_value": null,
        "pause_reason": null,
        "product_name": "1"
    }
}