Get Accounts

Retrieve a list of all accounts associated with the authenticated merchant.

When to Use

▾

Use this endpoint when:

• You need to display all settlement accounts in your dashboard
• Auditing accounts registered to a merchant
• Looking up an account id before calling Get Account By ID

How to Use

▾

Endpoint

GET/v3/accounts

Step 1: Authenticate

▾

Obtain a valid accessToken for the merchant.

Step 2: Send the GET Request

▾

No request body or query parameters required.

Step 3: Iterate the Items

▾

The response items array contains each account's full record. The meta object may include pagination details.

---

Request Parameters

▾

No request body. Authenticated headers only.

---

Response Parameters

▾

itemARRAY

idSTRING

Account ID

Example: "1653895399283266156"

merchantIdSTRING

Merchant ID

Example: "4118165203679668885"

isDefaultBOOLEAN

Example: true

companyNameSTRING

Company name of merchant

Example: "REVENUE MONSTER"

companyTypeSTRING

Type of company incorporation

Example: "SOLE PROPRIETOR"

registrationNumberSTRING

Registration number of merchant

Example: “12344”

businessCategorySTRING

Business category of merchant

Example: "SOFTWARE AND IT"

businessScopeSTRING

Business scope of merchant

Example: "SOFTWARE AND IT"

sourceOfFundsSTRING

Source of funds of merchant

Example: "BUSINESS REVENUE"

customerOriginSTRING

Customer origin of merchant

Example: "DOMESTIC"

establishedAtDATETIME

Established date time of merchant

Example: "2018-03-26T04:50:57Z"

countryCodeSTRING

Country code of merchant contact number

Example: "60"

phoneNumberSTRING

Phone number of merchant

Example: "377334080"

addressLine1STRING

Address 1 of merchant

Example: "20, JALAN JASA 38, TAMAN MUTIARA RINI"

addressLine2STRING

Address 2 of merchant

Example: ""

postcodeSTRING

Postcode of merchant

Example: “81300”

citySTRING

City of merchant

Example: "Selangor"

stateSTRING

State of merchant

Example: "Selangor"

countrySTRING

Country of merchant

Example: "Malaysia"

isSameBusinessAddressBOOLEAN

Example: false

invoiceAddressOBJECT

Object of Invoice Address

addressLine1STRING

AddressLine1

Example: ""

addressLine2STRING

AddressLine2

Example: ""

postCodeSTRING

PostCode of invoice address

Example: ""

citySTRING

City

Example: ""

stateSTRING

Address State

Example: ""

countrySTRING

Country

Example: ""

inspectListARRAY

Example: null

fullNameSTRING

Example: ""

emailSTRING

Example: ""

positionSTRING

Example: ""

countryCodeSTRING

Example: ""

phoneNumberSTRING

Example: ""

genderSTRING

Example: ""

birthdaySTRING

Example: ""

nationalitySTRING

Example: ""

iDTypeSTRING

Example: ""

iDNoSTRING

Example: ""

beginDateTimeSTRING

Example: ""

endDateTimeSTRING

Example: ""

statusSTRING

Current status of Account

Example: "VERIFIED"

documentOBJECT

ctosFileUrlSTRING

Example: ""

ownerICFileUrlSTRING

Example: ""

directorICFileUrlSTRING

Example: ""

shareHolderICFileUrlSTRING

Example: ""

businessRegistrationFileUrlSTRING

Example: ""

bankStatementFileUrlSTRING

Example: ""

moaFileUrlSTRING

Example: ""

form24FileUrlSTRING

Example: ""

form49FileUrlSTRING

Example: ""

section14FileUrlSTRING

Example: ""

form44FileUrlSTRING

Example: ""

businessSitePhotoFileUrlSTRING

Example: ""

essmDocumentFileUrlSTRING

Example: ""

letterOfConsentFileUrlSTRING

Example: ""

documentFileOBJECT

CtosFileUrlSTRING

Example: null

OwnerICFileUrlSTRING

Example: null

DirectorICFileUrlSTRING

Example: null

ShareHolderICFileUrlSTRING

Example: null

BusinessRegistrationFileUrlSTRING

Example: null

BankStatementFileUrlSTRING

Example: null

MoaFileUrlSTRING

Example: null

Form24FileUrlSTRING

Example: null

Form49FileUrlSTRING

Example: null

Section14FileUrlSTRING

Example: null

Form44FileUrlSTRING

Example: null

BusinessSitePhotoFileUrlSTRING

Example: null

bankAccountNoSTRING

Example: ""

bankAccountTypeSTRING

Example: ""

bankAccountHolderNameSTRING

Example: ""

bankNameSTRING

Example: ""

bankCodeSTRING

Example: ""

averageTicketSizeINTEGER

Example: 0

averageTurnoverPerMonthINTEGER

Example: 0

paymentSubscriptionSTRING

Example: ""

createdAtDATETIME

Creation date time of merchant

Example: "2021-01-13T04:35:32Z"

updatedAtDATETIME

Last update date time of merchant

Example: "2021-01-13T04:35:32Z"

codeSTRING

Successfully call this endpoint. If fail, will return error code object (Refer Appendix 1: Error Codes)

Example: "SUCCESS"

metaOBJECT

Example: {}