Get Merchants

cURL

curl -X POST "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Content-Type: application/json" \
  --header "Accept-Language: en" \
  -d '{
    "organisationId": "FYH0NTVW0DXK",
    "pageNumber": 1,
    "numberOfReturnedRows": 10,
    "isIncremental": false,
    "searchBy": "AccountName",
    "searchText": "John Phiri"
  }'

import requests

url = "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll"

payload = {
    "organisationId": "FYH0NTVW0DXK",
    "pageNumber": 1,
    "numberOfReturnedRows": 10,
    "isIncremental": False,
    "searchBy": "AccountName",
    "searchText": "John Phiri"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    organisationId: 'FYH0NTVW0DXK',
    pageNumber: 1,
    numberOfReturnedRows: 10,
    isIncremental: false,
    searchBy: 'AccountName',
    searchText: 'John Phiri'
  })
};

fetch('https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'organisationId' => 'FYH0NTVW0DXK',
    'pageNumber' => 1,
    'numberOfReturnedRows' => 10,
    'isIncremental' => false,
    'searchBy' => 'AccountName',
    'searchText' => 'John Phiri'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll"

	payload := strings.NewReader("{\n  \"organisationId\": \"FYH0NTVW0DXK\",\n  \"pageNumber\": 1,\n  \"numberOfReturnedRows\": 10,\n  \"isIncremental\": false,\n  \"searchBy\": \"AccountName\",\n  \"searchText\": \"John Phiri\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"organisationId\": \"FYH0NTVW0DXK\",\n  \"pageNumber\": 1,\n  \"numberOfReturnedRows\": 10,\n  \"isIncremental\": false,\n  \"searchBy\": \"AccountName\",\n  \"searchText\": \"John Phiri\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"organisationId\": \"FYH0NTVW0DXK\",\n  \"pageNumber\": 1,\n  \"numberOfReturnedRows\": 10,\n  \"isIncremental\": false,\n  \"searchBy\": \"AccountName\",\n  \"searchText\": \"John Phiri\"\n}"

response = http.request(request)
puts response.read_body

[
  {
    "accountName": "SkyLink Aviation Services",
    "currencyCode": "MWK",
    "categoryCode": "AVI",
    "categoryName": "Aviation",
    "postalAddress": "P.O. Box 30245, Lilongwe, Malawi",
    "organisationId": "FYH0NTVW0DXK",
    "levelNumber": 3,
    "levelName": "Initiator -> Approver",
    "capturedBy": "admin@example.com",
    "merchantAccountNumber": 35253486,
    "classificationCode": "SME",
    "classificationName": "Small to Medium Enterprise",
    "collectionFeeRuleCode": "CC",
    "collectionFeeRuleName": "Charge Fees To The Customer",
    "disbursementFeeRuleCode": "CM",
    "disbursementFeeRuleName": "Charge Fees To The Merchant",
    "accountBalance": 1250000,
    "revenueAmount": 18500,
    "statusCode": "A",
    "statusName": "Active",
    "dateCreated": "2026-07-09T08:45:27.583Z"
  }
]

POST

merchants

accounts

getAll

cURL

curl -X POST "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Content-Type: application/json" \
  --header "Accept-Language: en" \
  -d '{
    "organisationId": "FYH0NTVW0DXK",
    "pageNumber": 1,
    "numberOfReturnedRows": 10,
    "isIncremental": false,
    "searchBy": "AccountName",
    "searchText": "John Phiri"
  }'

import requests

url = "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll"

payload = {
    "organisationId": "FYH0NTVW0DXK",
    "pageNumber": 1,
    "numberOfReturnedRows": 10,
    "isIncremental": False,
    "searchBy": "AccountName",
    "searchText": "John Phiri"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    organisationId: 'FYH0NTVW0DXK',
    pageNumber: 1,
    numberOfReturnedRows: 10,
    isIncremental: false,
    searchBy: 'AccountName',
    searchText: 'John Phiri'
  })
};

