Virtual Account
Find Wallets
Get Started
API Reference
- Account
- Virtual Account
- Disbursement
- Transaction
Additional References
Virtual Account
Find Wallets
This endpoint returns all wallets belonging to the user.
curl --location '{{API_BASE_URL}}/virtual-accounts' \
--header 'x-giro-key: {{SECRET_KEY}}' \
--header 'Content-Type: application/json' \
{
"meta": {
"statusCode": 200,
"success": true,
"pagination": {
"totalCount": 1,
"perPage": 10,
"current": 1
}
},
"data": [
{
"_id": "66dd1226632b0f2s8e8d3532",
"id": "66dd1226632b0f2s8e8d3532",
"publicId": "vba-19aeceea-1bd6-4e85-89fa-2ca0b1c57d61",
"auth": "65b12bbf512f9932b67f53d7",
"account": "65b12bbf36e38c6bfbe35f95",
"accountName": "John Doe",
"accountNumber": "7481018744",
"bankName": "Source MFB",
"bankCode": "090641",
"live": true,
"isFavourite": true,
"processor": "source",
"category": "primary",
"id": 1,
"createdAt": "2024-04-20T19:50:16.880Z",
"updatedAt": "2024-04-20T19:50:16.880Z",
"balance": 0,
"currency": "NGN",
"lastUpdated": "2024-04-20T19:50:16.880Z"
},
{
"_id": "66dd1226632b0f2s8e8d23es",
"id": "66dd1226632b0f2s8e8d23es",
"publicId": "vba-19aeceea-1bd6-4e85-89fa-2cefr1c57d61",
"auth": "65b12bbf512f9932b67f53d7",
"account": "65b12bbf36e38c6bfbe35f95",
"accountName": "Jane Doe",
"accountNumber": "7481445744",
"bankName": "Source MFB",
"bankCode": "090641",
"live": true,
"isFavourite": false,
"processor": "source",
"category": "secondary",
"id": 2,
"createdAt": "2024-04-20T19:50:16.880Z",
"updatedAt": "2024-04-20T19:50:16.880Z",
"balance": 0,
"currency": "NGN",
"lastUpdated": "2024-04-20T19:50:16.880Z"
}
]
}
GET {{baseurl}}/virtual-accounts
https://gw.stg.girostack.com/v1
https://gw.stg.girostack.com/v1
https://gw.prod.girostack.com/v1
Headers
Pass your account’s secret key as the value.
curl --location '{{API_BASE_URL}}/virtual-accounts' \
--header 'x-giro-key: {{SECRET_KEY}}' \
--header 'Content-Type: application/json' \
{
"meta": {
"statusCode": 200,
"success": true,
"pagination": {
"totalCount": 1,
"perPage": 10,
"current": 1
}
},
"data": [
{
"_id": "66dd1226632b0f2s8e8d3532",
"id": "66dd1226632b0f2s8e8d3532",
"publicId": "vba-19aeceea-1bd6-4e85-89fa-2ca0b1c57d61",
"auth": "65b12bbf512f9932b67f53d7",
"account": "65b12bbf36e38c6bfbe35f95",
"accountName": "John Doe",
"accountNumber": "7481018744",
"bankName": "Source MFB",
"bankCode": "090641",
"live": true,
"isFavourite": true,
"processor": "source",
"category": "primary",
"id": 1,
"createdAt": "2024-04-20T19:50:16.880Z",
"updatedAt": "2024-04-20T19:50:16.880Z",
"balance": 0,
"currency": "NGN",
"lastUpdated": "2024-04-20T19:50:16.880Z"
},
{
"_id": "66dd1226632b0f2s8e8d23es",
"id": "66dd1226632b0f2s8e8d23es",
"publicId": "vba-19aeceea-1bd6-4e85-89fa-2cefr1c57d61",
"auth": "65b12bbf512f9932b67f53d7",
"account": "65b12bbf36e38c6bfbe35f95",
"accountName": "Jane Doe",
"accountNumber": "7481445744",
"bankName": "Source MFB",
"bankCode": "090641",
"live": true,
"isFavourite": false,
"processor": "source",
"category": "secondary",
"id": 2,
"createdAt": "2024-04-20T19:50:16.880Z",
"updatedAt": "2024-04-20T19:50:16.880Z",
"balance": 0,
"currency": "NGN",
"lastUpdated": "2024-04-20T19:50:16.880Z"
}
]
}
Was this page helpful?
curl --location '{{API_BASE_URL}}/virtual-accounts' \
--header 'x-giro-key: {{SECRET_KEY}}' \
--header 'Content-Type: application/json' \
{
"meta": {
"statusCode": 200,
"success": true,
"pagination": {
"totalCount": 1,
"perPage": 10,
"current": 1
}
},
"data": [
{
"_id": "66dd1226632b0f2s8e8d3532",
"id": "66dd1226632b0f2s8e8d3532",
"publicId": "vba-19aeceea-1bd6-4e85-89fa-2ca0b1c57d61",
"auth": "65b12bbf512f9932b67f53d7",
"account": "65b12bbf36e38c6bfbe35f95",
"accountName": "John Doe",
"accountNumber": "7481018744",
"bankName": "Source MFB",
"bankCode": "090641",
"live": true,
"isFavourite": true,
"processor": "source",
"category": "primary",
"id": 1,
"createdAt": "2024-04-20T19:50:16.880Z",
"updatedAt": "2024-04-20T19:50:16.880Z",
"balance": 0,
"currency": "NGN",
"lastUpdated": "2024-04-20T19:50:16.880Z"
},
{
"_id": "66dd1226632b0f2s8e8d23es",
"id": "66dd1226632b0f2s8e8d23es",
"publicId": "vba-19aeceea-1bd6-4e85-89fa-2cefr1c57d61",
"auth": "65b12bbf512f9932b67f53d7",
"account": "65b12bbf36e38c6bfbe35f95",
"accountName": "Jane Doe",
"accountNumber": "7481445744",
"bankName": "Source MFB",
"bankCode": "090641",
"live": true,
"isFavourite": false,
"processor": "source",
"category": "secondary",
"id": 2,
"createdAt": "2024-04-20T19:50:16.880Z",
"updatedAt": "2024-04-20T19:50:16.880Z",
"balance": 0,
"currency": "NGN",
"lastUpdated": "2024-04-20T19:50:16.880Z"
}
]
}