Get Wallet
curl --request GET \
--url https://api.example.com/api/v1/wallets/fiat/{walletId} \
--header 'x-api-key: <x-api-key>'import requests
url = "https://api.example.com/api/v1/wallets/fiat/{walletId}"
headers = {"x-api-key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};
fetch('https://api.example.com/api/v1/wallets/fiat/{walletId}', 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.example.com/api/v1/wallets/fiat/{walletId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <x-api-key>"
],
]);
$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.example.com/api/v1/wallets/fiat/{walletId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<x-api-key>")
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.example.com/api/v1/wallets/fiat/{walletId}")
.header("x-api-key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/wallets/fiat/{walletId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"status": true,
"message": "wallet retrieved successfully",
"data": {
"id": "wal_abc123xyz",
"customerId": "cus_123456789",
"availableBalance": "10000.00",
"ledgerBalance": "10000.00",
"walletName": "Main Wallet",
"customerType": "individual",
"virtualAccount": {
"accountNumber": "1234567890",
"bankCode": "035",
"bankName": "Wema Bank"
}
}
}
{
"status": false,
"message": "Wallet not found",
"code": "WALLET_NOT_FOUND"
}
Virtual Wallets
Get Wallet
Retrieve details of a specific fiat wallet
GET
/
api
/
v1
/
wallets
/
fiat
/
{walletId}
Get Wallet
curl --request GET \
--url https://api.example.com/api/v1/wallets/fiat/{walletId} \
--header 'x-api-key: <x-api-key>'import requests
url = "https://api.example.com/api/v1/wallets/fiat/{walletId}"
headers = {"x-api-key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};
fetch('https://api.example.com/api/v1/wallets/fiat/{walletId}', 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.example.com/api/v1/wallets/fiat/{walletId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <x-api-key>"
],
]);
$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.example.com/api/v1/wallets/fiat/{walletId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<x-api-key>")
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.example.com/api/v1/wallets/fiat/{walletId}")
.header("x-api-key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/wallets/fiat/{walletId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"status": true,
"message": "wallet retrieved successfully",
"data": {
"id": "wal_abc123xyz",
"customerId": "cus_123456789",
"availableBalance": "10000.00",
"ledgerBalance": "10000.00",
"walletName": "Main Wallet",
"customerType": "individual",
"virtualAccount": {
"accountNumber": "1234567890",
"bankCode": "035",
"bankName": "Wema Bank"
}
}
}
{
"status": false,
"message": "Wallet not found",
"code": "WALLET_NOT_FOUND"
}
Path Parameters
The unique identifier of the wallet
Request
API Key for authentication
Request Example
curl https://api-production.fossapay.com/api/v1/wallets/fiat/wal_abc123xyz \
-H "x-api-key: fp_live_sk_xxxxxxxx"
const response = await fetch('https://api-production.fossapay.com/api/v1/wallets/fiat/wal_abc123xyz', {
headers: {
'x-api-key': 'fp_live_sk_xxxxxxxx'
}
});
const data = await response.json();
const wallet = data.data;
import requests
url = "https://api-production.fossapay.com/api/v1/wallets/fiat/wal_abc123xyz"
headers = {"x-api-key": "fp_live_sk_xxxxxxxx"}
response = requests.get(url, headers=headers)
data = response.json()
wallet = data["data"]
Response
Response status
Human-readable response message
Show properties
Show properties
Unique identifier for the wallet
Customer ID associated with the wallet
Available balance in the wallet
Ledger balance in the wallet
Name of the wallet
Type of customer
Response Example
{
"status": true,
"message": "wallet retrieved successfully",
"data": {
"id": "wal_abc123xyz",
"customerId": "cus_123456789",
"availableBalance": "10000.00",
"ledgerBalance": "10000.00",
"walletName": "Main Wallet",
"customerType": "individual",
"virtualAccount": {
"accountNumber": "1234567890",
"bankCode": "035",
"bankName": "Wema Bank"
}
}
}
{
"status": false,
"message": "Wallet not found",
"code": "WALLET_NOT_FOUND"
}
Error Codes
| Code | Description |
|---|---|
WALLET_NOT_FOUND | Wallet with this ID does not exist |
UNAUTHORIZED | Invalid API key or insufficient permissions |
⌘I

