curl -X GET 'https://api.yativo.com/api/v1/customer/virtual/cards/list?page=1&per_page=20' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Records retrieved successfully",
"data": [
{
"id": "e6f2f9d0-2d4f-4b4f-9d9f-2f1f8f9e3a7e",
"customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
"customer_card_id": "card_01HX9KZMB3F7VNQP8R2WDGT4E5",
"card_id": "card_01HX9KZMB3F7VNQP8R2WDGT4E5",
"card_number": "4111111111111234",
"expiry_date": "04/29",
"cvv": "123",
"card_status": "active",
"raw_data": {
"cardName": "Main Expense Card",
"cardBrand": "visa"
}
}
],
"pagination": {
"total": 5,
"per_page": 20,
"current_page": 1,
"last_page": 1,
"next_page_url": null,
"prev_page_url": null
}
}
Virtual Cards
List Virtual Cards
Retrieve all virtual cards issued to customers
GET
/
customer
/
virtual
/
cards
/
list
curl -X GET 'https://api.yativo.com/api/v1/customer/virtual/cards/list?page=1&per_page=20' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Records retrieved successfully",
"data": [
{
"id": "e6f2f9d0-2d4f-4b4f-9d9f-2f1f8f9e3a7e",
"customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
"customer_card_id": "card_01HX9KZMB3F7VNQP8R2WDGT4E5",
"card_id": "card_01HX9KZMB3F7VNQP8R2WDGT4E5",
"card_number": "4111111111111234",
"expiry_date": "04/29",
"cvv": "123",
"card_status": "active",
"raw_data": {
"cardName": "Main Expense Card",
"cardBrand": "visa"
}
}
],
"pagination": {
"total": 5,
"per_page": 20,
"current_page": 1,
"last_page": 1,
"next_page_url": null,
"prev_page_url": null
}
}
Returns all virtual cards issued under your business account.
GET https://api.yativo.com/api/v1/customer/virtual/cards/list
curl -X GET 'https://api.yativo.com/api/v1/customer/virtual/cards/list?page=1&per_page=20' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Records retrieved successfully",
"data": [
{
"id": "e6f2f9d0-2d4f-4b4f-9d9f-2f1f8f9e3a7e",
"customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
"customer_card_id": "card_01HX9KZMB3F7VNQP8R2WDGT4E5",
"card_id": "card_01HX9KZMB3F7VNQP8R2WDGT4E5",
"card_number": "4111111111111234",
"expiry_date": "04/29",
"cvv": "123",
"card_status": "active",
"raw_data": {
"cardName": "Main Expense Card",
"cardBrand": "visa"
}
}
],
"pagination": {
"total": 5,
"per_page": 20,
"current_page": 1,
"last_page": 1,
"next_page_url": null,
"prev_page_url": null
}
}
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.

