Transaction History API

The Transaction History API allows authorized clients to retrieve up to the 50 most recent transactions for a customer’s account.

Endpoint

POST /api/transactionhistory

Base URL: https://banking.finserv.com.ng

Authentication

This endpoint requires an API key.

Header	Value
x-api-key	Your assigned API key

Request

Headers

Key	Value
Content-Type	application/json
x-api-key	YOUR_SECURE_API_KEY

Body (JSON)

{
  "accountNo": "1234567890"
}

Response

Success (200 OK)

Returns an array of up to 50 transactions:

[
  {
    "date": "2026-01-25",
    "amount": 50000,
    "type": "Deposit",
    "description": "Salary deposit",
    "balance": 300000.75
  },
  {
    "date": "2026-01-27",
    "amount": 20000,
    "type": "Withdrawal",
    "description": "ATM cash withdrawal",
    "balance": 280000.75
  }
  // ... up to 50 most recent transactions
]

Error Responses

• 400 Bad Request → {"error": "Account number is required"}
• 404 Not Found → {"error": "Account not found"}
• 401 Unauthorized → {"error": "API Key is missing"}
• 403 Forbidden → {"error": "Invalid API Key"}

Example Usage

JavaScript (Client Side)

fetch("https://banking.finserv.com.ng/api/transactionhistory", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_SECURE_API_KEY"
  },
  body: JSON.stringify({ accountNo: "1234567890" })
})
.then(response => response.json())
.then(transactions => {
  console.log("✅ Recent Transactions (up to 50):");
  transactions.forEach(tx => {
    console.log(`Date: ${tx.date}, Amount: ${tx.amount}, Type: ${tx.type}, Description: ${tx.description}, Balance: ${tx.balance}`);
  });
})
.catch(error => console.error("Error:", error));

Postman

Set method to POST, URL to https://banking.finserv.com.ng/api/transactionhistory, add headers, and body as shown above.