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 "Accept-Language: en" \
      -d '{
        "merchantAccountNumber": 35253486,
        "batchNumber": 123456,
        "pageNumber": 1,
        "numberOfReturnedRows": 20,
        "isIncremental": true,
        "searchBy": "BeneficiaryName",
        "searchText": "John"
         }'
{
  "message": [
    {
      "batchNumber": 123456,
      "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": 123456,
      "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 , where is your access token.

Headers

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
batchNumber
integer
required

Identifier of the batch to retrieve transactions for

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[]