POST
/
disbursements
/
batch
/
getTransactions
cURL
curl -X POST "https://api.onekhusa.com/sandbox/v1/disbursements/batch/getTransactions" \
      --header "Authorization: Bearer your-jwt-token" \
      --header "Content-Type: application/json" \
      --header "X-Organisation-Id: FYH0NTVW0DXK" \
      --header "X-Merchant-Account-Number: 35253486" \
      --header "Accept-Language: en" \
      -d '{
        "merchantAccountNumber": 35253486,
        "pageNumber": 1,
        "numberOfReturnedRows": 20,
        "isIncremental": true,
        "searchBy": "BeneficiaryName",
        "searchText": "John"
         }'
[
  {
    "batchNumber": 52418521,
    "transactionReferenceNumber": "250926JL5ZRO",
    "beneficiaryName": "JOHN PHIRI",
    "connectorName": "National Bank of Malawi",
    "beneficiaryAccountNumber": "002125456",
    "transactionDescription": "MTUKULA PAKHOMO FOR APR2025",
    "transactionAmount": 50000,
    "transactionStatusCode": "S",
    "transactionStatusName": "Successful",
    "currencyCode": "MWK"
  },
  {
    "batchNumber": 52418521,
    "transactionReferenceNumber": "25092631JFIW",
    "beneficiaryName": "SUSAN KAPONDA",
    "connectorName": "National Bank of Malawi",
    "beneficiaryAccountNumber": "002125457",
    "transactionDescription": "MTUKULA PAKHOMO FOR APR2025",
    "transactionAmount": 50000,
    "transactionStatusCode": "S",
    "transactionStatusName": "Successful",
    "currencyCode": "MWK"
  }
]

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <Token>, where <Token> is your access token.

Headers

X-Organisation-Id
string
required

The organization identifier

X-Merchant-Account-Number
string
required

The merchant account number

Accept-Language
string
default:en

Preferred language for the response

Body

application/json
merchantAccountNumber
integer
required

Required string length: 8

Required range: 10000000 <= x <= 99999999
pageNumber
integer
required

Page number for pagination (starts from 1)

numberOfReturnedRows
integer
required

Number of records per page

isIncremental
boolean
required

If true, includes previous pages; if false, only current page

searchBy
string
required

Field to search by (BeneficiaryName, BeneficiaryAccountNumber, TransactionReferenceNumber, SourceReferenceNumber)

searchText
string

Text to search for (case-insensitive)

statusFilter
string

Filter by transaction status

Response

Success Response (200)

message
object[]