Account Transactions
This endpoint allows developers to retrieve customer's transaction details from their bank accounts. Transaction details include the bank name linked to the transaction, amount, location, transaction type (credit or debit), time, and date of occurrence.
You have the option of using webhook as a type of response_mode. This will enable you get the transaction results through the url provided by you.
GET Account Transactions
1
{{baseUrl}}/api/v1/financial/account_transactions
Copied!
Params
Curl
Response
Parameters
Type
Description
account_id required
string
Account ID
last_transaction_id
string
The oldest transaction ID you want to start with
start_date
string
The start date of transaction you want to get
end_date
string
The end date of transaction you want to get
trans_type
string
Either debit or credit
response_mode
string
Your preferred mode of results.It can be: paginated, not_paginated, or webhook. Tue default is paginated
callback_url
string
callback url used as webhook
1
curl -L -X GET '{{baseUrl}}/api/v1/financial/account_transactions' \
2
-H 'Authorization: SECRET_KEY' \
3
-H 'AppId: APP_ID'
Copied!
1
{
2
"entity": {
3
"transactions": [
4
{
5
"id": 1454,
6
"transaction_date": "2020-09-22",
7
"value_date": "2020-09-22",
8
"trans_type": "debit",
9
"bank_name": "Guaranty Trust Bank",
10
"amount": "200.00",
11
"reference": "0",
12
"narration": "Airtime Purchase USSD-101CT0000000002019935870-2349057014101"
13
},
14
{
15
"id": 1455,
16
"transaction_date": "2020-09-21",
17
"value_date": "2020-09-21",
18
"trans_type": "debit",
19
"bank_name": "Guaranty Trust Bank",
20
"amount": "300.00",
21
"reference": "0",
22
"narration": "Airtime Purchase USSD-101CT0000000002019365730-2349057014101"
23
},
24
{
25
"id": 1456,
26
"transaction_date": "2020-09-21",
27
"value_date": "2020-09-21",
28
"trans_type": "debit",
29
"bank_name": "Guaranty Trust Bank",
30
"amount": "200.00",
31
"reference": "0",
32
"narration": "Airtime Purchase USSD-101CT0000000002019343280-2349057014101"
33
},
34
.........
35
],
36
"total": 115,
37
"previous_page": "",
38
"next_page": 2,
39
"total_pages": 2,
40
"current_page": 1
41
}
42
}
Copied!
.
Last modified 1yr ago
Copy link