API Get List Virtual Cards

Endpoint: GET /v2/vc/virtual-cards

Description:

Retrieve a paginated list of virtual cards, optionally filtered by requestId, status, cardBrand, or cardHolderName.


Request

Request Params Field Descriptions

Field Name
Type
Required
Description

pageIndex

number

No

Index of the page to retrieve (pagination).

pageSize

number

No

Number of items per page (pagination).

dateFr

date string

No

Filter policies created from this date (YYYY-MM-DD).

dateTo

date string

No

Filter policies created up to this date (YYYY-MM-DD).

requestId

string

No

Filter by virtual card batch request ID.

status

string

No

Filter by card status (e.g., ACTIVED).

cardBrand

string

No

Filter by card brand (e.g., visa, mastercard).

Response

Response Field Descriptions

Field Name
Type
Description

code

number

Response code

state

number

State of the response

data.docs

array

List of virtual card documents

data.totalDocs

number

Total number of documents

data.totalPages

number

Total number of pages

message

string

Response message

neoResponseId

string

Unique Neo response identifier

docs object item fields:

Field Name
Type
Description

requestId

string

Virtual card batch request ID

virtualCardRequestId

string

Virtual card request identifier

merchantId

string

Merchant unique identifier

merchantCode

string

Merchant code

merchantEmail

string

Merchant email

cardData.cardHolderName

string

Card holder name

cardData.cardBrand

string

Card brand

cardPolicy.policyRequestId

string

Policy request identifier

cardPolicy.policyRevision

number

Policy revision number

cardPolicy.cardCurrency

string

Card currency

cardPolicy.cardLimit

number

Card limit amount

cardPolicy.minTransAmount

number

Minimum transaction amount

cardPolicy.maxTransAmount

number

Maximum transaction amount

cardPolicy.autoCloseCard

boolean

Whether card auto closes

status

string

Card status

createdAt

string

Creation timestamp (ISO 8601)

updatedAt

string

Last update timestamp (ISO 8601)

Response sample

{
  "code": 1,
  "state": 2,
  "data": {
    "docs": [
      {
        "requestId": "dcf35140-f306-4a2d-9435-3c2e2d606c19",
        "virtualCardRequestId": "dcf35140-f306-4a2d-9435-3c2e2d606c19",
        "merchantId": "65e04347da1793874c4f9476",
        "merchantCode": "COLRLC",
        "merchantEmail": "[email protected]",
        "cardData": {
          "cardHolderName": "Money Market Account",
          "cardBrand": "mastercard"
        },
        "cardPolicy": {
          "policyRequestId": "e424ae34-5c56-45c8-882e-98c4325981d3",
          "policyRevision": 3,
          "cardCurrency": "USD",
          "cardLimit": 30000,
          "minTransAmount": 10,
          "maxTransAmount": 2000,
          "autoCloseCard": false,
        },
        "status": "INACTIVED",
        "extraInfo": {},
        "createdAt": "2025-06-05T02:03:39.179Z",
        "updatedAt": "2025-06-05T02:03:39.238Z"
      }
    ],
    "totalDocs": 1,
    "totalPages": 1
  },
  "message": "Successful",
  "neoResponseId": "99598a34-5d76-4543-9580-0c7c89f998fa"
}

Example cURL

curl -X GET "https://{base_url_openapi}/v2/vc/virtual-cards/" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: en"

Notes

  • Requires Bearer token in the Authorization header.

  • The Accept-Language header can be used to specify the response language (Support: "vi", "en").

  • Common query parameters: pageIndex, pageSize, dateFr, dateTo, requestId, status, cardBrand.

  • No request body required.

Last updated

Was this helpful?