GET
/
merchants
/
accounts
/
getStatusChanges
cURL
curl -X GET "https://api.onekhusa.com/sandbox/v1/merchants/accounts/getStatusChanges?MerchantAccountNumber=35253486" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "X-Organisation-Id: FYH0NTVW0DXK" \
  --header "X-Merchant-Account-Number: 35253486" \
  --header "Accept-Language: en"
[
  {
    "capturedBy": "PBANDA",
    "statusName": "Active",
    "dateCreated": "2024-01-15T10:30:00Z",
    "comments": "Merchant account activated after compliance review",
    "reasonDescription": "Compliance Review Complete"
  },
  {
    "capturedBy": "NPHIRI",
    "statusName": "Suspended",
    "dateCreated": "2024-01-10T14:20:00Z",
    "comments": "Suspended pending documentation",
    "reasonDescription": "Pending Documentation"
  },
  {
    "capturedBy": "PBANDA",
    "statusName": "Active",
    "dateCreated": "2024-01-01T09:00:00Z",
    "comments": "Initial merchant activation",
    "reasonDescription": "New Merchant Activation"
  }
]

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

Query Parameters

ā€‹
MerchantAccountNumber
integer
required

The unique identifier of the merchant account

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

35253486

Response

Success Response (200)

ā€‹
capturedBy
string
required

The username or identifier of the user who made the status change

Example:

"PBANDA"

ā€‹
statusName
string
required

The name/description of the status that was set (e.g., "Active", "Suspended", "Blacklisted")

Example:

"Active"

ā€‹
dateCreated
string<date-time>
required

The date and time when the status change occurred (ISO 8601)

Example:

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

ā€‹
comments
string
required

Additional comments or notes provided with the status change

Example:

"Merchant account activated after compliance review"

ā€‹
reasonDescription
string
required

The description of the reason category used for this status change

Example:

"Compliance Review Complete"