Get Transaction Details
curl --request GET \
--url https://johnajayi-avenue.hf.space/v1/transactions/:tx_id \
--header 'x-api-key: <api-key>'import requests
url = "https://johnajayi-avenue.hf.space/v1/transactions/:tx_id"
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/:tx_id', 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/:tx_id",
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/:tx_id"
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/:tx_id")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://johnajayi-avenue.hf.space/v1/transactions/:tx_id")
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": {
"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"
}
}
Transactions
Get Transaction Details
Retrieve a single transaction, including the full Avenue Intelligence output.
GET
/
v1
/
transactions
/
:tx_id
Get Transaction Details
curl --request GET \
--url https://johnajayi-avenue.hf.space/v1/transactions/:tx_id \
--header 'x-api-key: <api-key>'import requests
url = "https://johnajayi-avenue.hf.space/v1/transactions/:tx_id"
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/:tx_id', 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/:tx_id",
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/:tx_id"
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/:tx_id")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://johnajayi-avenue.hf.space/v1/transactions/:tx_id")
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": {
"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"
}
}
Request Headers
string
required
Your live or test API key.
Path Parameters
string
required
The Avenue transaction ID.
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": {
"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"
}
}
Was this page helpful?