Transaction History

This endpoint allows you to fetch the transaction history for a specific account, identified by its NUBAN. You can filter transactions based on the start and end dates. The API returns a list of transactions that match the specified NUBAN and date range.

Note: This feature has been deprecated, contact adminstrator for use of Webhooks

Query Parameters:

Parameter	Type	Description
`nuban`	string	The NUBAN (Nigerian Uniform Bank Account Number) of the account.
`startDate`	string	The start date for filtering transactions (format: `dd-mm-yyyy`).
`endDate`	string	The end date for filtering transactions (format: `dd-mm-yyyy`).

Response Body:

Field	Type	Description
`id`	integer	A unique identifier for the transaction.
`nuban`	string	The NUBAN of the account involved in the transaction.
`amount`	decimal	The amount involved in the transaction.
`paymentTypeId`	integer	The ID representing the payment type (if available).
`notes`	string	Any additional notes or details about the transaction.
`transactionDate`	string	The date when the transaction occurred (in `dd-mm-yyyy` format).
`transactionType`	string	The type of transaction, e.g., `DEPOSIT` or `WITHDRAWAL`.
`balance`	decimal	The account balance after the transaction.

Responses

🟢200Success

application/json

Body

array of:

integer

required

nuban

string

required

amount

integer

required

paymentTypeId

integer

required

notes

string

required

transactionDate

string

required

transactionType

string

required

balance

integer

required

Example

[
    {
        "id": 101,
        "nuban": "0000000024",
        "amount": 5000,
        "paymentTypeId": 175,
        "notes": "BULK TRANSFER - TESTING PAYMENT TYPE",
        "transactionDate": "13-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 5916
    },
    {
        "id": 86,
        "nuban": "0000000024",
        "amount": 400,
        "paymentTypeId": 150,
        "notes": "BULK TRANSFER - 323",
        "transactionDate": "12-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 499
    },
    {
        "id": 87,
        "nuban": "0000000024",
        "amount": 5,
        "paymentTypeId": 150,
        "notes": "BULK TRANSFER - JUST A TRANSFER 2\r",
        "transactionDate": "12-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 504
    },
    {
        "id": 96,
        "nuban": "0000000024",
        "amount": 12,
        "transactionDate": "12-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 516
    },
    {
        "id": 105,
        "nuban": "0000000024",
        "amount": 400,
        "transactionDate": "12-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 916
    },
    {
        "id": 71,
        "nuban": "0000000024",
        "amount": 5,
        "transactionDate": "10-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 89
    },
    {
        "id": 75,
        "nuban": "0000000024",
        "amount": 5,
        "transactionDate": "10-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 94
    },
    {
        "id": 83,
        "nuban": "0000000024",
        "amount": 5,
        "transactionDate": "10-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 99
    },
    {
        "id": 67,
        "nuban": "0000000024",
        "amount": 21,
        "transactionDate": "09-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 50
    },
    {
        "id": 69,
        "nuban": "0000000024",
        "amount": 34,
        "transactionDate": "09-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 84
    },
    {
        "id": 53,
        "nuban": "0000000024",
        "amount": 11,
        "transactionDate": "05-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 11
    },
    {
        "id": 57,
        "nuban": "0000000024",
        "amount": 10,
        "transactionDate": "05-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 21
    },
    {
        "id": 61,
        "nuban": "0000000024",
        "amount": 7,
        "paymentTypeId": 1,
        "notes": "BULK TRANSFER - TEST BULK 5",
        "transactionDate": "05-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 28
    },
    {
        "id": 63,
        "nuban": "0000000024",
        "amount": 1,
        "transactionDate": "05-08-2023",
        "transactionType": "DEPOSIT",
        "balance": 29
    }
]

Request

Request samples

Responses