fetch('https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'organisationId' => 'FYH0NTVW0DXK',
    'pageNumber' => 1,
    'numberOfReturnedRows' => 10,
    'isIncremental' => false,
    'searchBy' => 'AccountName',
    'searchText' => 'John Phiri'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll"

	payload := strings.NewReader("{\n  \"organisationId\": \"FYH0NTVW0DXK\",\n  \"pageNumber\": 1,\n  \"numberOfReturnedRows\": 10,\n  \"isIncremental\": false,\n  \"searchBy\": \"AccountName\",\n  \"searchText\": \"John Phiri\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"organisationId\": \"FYH0NTVW0DXK\",\n  \"pageNumber\": 1,\n  \"numberOfReturnedRows\": 10,\n  \"isIncremental\": false,\n  \"searchBy\": \"AccountName\",\n  \"searchText\": \"John Phiri\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/getAll")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"organisationId\": \"FYH0NTVW0DXK\",\n  \"pageNumber\": 1,\n  \"numberOfReturnedRows\": 10,\n  \"isIncremental\": false,\n  \"searchBy\": \"AccountName\",\n  \"searchText\": \"John Phiri\"\n}"

response = http.request(request)
puts response.read_body

[
  {
    "accountName": "SkyLink Aviation Services",
    "currencyCode": "MWK",
    "categoryCode": "AVI",
    "categoryName": "Aviation",
    "postalAddress": "P.O. Box 30245, Lilongwe, Malawi",
    "organisationId": "FYH0NTVW0DXK",
    "levelNumber": 3,
    "levelName": "Initiator -> Approver",
    "capturedBy": "admin@example.com",
    "merchantAccountNumber": 35253486,
    "classificationCode": "SME",
    "classificationName": "Small to Medium Enterprise",
    "collectionFeeRuleCode": "CC",
    "collectionFeeRuleName": "Charge Fees To The Customer",
    "disbursementFeeRuleCode": "CM",
    "disbursementFeeRuleName": "Charge Fees To The Merchant",
    "accountBalance": 1250000,
    "revenueAmount": 18500,
    "statusCode": "A",
    "statusName": "Active",
    "dateCreated": "2026-07-09T08:45:27.583Z"
  }
]

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer Token, Where accessToken is the access token used to authenticate the request.

Headers

Accept-Language

string

default:en

Preferred language for the response

Body

application/json

organisationId

string

required

The unique identifier of your organisation

Required string length: 12

Example:

"ORG123456789"

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:

10

isIncremental

boolean

default:false

Include previous pages data (default: false)

Example:

false

searchBy

enum<string>

default:AccountName

Field to search by (default: "AccountName", allowed: ["AccountName"])

Available options:

AccountName

Example:

"AccountName"

searchText

string

Search term (case-insensitive, optional)

Example:

"John Phiri"

Response

200 - application/json

Success Response (200)

accountName

string

The name of the merchant account

Example:

"SkyLink Aviation Services"

currencyCode

string

The currency code for the merchant (e.g., "MWK")

Example:

"MWK"

categoryCode

string

The category a merchant account belongs to i.e. Aviation

Example:

"AVI"

categoryName

string

The name qualifying the category code

Example:

"Aviation"

postalAddress

string

The postal address of the merchant

Example:

"P.O. Box 30245, Lilongwe, Malawi"

organisationId

string

The unique identifier of the organization

Example:

"FYH0NTVW0DXK"

levelNumber

integer

The level number for the merchant. See Get Authorization Levels for available levels.

Example:

3

levelName

string

Human-readable level name

Example:

"Initiator -> Approver"

capturedBy

string

Email address of the user creating the merchant

Example:

"admin@example.com"

merchantAccountNumber

integer

The unique identifier of the merchant account

Example:

35253486

classificationCode

string

The code assigned to merchant classification.

Example:

"SME"

classificationName

string

The name qualifying the classification code

Example:

"Small to Medium Enterprise"

collectionFeeRuleCode

string

The rule code to apply when charging the transaction fee on collection payment whether should be borne by the merchant or customer

Example:

"CC"

collectionFeeRuleName

string

The description qualifying the rule code

Example:

"Charge Fees To The Customer"

disbursementFeeRuleCode

string

The rule code to apply when charging the transaction fee on disbursement (payout) payment whether should be borne by the merchant or customer

Example:

"CM"

disbursementFeeRuleName

string

The description qualifying the rule code

Example:

"Charge Fees To The Merchant"

accountBalance

number<decimal>

Current account balance

Example:

1250000

revenueAmount

number<decimal>

Revenue amount for the merchant account

Example:

18500

statusCode

string

Account status code

Example:

"A"

statusName

string

Human-readable status name

Example:

"Active"

dateCreated

string<date-time>

Account creation timestamp (ISO 8601)

Example:

"2026-07-09T08:45:27.583Z"

Getting Started

Accept Payments

Disbursements

Bill Payments

Merchants

Disputes

Security

Supporting APIs

Authorizations

Headers

Body

Response