List transactions
curl --request GET \
--url https://api.panoflow.io/v1/transactions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.panoflow.io/v1/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.panoflow.io/v1/transactions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"object": "list",
"data": [
{
"response_code": "09",
"response_message": "Request processing in progress",
"id": "txn_01JCKFR5NXF5E32DSDWR52C6X9",
"object": "transaction",
"created_at": "2026-10-28T08:00:00Z",
"updated_at": "2026-10-28T08:31:00Z",
"type": "payout",
"status": "processing",
"direction": "out",
"amount": {
"amount": 229745000,
"currency": "NGN"
},
"fee": null,
"account_id": "acc_01JCQF1Y99G6K6NSAK9M83PSW5",
"account_display_name": "Naira · Payroll",
"counterparty": {
"type": "pay_run",
"name": "October salaries · 11 people",
"bank_account": null,
"account_id": null,
"recipient_id": null
},
"description": "October salaries · 11 people",
"reference": "Bulk payout",
"source": {
"type": "pay_run",
"id": "run_01JC3F01BK3VK5ZHFXVTX5XQW5"
},
"initiated_by": {
"type": "user",
"id": "usr_01JCC3128TMRXGSNHYMZYCF4FZ",
"name": "Adaeze Okafor"
},
"approved_by": {
"type": "user",
"id": "usr_01JCCYD6WPX04EWRQ599Q9700T",
"name": "Tolu Martins"
},
"category": "Salaries",
"note": null,
"attachment_document_ids": [],
"failure": null,
"events": [
{
"type": "created",
"description": "Created by Adaeze Okafor",
"at": "2026-10-28T08:00:00Z",
"actor": {
"type": "user",
"id": "usr_01JCC3128TMRXGSNHYMZYCF4FZ",
"name": "Adaeze Okafor"
}
},
{
"type": "approved",
"description": "Approved by Tolu Martins",
"at": "2026-10-28T08:20:00Z",
"actor": {
"type": "user",
"id": "usr_01JCCYD6WPX04EWRQ599Q9700T",
"name": "Tolu Martins"
}
},
{
"type": "sent",
"description": "Sent to the receiving banks",
"at": "2026-10-28T08:31:00Z",
"actor": null
}
],
"nip_session_id": null,
"completed_at": null,
"livemode": true
},
{
"response_code": "00",
"response_message": "Approved or completed successfully",
"id": "txn_01JC31CVY7B6Y8XTZW3AEMMED3",
"object": "transaction",
"created_at": "2026-10-27T08:41:00Z",
"updated_at": "2026-10-27T08:41:00Z",
"type": "collection",
"status": "completed",
"direction": "in",
"amount": {
"amount": 125000000,
"currency": "NGN"
},
"fee": null,
"account_id": "acc_01JCNND0RKATSR2MYBK8VQ3468",
"account_display_name": "Naira · Main",
"counterparty": {
"type": "bank_account",
"name": "Kano Freight Services",
"bank_account": {
"account_number": "0123984471",
"bank_code": "058",
"bank_name": "GTBank",
"account_name": "KANO FREIGHT SERVICES LTD"
},
"account_id": null,
"recipient_id": null
},
"description": "Kano Freight Services",
"reference": "INV-0142",
"source": {
"type": "invoice",
"id": "ivc_01JCFK328EG017P1145YK913EH"
},
"initiated_by": null,
"approved_by": null,
"category": "Sales",
"note": null,
"attachment_document_ids": [],
"failure": null,
"events": [
{
"type": "received",
"description": "Received",
"at": "2026-10-27T08:41:00Z",
"actor": null
},
{
"type": "matched",
"description": "Recorded against INV-0142",
"at": "2026-10-27T08:41:00Z",
"actor": null
},
{
"type": "completed",
"description": "Settled",
"at": "2026-10-27T08:41:00Z",
"actor": null
}
],
"nip_session_id": "000013261027094100123984471881",
"completed_at": "2026-10-27T08:41:00Z",
"livemode": true
},
{
"response_code": "00",
"response_message": "Approved or completed successfully",
"id": "txn_01JC99Y651CH732QS0JYGWR759",
"object": "transaction",
"created_at": "2026-10-27T07:15:00Z",
"updated_at": "2026-10-27T07:15:00Z",
"type": "transfer",
"status": "completed",
"direction": "internal",
"amount": {
"amount": 240000000,
"currency": "NGN"
},
"fee": null,
"account_id": "acc_01JCNND0RKATSR2MYBK8VQ3468",
"account_display_name": "Naira · Main",
"counterparty": {
"type": "own_account",
"name": "Naira · Payroll",
"bank_account": null,
"account_id": "acc_01JCQF1Y99G6K6NSAK9M83PSW5",
"recipient_id": null
},
"description": "Naira · Main to Naira · Payroll",
"reference": "Own accounts",
"source": {
"type": "transfer",
"id": "trf_01JC71GSH285W3WGDCD827WR1H"
},
"initiated_by": {
"type": "user",
"id": "usr_01JCC3128TMRXGSNHYMZYCF4FZ",
"name": "Adaeze Okafor"
},
"approved_by": null,
"category": null,
"note": null,
"attachment_document_ids": [],
"failure": null,
"events": [
{
"type": "created",
"description": "Created by Adaeze Okafor",
"at": "2026-10-27T07:15:00Z",
"actor": {
"type": "user",
"id": "usr_01JCC3128TMRXGSNHYMZYCF4FZ",
"name": "Adaeze Okafor"
}
},
{
"type": "completed",
"description": "Settled",
"at": "2026-10-27T07:15:00Z",
"actor": null
}
],
"nip_session_id": null,
"completed_at": "2026-10-27T07:15:00Z",
"livemode": true
},
{
"response_code": "00",
"response_message": "Approved or completed successfully",
"id": "txn_01JCHS5CC3TEEQV903RVCV0YEW",
"object": "transaction",
"created_at": "2026-10-25T15:48:00Z",
"updated_at": "2026-10-25T15:48:40Z",
"type": "payout",
"status": "completed",
"direction": "out",
"amount": {
"amount": 60000000,
"currency": "NGN"
},
"fee": {
"amount": 5375,
"currency": "NGN"
},
"account_id": "acc_01JCNND0RKATSR2MYBK8VQ3468",
"account_display_name": "Naira · Main",
"counterparty": {
"type": "bank_account",
"name": "Total Energies",
"bank_account": {
"account_number": "1013377920",
"bank_code": "057",
"bank_name": "Zenith Bank",
"account_name": "TOTAL ENERGIES MARKETING NIG PLC"
},
"account_id": null,
"recipient_id": null
},
"description": "Total Energies",
"reference": "Diesel supply",
"source": {
"type": "transfer",
"id": "trf_01JCDCEKM598BSNK9886DFRC60"
},
"initiated_by": {
"type": "user",
"id": "usr_01JCQ5P8YZWNBVQ8HSK8N67DHE",
"name": "Tunde Bakare"
},
"approved_by": null,
"category": "Fuel",
"note": null,
"attachment_document_ids": [],
"failure": null,
"events": [
{
"type": "created",
"description": "Created by Tunde Bakare",
"at": "2026-10-25T15:48:00Z",
"actor": {
"type": "user",
"id": "usr_01JCQ5P8YZWNBVQ8HSK8N67DHE",
"name": "Tunde Bakare"
}
},
{
"type": "sent",
"description": "Sent to the receiving bank",
"at": "2026-10-25T15:48:10Z",
"actor": null
},
{
"type": "completed",
"description": "Settled",
"at": "2026-10-25T15:48:40Z",
"actor": null
}
],
"nip_session_id": "000013261025164810101337792042",
"completed_at": "2026-10-25T15:48:40Z",
"livemode": true
},
{
"response_code": "07",
"response_message": "Invalid account",
"id": "txn_01JCN79G430A3WHT69SZ7MJBBG",
"object": "transaction",
"created_at": "2026-10-25T09:02:00Z",
"updated_at": "2026-10-25T09:41:00Z",
"type": "payout",
"status": "failed",
"direction": "out",
"amount": {
"amount": 15000000,
"currency": "NGN"
},
"fee": null,
"account_id": "acc_01JCNND0RKATSR2MYBK8VQ3468",
"account_display_name": "Naira · Main",
"counterparty": {
"type": "bank_account",
"name": "Chidi Eze",
"bank_account": {
"account_number": "3089912245",
"bank_code": "011",
"bank_name": "First Bank",
"account_name": "EZE CHIDI JOHN"
},
"account_id": null,
"recipient_id": null
},
"description": "Chidi Eze",
"reference": "Lagos dispatch",
"source": {
"type": "transfer",
"id": "trf_01JCG8D76RRAG1B7KPS05S5KR2"
},
"initiated_by": {
"type": "user",
"id": "usr_01JC85CBTESY1N92X9NGAQ954H",
"name": "Ngozi Uche"
},
"approved_by": null,
"category": "Contractors",
"note": null,
"attachment_document_ids": [],
"failure": {
"code": "account_name_mismatch",
"message": "The receiving bank rejected the payment: account number and name don't match. The money is back in Naira · Main."
},
"events": [
{
"type": "created",
"description": "Created by Ngozi Uche",
"at": "2026-10-25T09:02:00Z",
"actor": {
"type": "user",
"id": "usr_01JC85CBTESY1N92X9NGAQ954H",
"name": "Ngozi Uche"
}
},
{
"type": "sent",
"description": "Sent to the receiving bank",
"at": "2026-10-25T09:03:00Z",
"actor": null
},
{
"type": "failed",
"description": "Rejected, money returned",
"at": "2026-10-25T09:41:00Z",
"actor": null
}
],
"nip_session_id": "000013261025100300308991224577",
"completed_at": null,
"livemode": true
}
],
"has_more": true,
"next_cursor": "txn_01JCN79G430A3WHT69SZ7MJBBG"
}{
"error": {
"response_code": "00",
"type": "invalid_request",
"code": "invalid_json",
"message": "<string>",
"request_id": "<string>",
"param": "<string>",
"doc_url": "<string>",
"details": {}
}
}{
"error": {
"response_code": "00",
"type": "invalid_request",
"code": "invalid_json",
"message": "<string>",
"request_id": "<string>",
"param": "<string>",
"doc_url": "<string>",
"details": {}
}
}{
"error": {
"response_code": "00",
"type": "invalid_request",
"code": "invalid_json",
"message": "<string>",
"request_id": "<string>",
"param": "<string>",
"doc_url": "<string>",
"details": {}
}
}{
"error": {
"response_code": "00",
"type": "invalid_request",
"code": "invalid_json",
"message": "<string>",
"request_id": "<string>",
"param": "<string>",
"doc_url": "<string>",
"details": {}
}
}{
"error": {
"response_code": "00",
"type": "invalid_request",
"code": "invalid_json",
"message": "<string>",
"request_id": "<string>",
"param": "<string>",
"doc_url": "<string>",
"details": {}
}
}Transactions
List transactions
AppTransactions, account Activity and Home “Recent transactions”. Newest first. account_id matches the debited or credited account and,
for internal moves, either side. Type tabs: All, Payouts, Collections, Transfers. “Needs attention” counts come from status=failed / status=processing
with include=total_count. “Export CSV”: send Accept: text/csv with the same filters (up to 10,000 rows; use statements for more).
Error codes: invalid_api_key, parameter_invalid, rate_limited.
GET
/
transactions
List transactions
curl --request GET \
--url https://api.panoflow.io/v1/transactions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.panoflow.io/v1/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.panoflow.io/v1/transactions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"object": "list",
"data": [
{
"response_code": "09",
"response_message": "Request processing in progress",
"id": "txn_01JCKFR5NXF5E32DSDWR52C6X9",
"object": "transaction",
"created_at": "2026-10-28T08:00:00Z",
"updated_at": "2026-10-28T08:31:00Z",
"type": "payout",
"status": "processing",
"direction": "out",
"amount": {
"amount": 229745000,
"currency": "NGN"
},
"fee": null,
"account_id": "acc_01JCQF1Y99G6K6NSAK9M83PSW5",
"account_display_name": "Naira · Payroll",
"counterparty": {
"type": "pay_run",
"name": "October salaries · 11 people",
"bank_account": null,
"account_id": null,
"recipient_id": null
},
"description": "October salaries · 11 people",
"reference": "Bulk payout",
"source": {
"type": "pay_run",
"id": "run_01JC3F01BK3VK5ZHFXVTX5XQW5"
},
"initiated_by": {
"type": "user",
"id": "usr_01JCC3128TMRXGSNHYMZYCF4FZ",
"name": "Adaeze Okafor"
},
"approved_by": {
"type": "user",
"id": "usr_01JCCYD6WPX04EWRQ599Q9700T",
"name": "Tolu Martins"
},
"category": "Salaries",
"note": null,
"attachment_document_ids": [],
"failure": null,
"events": [
{
"type": "created",
"description": "Created by Adaeze Okafor",
"at": "2026-10-28T08:00:00Z",
"actor": {
"type": "user",
"id": "usr_01JCC3128TMRXGSNHYMZYCF4FZ",
"name": "Adaeze Okafor"
}
},
{
"type": "approved",
"description": "Approved by Tolu Martins",
"at": "2026-10-28T08:20:00Z",
"actor": {
"type": "user",
"id": "usr_01JCCYD6WPX04EWRQ599Q9700T",
"name": "Tolu Martins"
}
},
{
"type": "sent",
"description": "Sent to the receiving banks",
"at": "2026-10-28T08:31:00Z",
"actor": null
}
],
"nip_session_id": null,
"completed_at": null,
"livemode": true
},
{
"response_code": "00",
"response_message": "Approved or completed successfully",
"id": "txn_01JC31CVY7B6Y8XTZW3AEMMED3",
"object": "transaction",
"created_at": "2026-10-27T08:41:00Z",
"updated_at": "2026-10-27T08:41:00Z",
"type": "collection",
"status": "completed",
"direction": "in",
"amount": {
"amount": 125000000,
"currency": "NGN"
},
"fee": null,
"account_id": "acc_01JCNND0RKATSR2MYBK8VQ3468",
"account_display_name": "Naira · Main",
"counterparty": {
"type": "bank_account",
"name": "Kano Freight Services",
"bank_account": {
"account_number": "0123984471",
"bank_code": "058",
"bank_name": "GTBank",
"account_name": "KANO FREIGHT SERVICES LTD"
},
"account_id": null,
"recipient_id": null
},
"description": "Kano Freight Services",
"reference": "INV-0142",
"source": {
"type": "invoice",
"id": "ivc_01JCFK328EG017P1145YK913EH"
},
"initiated_by": null,
"approved_by": null,
"category": "Sales",
"note": null,
"attachment_document_ids": [],
"failure": null,
"events": [
{
"type": "received",
"description": "Received",
"at": "2026-10-27T08:41:00Z",
"actor": null
},
{
"type": "matched",
"description": "Recorded against INV-0142",
"at": "2026-10-27T08:41:00Z",
"actor": null
},
{
"type": "completed",
"description": "Settled",
"at": "2026-10-27T08:41:00Z",
"actor": null
}
],
"nip_session_id": "000013261027094100123984471881",
"completed_at": "2026-10-27T08:41:00Z",
"livemode": true
},
{
"response_code": "00",
"response_message": "Approved or completed successfully",
"id": "txn_01JC99Y651CH732QS0JYGWR759",
"object": "transaction",
"created_at": "2026-10-27T07:15:00Z",
"updated_at": "2026-10-27T07:15:00Z",
"type": "transfer",
"status": "completed",
"direction": "internal",
"amount": {
"amount": 240000000,
"currency": "NGN"
},
"fee": null,
"account_id": "acc_01JCNND0RKATSR2MYBK8VQ3468",
"account_display_name": "Naira · Main",
"counterparty": {
"type": "own_account",
"name": "Naira · Payroll",
"bank_account": null,
"account_id": "acc_01JCQF1Y99G6K6NSAK9M83PSW5",
"recipient_id": null
},
"description": "Naira · Main to Naira · Payroll",
"reference": "Own accounts",
"source": {
"type": "transfer",
"id": "trf_01JC71GSH285W3WGDCD827WR1H"
},
"initiated_by": {
"type": "user",
"id": "usr_01JCC3128TMRXGSNHYMZYCF4FZ",
"name": "Adaeze Okafor"
},
"approved_by": null,
"category": null,
"note": null,
"attachment_document_ids": [],
"failure": null,
"events": [
{
"type": "created",
"description": "Created by Adaeze Okafor",
"at": "2026-10-27T07:15:00Z",
"actor": {
"type": "user",
"id": "usr_01JCC3128TMRXGSNHYMZYCF4FZ",
"name": "Adaeze Okafor"
}
},
{
"type": "completed",
"description": "Settled",
"at": "2026-10-27T07:15:00Z",
"actor": null
}
],
"nip_session_id": null,
"completed_at": "2026-10-27T07:15:00Z",
"livemode": true
},
{
"response_code": "00",
"response_message": "Approved or completed successfully",
"id": "txn_01JCHS5CC3TEEQV903RVCV0YEW",
"object": "transaction",
"created_at": "2026-10-25T15:48:00Z",
"updated_at": "2026-10-25T15:48:40Z",
"type": "payout",
"status": "completed",
"direction": "out",
"amount": {
"amount": 60000000,
"currency": "NGN"
},
"fee": {
"amount": 5375,
"currency": "NGN"
},
"account_id": "acc_01JCNND0RKATSR2MYBK8VQ3468",
"account_display_name": "Naira · Main",
"counterparty": {
"type": "bank_account",
"name": "Total Energies",
"bank_account": {
"account_number": "1013377920",
"bank_code": "057",
"bank_name": "Zenith Bank",
"account_name": "TOTAL ENERGIES MARKETING NIG PLC"
},
"account_id": null,
"recipient_id": null
},
"description": "Total Energies",
"reference": "Diesel supply",
"source": {
"type": "transfer",
"id": "trf_01JCDCEKM598BSNK9886DFRC60"
},
"initiated_by": {
"type": "user",
"id": "usr_01JCQ5P8YZWNBVQ8HSK8N67DHE",
"name": "Tunde Bakare"
},
"approved_by": null,
"category": "Fuel",
"note": null,
"attachment_document_ids": [],
"failure": null,
"events": [
{
"type": "created",
"description": "Created by Tunde Bakare",
"at": "2026-10-25T15:48:00Z",
"actor": {
"type": "user",
"id": "usr_01JCQ5P8YZWNBVQ8HSK8N67DHE",
"name": "Tunde Bakare"
}
},
{
"type": "sent",
"description": "Sent to the receiving bank",
"at": "2026-10-25T15:48:10Z",
"actor": null
},
{
"type": "completed",
"description": "Settled",
"at": "2026-10-25T15:48:40Z",
"actor": null
}
],
"nip_session_id": "000013261025164810101337792042",
"completed_at": "2026-10-25T15:48:40Z",
"livemode": true
},
{
"response_code": "07",
"response_message": "Invalid account",
"id": "txn_01JCN79G430A3WHT69SZ7MJBBG",
"object": "transaction",
"created_at": "2026-10-25T09:02:00Z",
"updated_at": "2026-10-25T09:41:00Z",
"type": "payout",
"status": "failed",
"direction": "out",
"amount": {
"amount": 15000000,
"currency": "NGN"
},
"fee": null,
"account_id": "acc_01JCNND0RKATSR2MYBK8VQ3468",
"account_display_name": "Naira · Main",
"counterparty": {
"type": "bank_account",
"name": "Chidi Eze",
"bank_account": {
"account_number": "3089912245",
"bank_code": "011",
"bank_name": "First Bank",
"account_name": "EZE CHIDI JOHN"
},
"account_id": null,
"recipient_id": null
},
"description": "Chidi Eze",
"reference": "Lagos dispatch",
"source": {
"type": "transfer",
"id": "trf_01JCG8D76RRAG1B7KPS05S5KR2"
},
"initiated_by": {
"type": "user",
"id": "usr_01JC85CBTESY1N92X9NGAQ954H",
"name": "Ngozi Uche"
},
"approved_by": null,
"category": "Contractors",
"note": null,
"attachment_document_ids": [],
"failure": {
"code": "account_name_mismatch",
"message": "The receiving bank rejected the payment: account number and name don't match. The money is back in Naira · Main."
},
"events": [
{
"type": "created",
"description": "Created by Ngozi Uche",
"at": "2026-10-25T09:02:00Z",
"actor": {
"type": "user",
"id": "usr_01JC85CBTESY1N92X9NGAQ954H",
"name": "Ngozi Uche"
}
},
{
"type": "sent",
"description": "Sent to the receiving bank",
"at": "2026-10-25T09:03:00Z",
"actor": null
},
{
"type": "failed",
"description": "Rejected, money returned",
"at": "2026-10-25T09:41:00Z",
"actor": null
}
],
"nip_session_id": "000013261025100300308991224577",
"completed_at": null,
"livemode": true
}
],
"has_more": true,
"next_cursor": "txn_01JCN79G430A3WHT69SZ7MJBBG"
}{
"error": {
"response_code": "00",
"type": "invalid_request",
"code": "invalid_json",
"message": "<string>",
"request_id": "<string>",
"param": "<string>",
"doc_url": "<string>",
"details": {}
}
}{
"error": {
"response_code": "00",
"type": "invalid_request",
"code": "invalid_json",
"message": "<string>",
"request_id": "<string>",
"param": "<string>",
"doc_url": "<string>",
"details": {}
}
}{
"error": {
"response_code": "00",
"type": "invalid_request",
"code": "invalid_json",
"message": "<string>",
"request_id": "<string>",
"param": "<string>",
"doc_url": "<string>",
"details": {}
}
}{
"error": {
"response_code": "00",
"type": "invalid_request",
"code": "invalid_json",
"message": "<string>",
"request_id": "<string>",
"param": "<string>",
"doc_url": "<string>",
"details": {}
}
}{
"error": {
"response_code": "00",
"type": "invalid_request",
"code": "invalid_json",
"message": "<string>",
"request_id": "<string>",
"param": "<string>",
"doc_url": "<string>",
"details": {}
}
}Authorizations
ApiKeyOAuth2
Server API key, scoped. pk_test_ keys hit the sandbox tenant.
Headers
Optional client correlation id, up to 128 characters. It is not echoed: the response's X-Request-Id is always
our own req_… id. We log your value with the request as client_request_id, so support can find a request by
either id. A longer value is refused with 400 parameter_invalid.
Maximum string length:
128Query Parameters
Page size, 1–100.
Required range:
1 <= x <= 100Cursor from the previous page's next_cursor. Returns older items. Don't send with before.
Cursor for the reverse direction: returns the items newer than this one. The page is still sorted newest first;
has_more and next_cursor then continue in the same (newer) direction, so pass next_cursor as before to
keep paging towards the newest items. Don't send with after.
Comma-separated account ids.
Comma-separated transaction types.
Comma-separated statuses.
Money in, out or between own accounts.
Available options:
in, out, internal Only items created at or after this time.
Only items created at or before this time.
Minimum amount in minor units.
Required range:
x >= 0Maximum amount in minor units.
Required range:
x >= 0Exact category.
Maximum string length:
40Transactions of one source object (a batch, pay run, invoice, ...).
Sandbox (false) or live (true) data. Defaults to the session's mode.
Free-text search.
Maximum string length:
200Set to total_count to add total_count to the list response.
Available options:
total_count Response
OK.
Transactions.
Allowed value:
"list"Items, newest first.
Show child attributes
Show child attributes
True when another page exists.
Cursor for the next page in the same direction: pass it as after if this page was read with after (or no cursor), as before if it was read with before. Null when has_more is false.
Only when include=total_count was sent.