List Transactions
curl --request GET \
--url https://johnajayi-avenue.hf.space/v1/transactions \
--header 'x-api-key: <api-key>'import requests
url = "https://johnajayi-avenue.hf.space/v1/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/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/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/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/transactions")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://johnajayi-avenue.hf.space/v1/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 Transactions
List all double-entry ledger transactions across all wallets.
GET
/
v1
/
transactions
List Transactions
curl --request GET \
--url https://johnajayi-avenue.hf.space/v1/transactions \
--header 'x-api-key: <api-key>'import requests
url = "https://johnajayi-avenue.hf.space/v1/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/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/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/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/transactions")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://johnajayi-avenue.hf.space/v1/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.
Query Parameters
string
Filter transactions for a specific wallet.
string
Filter by
CREDIT or DEBIT.string
Filter by AI-generated flags (e.g.
UNDERPAYMENT_DETECTED).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?