Get all Cards
curl --request GET \
--url https://api.payvessel.com/pms/api/external/request/virtual-cards/ \
--header 'api-key: <api-key>' \
--header 'api-secret: <api-secret>'import requests
url = "https://api.payvessel.com/pms/api/external/request/virtual-cards/"
headers = {
"api-key": "<api-key>",
"api-secret": "<api-secret>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'api-key': '<api-key>', 'api-secret': '<api-secret>'}};
fetch('https://api.payvessel.com/pms/api/external/request/virtual-cards/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.payvessel.com/pms/api/external/request/virtual-cards/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"api-key: <api-key>",
"api-secret: <api-secret>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.payvessel.com/pms/api/external/request/virtual-cards/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api-key", "<api-key>")
req.Header.Add("api-secret", "<api-secret>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.payvessel.com/pms/api/external/request/virtual-cards/")
.header("api-key", "<api-key>")
.header("api-secret", "<api-secret>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.payvessel.com/pms/api/external/request/virtual-cards/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'
request["api-secret"] = '<api-secret>'
response = http.request(request)
puts response.read_body{
"status": true,
"message": "Virtual cards retrieved successfully",
"data": [
{
"id": "7f219a25-d968-4894-9a8b-ba83fa0bf6ec",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "557350******7848",
"status": "ACTIVE",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "3.00",
"expiry": "08/31",
"created_datetime": "2026-05-24T00:38:02.543669",
"updated_datetime": "2026-05-24T03:20:19.331923"
},
{
"id": "a0e7ed8b-bbb7-48d2-81e1-d76d98965006",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "227449******4392",
"status": "TERMINATED",
"currency": "USD",
"brand": "VISA",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T21:35:08.115964",
"updated_datetime": "2026-05-22T21:35:50.942942"
},
{
"id": "aae598cc-99d9-4730-80f5-4044d49bba75",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "business",
"customer_id": null,
"customer_name": null,
"business_name": "Nex Panther Technologies",
"card_name": "MARKETING CARD",
"masked_pan": "222980******7461",
"status": "TERMINATED",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T20:29:31.615688",
"updated_datetime": "2026-05-24T02:05:56.229932"
},
{
"id": "94659981-fcdd-46fc-baf6-ed2defe11497",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "business",
"customer_id": null,
"customer_name": null,
"business_name": "Nex Panther Technologies",
"card_name": "NEX PANTHER TECHNOLOGIES",
"masked_pan": "556239******1702",
"status": "TERMINATED",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T20:16:55.532341",
"updated_datetime": "2026-05-24T02:09:20.005748"
},
{
"id": "e52c1e97-4266-4673-ba17-2f5c581a471a",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "271479******0667",
"status": "TERMINATED",
"currency": "USD",
"brand": "VISA",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T20:05:58.926686",
"updated_datetime": "2026-05-22T20:11:53.886907"
},
{
"id": "ef8bfabb-a362-42e2-b881-4264466d1092",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "222216******9786",
"status": "TERMINATED",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T20:04:53.885611",
"updated_datetime": "2026-05-22T20:05:30.183982"
},
{
"id": "8d56aa56-0539-4a12-bd07-186754a5c30d",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "222631******9071",
"status": "TERMINATED",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T20:02:12.217529",
"updated_datetime": "2026-05-22T20:03:54.927384"
},
{
"id": "1e68abb2-ffea-4325-b8cf-ee47ef1181a7",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "559823******2749",
"status": "TERMINATED",
"currency": "USD",
"brand": "VISA",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T19:59:03.393789",
"updated_datetime": "2026-05-22T19:59:55.652210"
},
{
"id": "821e3321-818d-44aa-8816-b8078d83651c",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "257392******6469",
"status": "TERMINATED",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T19:36:16.031791",
"updated_datetime": "2026-05-22T19:55:15.561682"
},
{
"id": "8b248314-1303-4cfe-abf5-db9353da4cc7",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "229160******5625",
"status": "TERMINATED",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T19:10:25.288651",
"updated_datetime": "2026-05-22T19:35:48.059145"
}
]
}{
"error": 401,
"message": "Unauthorized. Please check your API key."
}{
"error": 123,
"message": "<string>"
}{
"error": 123,
"message": "<string>"
}{
"error": 123,
"message": "<string>"
}Issuing
Get all Cards
List customer virtual cards for your business
GET
/
pms
/
api
/
external
/
request
/
virtual-cards
/
Get all Cards
curl --request GET \
--url https://api.payvessel.com/pms/api/external/request/virtual-cards/ \
--header 'api-key: <api-key>' \
--header 'api-secret: <api-secret>'import requests
url = "https://api.payvessel.com/pms/api/external/request/virtual-cards/"
headers = {
"api-key": "<api-key>",
"api-secret": "<api-secret>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'api-key': '<api-key>', 'api-secret': '<api-secret>'}};
fetch('https://api.payvessel.com/pms/api/external/request/virtual-cards/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.payvessel.com/pms/api/external/request/virtual-cards/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"api-key: <api-key>",
"api-secret: <api-secret>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.payvessel.com/pms/api/external/request/virtual-cards/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api-key", "<api-key>")
req.Header.Add("api-secret", "<api-secret>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.payvessel.com/pms/api/external/request/virtual-cards/")
.header("api-key", "<api-key>")
.header("api-secret", "<api-secret>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.payvessel.com/pms/api/external/request/virtual-cards/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'
request["api-secret"] = '<api-secret>'
response = http.request(request)
puts response.read_body{
"status": true,
"message": "Virtual cards retrieved successfully",
"data": [
{
"id": "7f219a25-d968-4894-9a8b-ba83fa0bf6ec",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "557350******7848",
"status": "ACTIVE",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "3.00",
"expiry": "08/31",
"created_datetime": "2026-05-24T00:38:02.543669",
"updated_datetime": "2026-05-24T03:20:19.331923"
},
{
"id": "a0e7ed8b-bbb7-48d2-81e1-d76d98965006",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "227449******4392",
"status": "TERMINATED",
"currency": "USD",
"brand": "VISA",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T21:35:08.115964",
"updated_datetime": "2026-05-22T21:35:50.942942"
},
{
"id": "aae598cc-99d9-4730-80f5-4044d49bba75",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "business",
"customer_id": null,
"customer_name": null,
"business_name": "Nex Panther Technologies",
"card_name": "MARKETING CARD",
"masked_pan": "222980******7461",
"status": "TERMINATED",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T20:29:31.615688",
"updated_datetime": "2026-05-24T02:05:56.229932"
},
{
"id": "94659981-fcdd-46fc-baf6-ed2defe11497",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "business",
"customer_id": null,
"customer_name": null,
"business_name": "Nex Panther Technologies",
"card_name": "NEX PANTHER TECHNOLOGIES",
"masked_pan": "556239******1702",
"status": "TERMINATED",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T20:16:55.532341",
"updated_datetime": "2026-05-24T02:09:20.005748"
},
{
"id": "e52c1e97-4266-4673-ba17-2f5c581a471a",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "271479******0667",
"status": "TERMINATED",
"currency": "USD",
"brand": "VISA",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T20:05:58.926686",
"updated_datetime": "2026-05-22T20:11:53.886907"
},
{
"id": "ef8bfabb-a362-42e2-b881-4264466d1092",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "222216******9786",
"status": "TERMINATED",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T20:04:53.885611",
"updated_datetime": "2026-05-22T20:05:30.183982"
},
{
"id": "8d56aa56-0539-4a12-bd07-186754a5c30d",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "222631******9071",
"status": "TERMINATED",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T20:02:12.217529",
"updated_datetime": "2026-05-22T20:03:54.927384"
},
{
"id": "1e68abb2-ffea-4325-b8cf-ee47ef1181a7",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "559823******2749",
"status": "TERMINATED",
"currency": "USD",
"brand": "VISA",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T19:59:03.393789",
"updated_datetime": "2026-05-22T19:59:55.652210"
},
{
"id": "821e3321-818d-44aa-8816-b8078d83651c",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "257392******6469",
"status": "TERMINATED",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T19:36:16.031791",
"updated_datetime": "2026-05-22T19:55:15.561682"
},
{
"id": "8b248314-1303-4cfe-abf5-db9353da4cc7",
"business_id": "8f926b04-e63a-4449-b346-ea922b69e20e",
"kind": "customer",
"customer_id": "5e6bda15-1090-4cfe-bc1d-861990947bbc",
"customer_name": "MUSA GANIYU",
"business_name": null,
"card_name": "Ganiyu Musa",
"masked_pan": "229160******5625",
"status": "TERMINATED",
"currency": "USD",
"brand": "MASTERCARD",
"balance": "0.00",
"expiry": "08/31",
"created_datetime": "2026-05-22T19:10:25.288651",
"updated_datetime": "2026-05-22T19:35:48.059145"
}
]
}{
"error": 401,
"message": "Unauthorized. Please check your API key."
}{
"error": 123,
"message": "<string>"
}{
"error": 123,
"message": "<string>"
}{
"error": 123,
"message": "<string>"
}Headers
Your Payvessel public API key
Your Payvessel secret
Query Parameters
Filter: PENDING, ACTIVE, FROZEN, TERMINATED, FAILED
Available options:
PENDING, ACTIVE, FROZEN, TERMINATED, FAILED ⌘I