Loading...
Retrieves a paginated list of financial transactions for the authenticated user. This endpoint provides transaction history with detailed information about each transaction including amount, type, recipient details, and status. Query Parameters: page (optional): Page number for pagination (default: 1) limit (optional): Number of transactions per page (default: 20) id (optional): If provided, returns a specific transaction by ID instead of the list
KEY | VALUE | DESCRIPTION |
---|---|---|
X-API-Key | X-API-Key | - |
X-API-Secret | X-API-Secret | - |
// Using fetch API
const response = await fetch("http://localhost:5000/api/v1/developer/transactions?page=1&limit=2", {
method: "GET",
headers: {
"X-API-Key": "X-API-Key",
"X-API-Secret": "X-API-Secret"
}
});
const data = await response.json();
console.log(data);
Parameter | Type | Required | Description |
---|
{}
Success response
{
"statusCode": 200
"message": "Transactions retrieved successfully"
"data" {
"transactions" [
{
"_id": "65f8a123b42c87e1234a9876"
"accountNumber": "1234567890"
"transactionType": "DEBIT"
"amount": 5000
"date": "2024-03-18T14:23:45.000Z"
"status": "Completed"
"reference": "TRF123456789"
"narration": "Payment for services"
"senderAccountNumber": "1234567890"
"receiverAccountNumber": "0987654321"
"senderAccountName": "John Doe"
"receiverAccountName": "Jane Smith"
"senderBank": "Lemu"
"receiverBank": "Access Bank"
"providerChannel": "Mobile"
"createdAt": "2024-03-18T14:23:45.000Z"
"updatedAt": "2024-03-18T14:23:45.000Z"
"transactionLocation": "Lagos, Nigeria"
"fees": 50
}
],
"pagination" {
"total": 45
"page": 1
"limit": 20
"totalPages": 3
}
}
}