POST
/
collections
/
getTransactions
cURL
curl -X POST "https://api.onekhusa.com/sandbox/v1/collections/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": 79967020,
    "transactionDate": "2025-09-05",
    "pageNumber": 1,
    "numberOfReturnedRows": 20,
    "isIncremental": true,
    "searchBy": "TransactionReferenceNumber",
    "searchText": "C250904VQ5MW"
  }'
[
  {
    "sourceCustomerName": "Joe Doe",
    "connectorName": "Airtel Money",
    "transactionAmount": 75000,
    "transactionFee": 1000,
    "currencyCode": "MWK",
    "transactionStatusCode": "S",
    "transactionStatusName": "Success",
    "transactionReferenceNumber": "D250713MGGGY",
    "transactionDate": "2024-01-15T10:30:00Z"
  },
  {
    "sourceCustomerName": "Grace Banda",
    "connectorName": "Airtel Money",
    "transactionAmount": 75000,
    "transactionFee": 1000,
    "currencyCode": "MWK",
    "transactionStatusCode": "S",
    "transactionStatusName": "Success",
    "transactionReferenceNumber": "B250713MGRTW",
    "transactionDate": "2024-01-15T09:15:00Z"
  }
]

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
Example:

79967020

ā€‹
transactionDate
string<date>
required

Date to filter transactions by (YYYY-MM-DD format)

Example:

"2025-09-05"

ā€‹
pageNumber
integer
required

Page number for pagination (must be ā‰„ 1)

Required range: x >= 1
Example:

1

ā€‹
numberOfReturnedRows
integer
required

Number of records per page (must be > 0)

Required range: x >= 1
Example:

20

ā€‹
isIncremental
boolean
required

Include previous pages (true) or current page only (false)

Example:

false

ā€‹
searchBy
enum<string>
required

Field to search by

Available options:
TransactionReferenceNumber,
SourceCustomerName,
Connector.ConnectorName,
SourceAccountNumber
Example:

"TransactionReferenceNumber"

ā€‹
searchText
string

Search term

Example:

"C250904VQ5MW"

Response

Success Response (200)

ā€‹
sourceCustomerName
string

Name of the source customer/payer

Example:

"Joe Doe"

ā€‹
connectorName
string

Name of the payment connector used

Example:

"Airtel Money"

ā€‹
transactionAmount
number

Total amount of the transaction

Example:

75000

ā€‹
transactionFee
number

The amount of transaction fee paid by the customer

Example:

1000

ā€‹
currencyCode
string

A three-letter ISO 4217 code that identifies the currency used in the transaction

Example:

"MWK"

ā€‹
transactionStatusCode
string

Status code of the transaction (e.g., 'S' for Success)

Example:

"S"

ā€‹
transactionStatusName
string

Human-readable status description

Example:

"Success"

ā€‹
transactionReferenceNumber
string

Unique reference number for the transaction

Example:

"D250713MGGGY"

ā€‹
transactionDate
string<date-time>

Date and time when the transaction was created

Example:

"2024-01-15T10:30:00Z"