Skip to main content
GET
/
open-api
/
v1
/
cardholder
/
{cardholder_no}
/
info
curl --request GET \
  --url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/U202605220001/info \
  --header 'Content-Type: application/json' \
  --header 'Api-Key: your_api_key' \
  --header 'Timestamp: 1716307200000' \
  --header 'Access-Token: your_access_token'

{
  "code": 0,
  "msg": "Success",
  "data": {
    "cardholder_no": "",
    "cardholder_unique_no": "",
    "email": "",
    "status": "Approved",
    "total_balance": "1000.00",
    "time": 1716307200000,
    "card_list": [{"card_no": "", "card_last_no": "", "card_type": "Virtual", "time": 1716307200000}],
    "account_list": [{"balance": "500.00", "usd_balance": "500.00"}]
  }
}
Retrieves cardholder details, including accounts and the list of successfully issued cards.

​
Request Headers

​
Api-Key
string
required
apiKey (merchant credential, bound to IP whitelist)
​
Timestamp
string
required
Unix timestamp in milliseconds. The deviation from the server time must be within 60 seconds, and future timestamps are not accepted.
​
Access-Token
string
required
Login token (required for all interfaces except Get Token).
​
Content-Type
string
default:"application/json"
Fixed to application/json

​
Path Parameters

​
cardholder_no
string
required
Cardholder order number.

​
Response Parameters

​
code
number
Response status code. 0 indicates success.
​
msg
string
Response message.
​
data
object
Response data.
curl --request GET \
  --url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/U202605220001/info \
  --header 'Content-Type: application/json' \
  --header 'Api-Key: your_api_key' \
  --header 'Timestamp: 1716307200000' \
  --header 'Access-Token: your_access_token'

{
  "code": 0,
  "msg": "Success",
  "data": {
    "cardholder_no": "",
    "cardholder_unique_no": "",
    "email": "",
    "status": "Approved",
    "total_balance": "1000.00",
    "time": 1716307200000,
    "card_list": [{"card_no": "", "card_last_no": "", "card_type": "Virtual", "time": 1716307200000}],
    "account_list": [{"balance": "500.00", "usd_balance": "500.00"}]
  }
}