- Overview
- APIs Offered
- Applications must get the token using the “Get Token API," which will provide the access token details. This token must be used for the subsequent interactions of RESTful APIs. Tokens will be valid for 180s
- Bulk support is against one CIF ID i.e. multiple entries can be updated in one batch referring to a single CIF.
- You may have to initiate a new batch for a different CIF.
- For enquiry CIF and Batch id mandatory.
This API provides customers with real-time information on their current and available account balances. It improves cash visibility, automates reconciliation, and enhances the efficiency of financial operations.
NOTE:
Flow Chart
What operations can be performed?
1. initiateAccountBalance: This POST method allows the customer to retrieve the current and available account balance.
Request Headers:
Request Parameters:
Response Parameters:
Status Code Information:
2. accountBalanceInquiry: This GET service enables the customer to make an inquiry about the status of initiated request to fetch current and available account balance.
Request Headers:
Request Parameters:
Response Parameters:
Status Code Information:
IMPORTANTS NOTES:

Mashreq’s Account Balance APIs eliminate the need for manual balance checks or batch file downloads. By exposing secure, on-demand access to account balances, corporates can optimise working capital, validate funds before initiating transactions, and monitor balances to detect anomalies or risks.
What are the benefits?
Real-Time Cash Visibility
Corporates can instantly retrieve balances for all accounts held within the bank, supporting time-sensitive financial decisions.
Automated Reconciliation
Streamline financial operations by syncing real-time balance data with internal ERP or treasury systems, reducing manual effort and errors
Optimised Liquidity Management
Monitor cash positions continuously to manage idle funds, avoid overdrafts, and make informed investment or payment decisions.
Enhanced Payment Control
Validate sufficient balances before initiating large-value or bulk payments, helping prevent failed or delayed transactions.
Reduced Fraud and Operational Risk
Frequent balance checks help detect unusual activity or unauthorised transactions, strengthening financial control.
Improved Financial Reporting
Generate up-to-date, accurate reports on account positions for audits or internal compliance reviews.
Which APIs are offered?
- Account Balance API: This API provides customers with real-time information on their current and available account balances. It improves cash visibility, automates reconciliation, and enhances the efficiency of financial operations.
By leveraging Mashreq’s Account Balance APIs, corporate clients can significantly enhance their financial operations, ensuring more efficient, accurate, and secure management of their financial activities.