GET
/
merchants
/
accounts
/
get
cURL
curl -X GET "https://api.onekhusa.com/sandbox/v1/merchants/accounts/get?merchantAccountNumber=35223486" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Accept-Language: en"
{
  "organisationId": "FYH0NTVW0DXK",
  "accountName": "KHUSA VILLAGE BANKS",
  "merchantAccountNumber": 35253486,
  "accountBalance": 10000000,
  "revenueAmount": 0,
  "currencyCode": "MWK",
  "levelNumber": 1,
  "levelName": "Initiator Only",
  "statusCode": "A",
  "statusName": "Active",
  "capturedBy": "admin@example.com",
  "dateCreated": "2024-01-15T10:30:00Z"
}

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

Query Parameters

ā€‹
merchantAccountNumber
string
required

Merchant account number to retrieve

Response

200 - application/json

Success Response (200)

ā€‹
organisationId
integer

Organization identifier

Example:

"FYH0NTVW0DXK"

ā€‹
accountName
string

Merchant account name

Example:

"KHUSA VILLAGE BANKS"

ā€‹
merchantAccountNumber
integer

Required string length: 8

Required range: 10000000 <= x <= 99999999
Example:

35253486

ā€‹
accountBalance
number<decimal>

Current account balance

Example:

10000000

ā€‹
revenueAmount
number<decimal>

Revenue amount for the merchant account

Example:

0

ā€‹
currencyCode
string

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

Example:

"MWK"

ā€‹
levelNumber
integer

Merchant authorization level

Example:

1

ā€‹
levelName
string

Human-readable level name

Example:

"Initiator Only"

ā€‹
statusCode
string

Account status code

Example:

"A"

ā€‹
statusName
string

Human-readable status name

Example:

"Active"

ā€‹
capturedBy
string

User who created the account

Example:

"admin@example.com"

ā€‹
dateCreated
string<date-time>

Account creation timestamp (ISO 8601)

Example:

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