List Wallet Transactions
curl --request GET \
--url https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions \
--header 'x-api-key: <api-key>'import requests
url = "https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions', 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://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions",
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: <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://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<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://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"items": [
{
"id": "t9c3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
"wallet_id": "e4b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
"developer_id": "d7b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
"type": "CREDIT",
"amount": 2500000,
"balance_before": 0,
"balance_after": 2500000,
"currency": "NGN",
"status": "SETTLED",
"nomba_reference": "TXN_ABC123",
"sender_name": "Tobi Olukoya",
"sender_account": "0123456789",
"raw_narration": "Payment for school fees",
"avenue_intelligence": {
"raw_narration": "Payment for school fees",
"extracted_intent": "school fees payment",
"confidence_score": 0.95,
"flags": [],
"suggested_label": "School Fees"
},
"created_at": "2026-07-01T12:00:00Z"
}
],
"total": 1250,
"page": 1,
"limit": 20
}
}
Transactions
List Wallet Transactions
List chronological ledger transactions specifically for a single wallet.
GET
/
v1
/
wallets
/
:wallet_id
/
transactions
List Wallet Transactions
curl --request GET \
--url https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions \
--header 'x-api-key: <api-key>'import requests
url = "https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions', 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://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions",
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: <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://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<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://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/transactions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"items": [
{
"id": "t9c3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
"wallet_id": "e4b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
"developer_id": "d7b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
"type": "CREDIT",
"amount": 2500000,
"balance_before": 0,
"balance_after": 2500000,
"currency": "NGN",
"status": "SETTLED",
"nomba_reference": "TXN_ABC123",
"sender_name": "Tobi Olukoya",
"sender_account": "0123456789",
"raw_narration": "Payment for school fees",
"avenue_intelligence": {
"raw_narration": "Payment for school fees",
"extracted_intent": "school fees payment",
"confidence_score": 0.95,
"flags": [],
"suggested_label": "School Fees"
},
"created_at": "2026-07-01T12:00:00Z"
}
],
"total": 1250,
"page": 1,
"limit": 20
}
}
Request Headers
string
required
Your live or test API key.
Path Parameters
string
required
The Avenue wallet ID.
Query Parameters
string
Filter by
CREDIT or DEBIT.integer
default:"1"
The page number to retrieve.
integer
default:"20"
Number of results per page (max 100).
Response
All amounts and balances in this endpoint are represented in kobo (e.g.,
500000 = ₦5,000.00). Ensure you do not send or expect Naira values.Understanding
status vs Suspense: When a transaction status is PENDING, it means the transaction is actively processing at the bank network level (like a standard pending transfer). This is not the same as the Suspense Queue. Transactions stuck in the Suspense Queue (due to AI confidence or closed wallets) are not returned in this ledger endpoint until they are resolved.{
"success": true,
"data": {
"items": [
{
"id": "t9c3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
"wallet_id": "e4b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
"developer_id": "d7b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
"type": "CREDIT",
"amount": 2500000,
"balance_before": 0,
"balance_after": 2500000,
"currency": "NGN",
"status": "SETTLED",
"nomba_reference": "TXN_ABC123",
"sender_name": "Tobi Olukoya",
"sender_account": "0123456789",
"raw_narration": "Payment for school fees",
"avenue_intelligence": {
"raw_narration": "Payment for school fees",
"extracted_intent": "school fees payment",
"confidence_score": 0.95,
"flags": [],
"suggested_label": "School Fees"
},
"created_at": "2026-07-01T12:00:00Z"
}
],
"total": 1250,
"page": 1,
"limit": 20
}
}
Was this page helpful?