List Cards

List cards under the current account with optional filters and cursor-based pagination. Each item is a Card summary view.
Request Parameters
limitinteger
Number of records per page. Value range 1–100. Defaults to 20.
cursorstring
Pagination cursor token taken from the previous response's nextCursor or prevCursor. Omit for the first page.
statusstring
Filter by card status. Omit to include all statuses (including CANCELLED).

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).
last4Digitsstring
Filter by the last 4 digits of the card number (exact match). Max 4 characters.
cardNickNamestring
Filter by card nickname (fuzzy match). Max 120 characters.
budgetIdstring
The unique ID assigned by WorldFirst to identify a budget account. When specified, only cards under this budget account are returned; if omitted, cards under the primary budget account are returned by default.
Response Parameters
resultResult
See Result.
itemsarray of Card
Card summary array. Maximum 100 entries. Each element includes only summary fields; fetch full transaction limits and authorization controls via Query a Card.
Show child parametersShow child parameters
nextCursorstring
Cursor for the next page. null indicates the last page.
prevCursorstring
Cursor for the previous page. null indicates the first page.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSSuccess.Query succeeded.
PARAM_ILLEGALFIllegal parameters exist.Verify request fields against this reference.
USER_NO_PERMISSIONFUser does not have permission.Retry with a user that has permission.
INVALID_CLIENTFThe client is invalid.Verify your client credentials.
USER_NOT_EXISTFThe user does not exist.Retry with correct user information.
ASSET_NOT_EXITFAsset does not exist.Verify the query filters.
PROCESS_FAILFA general business failure occurred. Do not retry.Do not retry. Contact WorldFirst support.
Definition
POST /api/open/v1/issuing/cards/list
Request
{
"limit": 3
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"items": [
  {
    "id": "2026062529027200120855200003801",
    "status": "ACTIVE",
    "createdAt": "2026-06-25T15:08:06Z",
    "cardholderId": "2025062529027200120854400001454",
    "mediaType": "VIRTUAL",
    "cardBrand": "MASTERCARD",
    "cardNumber": "****5427",
    "last4Digits": "5427",
    "cardNickName": "Example Card"
  },
  {
    "id": "2026062529027200120855200003802",
    "status": "ACTIVE",
    "createdAt": "2026-06-25T15:09:12Z",
    "cardholderId": "2025062529027200120854400001454",
    "mediaType": "VIRTUAL",
    "cardBrand": "MASTERCARD",
    "cardNumber": "****7340",
    "last4Digits": "7340",
    "cardNickName": "Example Card"
  }
],
"nextCursor": "eyJpZCI6****"
}