curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/card/list \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--header 'Timezone: UTC+8' \
--data '{
"cardholder_no": "",
"card_unique_no": "",
"card_no": "",
"start_time": "2026-01-01",
"end_time": "2026-03-31",
"page": 0,
"size": 10
}'
{
"code": 0,
"msg": "Success",
"data": {
"list": [{
"card_no": "",
"card_unique_no": "",
"cardholder_no": "",
"card_type": "Virtual",
"card_last_no": "",
"organization": "",
"status": "Activated",
"time": 1716307200000
}]
}
}
Card
Get Card List
POST
/
open-api
/
v1
/
card
/
list
curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/card/list \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--header 'Timezone: UTC+8' \
--data '{
"cardholder_no": "",
"card_unique_no": "",
"card_no": "",
"start_time": "2026-01-01",
"end_time": "2026-03-31",
"page": 0,
"size": 10
}'
{
"code": 0,
"msg": "Success",
"data": {
"list": [{
"card_no": "",
"card_unique_no": "",
"cardholder_no": "",
"card_type": "Virtual",
"card_last_no": "",
"organization": "",
"status": "Activated",
"time": 1716307200000
}]
}
}
Queries the card list.
Request Headers
string
required
apiKey (merchant credential, bound to IP whitelist)
string
required
Unix timestamp in milliseconds. The deviation from the server time must be within 60 seconds, and future timestamps are not accepted.
string
required
Login token (required for all interfaces except Get Token).
string
default:"application/json"
Fixed to
application/jsonstring
default:"UTC+8"
Timezone, affects the day boundary calculation for
start_time / end_time. Defaults to UTC+8.Request Body
string
Cardholder order number.
string
Merchant-side unique card number.
string
Card order number.
string
required
Start time (
yyyy-MM-dd or yyyy-MM-dd HH:mm:ss).string
required
End time (same format as above; interval ≤ 90 days).
number
default:"0"
Query page number. Defaults to
0.number
default:"10"
Number of records per page. Defaults to
10 (max 100).Response Parameters
number
Response status code.
0 indicates success.string
Response message.
object
Response data.
Show data
Show data
object[]
Card list.
Show list
Show list
string
Card order number
string
Merchant-side unique card number
string
Cardholder order number
string
Card type, see [Appendix - Constants] Card Types
string
Card organization
string
Last four digits of card number
string
Status, see [Appendix - Constants] Card Status
number
Card creation time (Unix milliseconds)
curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/card/list \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--header 'Timezone: UTC+8' \
--data '{
"cardholder_no": "",
"card_unique_no": "",
"card_no": "",
"start_time": "2026-01-01",
"end_time": "2026-03-31",
"page": 0,
"size": 10
}'
{
"code": 0,
"msg": "Success",
"data": {
"list": [{
"card_no": "",
"card_unique_no": "",
"cardholder_no": "",
"card_type": "Virtual",
"card_last_no": "",
"organization": "",
"status": "Activated",
"time": 1716307200000
}]
}
}