Query a Card

Retrieve the full details of a card by its ID, including status, limits, and authorization controls. A cancelled card (status=CANCELLED) is still returned by this query; filter by the status field client-side if needed.
Request Parameters
idstring
required
Unique card identifier. Max 64 characters.
Response Parameters
resultResult
See Result.
idstring
Unique card identifier. Max 64 characters.
statusstring
Current card status.

Valid Values:

PENDING — Card application submitted, awaiting review or production.
ACTIVE — Card is activated and ready for transactions.
FROZEN — Card is frozen; transactions are paused and can be resumed.
FAILED — Card creation failed (terminal).
CANCELLED — Card cancelled (terminal).
cardholderIdstring
Associated cardholder ID. Max 64 characters.
mediaTypestring
Card media type.

Valid Values:

VIRTUAL — Virtual card.
PHYSICAL — Physical card.
createdAtdatetime
Creation timestamp. ISO 8601 extended format.
cardBrandstring
Card network brand.

Valid Values:

VISA — Visa network.
MASTERCARD — Mastercard network.
budgetIdstring
Associated budget account ID. Max 64 characters.
cardNumberstring
Masked card number. Returned only when status is ACTIVE. Max 19 characters.
expiryDatestring
Card expiry date. Returned only when status is ACTIVE. Format MM/YY.
last4Digitsstring
Last 4 digits of the card number. Max 4 characters.
cardNickNamestring
Merchant-defined friendly name. Max 120 characters.
notestring
Free-text note. Max 512 characters.
purposestring
Card purpose description. Max 64 characters.
emailstring
Email associated with the card. Max 256 characters.
mobilePhonestring
Mobile phone associated with the card. Max 32 characters.
billingAddressAddress
Billing address. See Data Types.
transactionLimitsarray of TransactionLimits
Transaction limit configuration, aggregated by currency. Maximum 5 entries. At creation, each limit only needs interval and rangeAmount.
Show child parametersShow child parameters
authorizationControlAuthorizationControl
Authorization control rules governing when and where the card can transact.
Show child parametersShow child parameters
metadataobject
Merchant-defined metadata. Up to 50 keys.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSSuccess.Query succeeded.
CARD_NOT_FOUNDFCard {id} not found.Verify the `id` is correct.
PARAM_ILLEGALFIllegal parameters exist.Verify request fields against this reference.
USER_NO_PERMISSIONFUser does not have permission.Retry with a user that has permission for this card.
INVALID_CLIENTFThe client is invalid.Verify your client credentials.
ASSET_NOT_EXITFAsset does not exist.The card asset does not exist; verify the `id`.
PROCESS_FAILFA general business failure occurred. Do not retry.Do not retry. Contact WorldFirst support.
Definition
POST /api/open/v1/issuing/cards/query
Request
{
"id": "CARD_20260624290272001208****"
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"id": "CARD_20260624290272001208****",
"status": "ACTIVE",
"cardholderId": "CH_20250625290272001208****",
"mediaType": "VIRTUAL",
"createdAt": "2026-06-24T06:45:35Z",
"cardBrand": "MASTERCARD",
"cardNumber": "****3226",
"expiryDate": "06/31",
"last4Digits": "3226",
"cardNickName": "Team Travel Card",
"note": "QA note",
"purpose": "LODGING",
"email": "cardholder@example.com",
"mobilePhone": "+86*******0881",
"billingAddress": {
  "address1": "No.1 Test Street",
  "city": "Shanghai",
  "state": "Shanghai",
  "region": "CN",
  "zipCode": "000000"
},
"transactionLimits": [
  {
    "currency": "USD",
    "limits": [
      {
        "interval": "PER_TRANSACTION",
        "rangeAmount": 100000,
        "usedAmount": 0,
        "remainAmount": 100000
      },
      {
        "interval": "DAILY",
        "rangeAmount": 200000,
        "usedAmount": 0,
        "remainAmount": 200000
      },
      {
        "interval": "MONTHLY",
        "rangeAmount": 300000,
        "usedAmount": 0,
        "remainAmount": 300000
      },
      {
        "interval": "ALL_TIME",
        "rangeAmount": 400000,
        "usedAmount": 0,
        "remainAmount": 400000
      }
    ]
  }
],
"authorizationControl": {
  "allowedAuthTimes": 5,
  "allowedCurrencies": [
    "USD"
  ],
  "cardActiveAt": "2026-06-24T09:29:59Z",
  "cardCancelAt": "2026-06-27T07:30:00Z"
}
}