GET
/
merchants
/
bankAccounts
/
get
cURL
curl -X GET "https://api.onekhusa.com/sandbox/v1/merchants/bankAccounts/get?AccountId=1" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "accept: application/json" \
  --header "X-Organisation-Id: FYH0NTVW0DXK" \
  --header "X-Merchant-Account-Number: 35253486" \
  --header "Accept-Language: en"
{
  "merchantAccountNumber": 35253486,
  "accountId": 12,
  "accountName": "Test Account",
  "accountNumber": "114453647",
  "connectorId": 550044,
  "connectorName": "National Bank of Malawi",
  "isActive": true,
  "dateCreated": "2024-01-15T10:30:00Z",
  "dateCaptured": "2024-01-15T10:30:00Z",
  "capturedBy": "PBANDA",
  "dateModified": "2024-01-16T14:20:00Z",
  "modifiedBy": "NPHIRI"
}

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

ā€‹
AccountId
integer
required

The unique identifier of the bank account

Example:

1

Response

Success Response (200)

ā€‹
merchantAccountNumber
integer

The unique identifier of the merchant account

Example:

35253486

ā€‹
accountId
integer

The unique identifier of the bank account

Example:

12

ā€‹
accountName
string

The name of the bank account

Example:

"Test Account"

ā€‹
accountNumber
string

The bank account number

Example:

"114453647"

ā€‹
connectorId
integer

The unique identifier of the connector/payment provider. See Get Connectors for available connector IDs.

Example:

550044

ā€‹
connectorName
string

The name of the payment connector

Example:

"National Bank of Malawi"

ā€‹
isActive
boolean

Indicates whether the bank account is currently active

Example:

true

ā€‹
dateCreated
string<date-time>

The date and time when the bank account was created (ISO 8601)

Example:

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

ā€‹
dateCaptured
string<date-time>

The date and time when the bank account details were captured (ISO 8601)

Example:

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

ā€‹
capturedBy
string

The username or identifier of the user who captured the account

Example:

"PBANDA"

ā€‹
dateModified
string<date-time> | null

The date and time when the bank account was last modified (ISO 8601)

Example:

"2024-01-16T14:20:00Z"

ā€‹
modifiedBy
string | null

The username or identifier of the user who last modified the account

Example:

"NPHIRI"