Update Account By ID
Update the details of an existing account. Use this to modify company info, addresses, banking details, documents, and inspect list entries for a registered account.
When to Use
▾
Use this endpoint when:
- An account's company details or registration info changes
- You need to upload or replace document URLs (CTOS, bank statement, etc.)
- Banking details or business addresses require updating
- Directors / shareholders on the
inspectListneed to be amended
How to Use
▾
/v3/accounts/{id}Step 1: Get the Account ID
▾
Locate the account id you want to update. Retrieve it from the Get Accounts endpoint.
Step 2: Prepare the Updated Fields
▾
Include only the fields you want to update. Leave unchanged fields out of the body, or pass their current values.
Step 3: Send the PUT Request
▾
Pass the account id as a path parameter. Include the updated fields in the JSON body.
Step 4: Review the Response
▾
A "SUCCESS" code with the updated account object confirms the change.
Request Parameters
▾
Pass the account id as a path parameter in the URL.
Brand name of the company.
Example: "Revenue Monster"
Company website URL.
Example: "https://revenuemonster.my"
Company registration number.
Example: "XAS1233123"
Date the company was established (ISO 8601).
Example: "2006-01-02T15:04:05Z"
Primary address line.
Example: "1, Jalan Pertanian 25"
Secondary address line.
Example: "Taman Universiti"
Postal code.
Example: "81302"
City.
Example: "SKUDAI"
State or province.
Example: "JOHOR"
Country.
Example: "MALAYSIA"
Country dialing code.
Example: "60"
Contact phone number.
Example: "167724152"
Registered company name.
Example: "Revenue Monster"
Type of company incorporation.
Example: "PRIVATE LIMITED COMPANY (SDN BHD)"
Business category.
Example: "COMPUTER AND ELECTRONICS"
Average transaction ticket size.
Example: 1000000
Average monthly turnover.
Example: 1000000
Description of business scope.
Example: "some business scope"
Invoice / billing address.
Address line 1.
Example: "1, Jalan Pertanian 25"
Address line 2.
Example: "Taman Universiti"
Postal code.
Example: "81302"
City.
Example: "SKUDAI"
State.
Example: "JOHOR"
Country.
Example: "MALAYSIA"
Document file URLs.
CTOS report file URL.
Example: "https://somefilenedpoint.com"
Owner IC file URL.
Example: "https://somefilenedpoint.com"
Director IC file URL.
Example: "https://somefilenedpoint.com"
Shareholder IC file URL.
Example: "https://somefilenedpoint.com"
Business registration file URL.
Example: "https://somefilenedpoint.com"
Bank statement file URL.
Example: "https://somefilenedpoint.com"
MOA file URL.
Example: "https://somefilenedpoint.com"
Form 24 file URL.
Example: "https://somefilenedpoint.com"
Form 49 file URL.
Example: "https://somefilenedpoint.com"
Section 14 file URL.
Example: "https://somefilenedpoint.com"
Form 44 file URL.
Example: "https://somefilenedpoint.com"
Business site photo URL.
Example: "https://somefilenedpoint.com"
List of inspected directors / shareholders.
Full name.
Example: "NG SZE CHEN"
Gender.
Example: "MALE"
Date of birth (ISO 8601).
Example: "2000-07-14T15:59:59Z"
Nationality.
Example: "MALAYSIAN"
Identification type.
Example: "IC"
Identification number.
Example: "2131290134"
Bank account type (`"CORPORATE"`, `"INDIVIDUAL"`).
Example: "CORPORATE"
Bank account holder name.
Example: "Revenue Monster"
Bank account number.
Example: "32312323"
Bank code. See [Bank Code](../../bank-code).
Example: "HLBB"
Latitude of business address.
Example: 0.0
Longitude of business address.
Example: 0.0
Response Parameters
▾
Account ID
Example: "1653895399283266156"
Merchant ID
Example: "4118165203679668885"
Example: true
Company name of merchant
Example: "REVENUE MONSTER"
Type of company incorporation
Example: "SOLE PROPRIETOR"
Registration number of merchant
Example: “12344”
Business category of merchant
Example: "SOFTWARE AND IT"
Business scope of merchant
Example: "SOFTWARE AND IT"
Source of funds of merchant
Example: "BUSINESS REVENUE"
Customer origin of merchant
Example: "DOMESTIC"
Established date time of merchant
Example: "2018-03-26T04:50:57Z"
Country code of merchant contact number
Example: "60"
Phone number of merchant
Example: "377334080"
Address 1 of merchant
Example: "20, JALAN JASA 38, TAMAN MUTIARA RINI"
Address 2 of merchant
Example: ""
Postcode of merchant
Example: “81300”
City of merchant
Example: "Selangor"
State of merchant
Example: "Selangor"
Country of merchant
Example: "Malaysia"
Example: false
Object of Invoice Address
AddressLine1
Example: ""
AddressLine2
Example: ""
PostCode of invoice address
Example: ""
City
Example: ""
Address State
Example: ""
Country
Example: ""
Example: null
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Current status of Account
Example: "UNVERIFIED"
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Example: 0
Example: 0
Example: ""
Creation date time of merchant
Example: "2021-01-13T04:35:32Z"
Last update date time of merchant
Example: "2021-01-13T04:35:32Z"
Successfully call this endpoint. If fail, will return error code object (Refer Appendix 1: Error Codes)
Example: "SUCCESS"