1. 🏦 Accounts
Multigate
  • 🚀 Getting Started
  • 🔓 Authentication
    • Get Token
    • Refresh Token
    • Logout User
    • Reset Password
    • Get Current User Info
  • 👋 Onboarding
    • Create Subclient
    • Get All Subclients
    • Get Subclient
    • Update Subclient
    • Create Subclient Shareholder
    • Get Subclient Shareholders
    • Update Subclient Shareholder
    • Upload Subclient Documents
    • Get Subclient Documents
    • Delete Subclient
    • Submit Subclient
  • 🏦 Accounts
    • 📄 Statements
      • V2
        • Get statement by account entity Id
        • Download statement by account entity Id
      • Get Statement
      • Download statement
    • Create Virtual Account
      POST
    • Get Account
      GET
    • Get Accounts By
      GET
    • Get All Accounts
      GET
    • Simulate Inflow (UAT only)
      POST
  • 🔃 Conversions
    • Get Quote
    • Lock Rate
    • Get Trade
    • Get All Trades
  • 💸 Payments
    • 🏦 Banks
      • Get Bank Details
    • 👤 Beneficiaries
      • Create Beneficiary
      • Get All Beneficiaries
      • Get Beneficiary
      • Update Beneficiary
      • Validate Beneficiary Account (NGN only)
    • Create Single Transfer
    • Get Purpose Codes
    • Find Transfers
  • 🔔 Webhooks / Push Notifications
    • Add a New Client Configuration
    • Update Client Configuration Current Mode
    • Get Client Configuration
  • 📲 Remittance
    • Initiate Remittance
    • Get Remittance
  • 📥 Receivables
    • Create Receivable
    • Get Receivable
  1. 🏦 Accounts

Get All Accounts

GET
/client-service/api/v1/accounts
Retrieve all accounts. Both linked and virtual accounts will be returned.

Request

Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-gateway-uat.mmacs.io/platform/client-service/api/v1/accounts?pageSize=undefined&pageOffset=undefined&sortField=undefined&sortDirection=undefined&sourceBankBicOrCode=undefined&sourceAccountNumber=undefined&sourceCurrencyIso3Code=undefined'

Responses

🟢200OK
application/json
success response
Bodyapplication/json

Example
{
    "message": "account(s) successfully retrieved",
    "data": [
        {
            "accountId": "2WCK3respo6qoTOtF76iH",
            "clientId": "ZnEzkE9tIQE_tOdPZ5i_Q",
            "entityId": "ZnEzkE9tIQE_tOdPZ5i_Q",
            "uniqueRequestId": "9ef5e9f5-6e1f-49c7-821d-3ae6286c48b9",
            "currencyIso3Code": "NGN",
            "accountName": "Liveness Check Dec 16 API",
            "status": "active",
            "accountType": "wallet",
            "fundingDetails": [
                {
                    "accountName": "Multigate Test Buyer",
                    "bankOrSortCode": "057",
                    "bic": "ZEIBNGLA",
                    "accountNumber": "1285507215",
                    "bankCountry": "NGA",
                    "bankName": "Zenith Bank Plc",
                    "bankAddress": "Plot 84/87, Ajose Adeogun Street, Victoria Island, Lagos, Nigeria",
                    "countryIso3Code": "NGA"
                },
                {
                    "accountName": "Multigate Test Buyer",
                    "bankOrSortCode": "214",
                    "bic": "FCMBNGLA",
                    "accountNumber": "8700002499",
                    "bankCountry": "NGA",
                    "bankName": "FCMB",
                    "bankAddress": "Primrose Tower, 17A, Tinubu Street, Marina, Lagos",
                    "countryIso3Code": "NGA"
                },
                {
                    "accountName": "Multigate Test Buyer",
                    "bankOrSortCode": "100039",
                    "bic": "100039",
                    "accountNumber": "9731091474",
                    "bankCountry": "NGA",
                    "bankName": "Paystack-Titan",
                    "bankAddress": "26 Joel Ogunnaike Street, Ikeja GRA, Lagos, Nigeria",
                    "countryIso3Code": "NGA"
                }
            ]
        },
        {
            "accountId": "b3z4baQTQNJxEAMwRy2Q5",
            "clientId": "ZnEzkE9tIQE_tOdPZ5i_Q",
            "entityId": "ZnEzkE9tIQE_tOdPZ5i_Q",
            "uniqueRequestId": "d9a16d61-183a-436f-a239-253a5921d151",
            "currencyIso3Code": "NGN",
            "accountName": "Liveness Check Dec 16 API",
            "status": "active",
            "accountType": "wallet",
            "fundingDetails": [
                {
                    "accountName": "Multigate Test Buyer",
                    "bankOrSortCode": "057",
                    "bic": "ZEIBNGLA",
                    "accountNumber": "1285493585",
                    "bankCountry": "NGA",
                    "bankName": "Zenith Bank Plc",
                    "bankAddress": "Plot 84/87, Ajose Adeogun Street, Victoria Island, Lagos, Nigeria",
                    "countryIso3Code": "NGA"
                },
                {
                    "accountName": "Multigate Test Buyer",
                    "bankOrSortCode": "100039",
                    "bic": "100039",
                    "accountNumber": "9715141586",
                    "bankCountry": "NGA",
                    "bankName": "Paystack-Titan",
                    "bankAddress": "26 Joel Ogunnaike Street, Ikeja GRA, Lagos, Nigeria",
                    "countryIso3Code": "NGA"
                },
                {
                    "accountName": "Multigate Test Buyer",
                    "bankOrSortCode": "214",
                    "bic": "FCMBNGLA",
                    "accountNumber": "8700002475",
                    "bankCountry": "NGA",
                    "bankName": "FCMB",
                    "bankAddress": "Primrose Tower, 17A, Tinubu Street, Marina, Lagos",
                    "countryIso3Code": "NGA"
                }
            ]
        },
        {
            "accountId": "9j8aX3uXLocH97xqpm-Zo",
            "clientId": "ZnEzkE9tIQE_tOdPZ5i_Q",
            "entityId": "ZnEzkE9tIQE_tOdPZ5i_Q",
            "uniqueRequestId": "83d367cf-5f1b-4c7b-bfe3-fe0caa33a0db",
            "currencyIso3Code": "NGN",
            "accountName": "Liveness Check Dec 16 API",
            "status": "active",
            "accountType": "wallet",
            "fundingDetails": [
                {
                    "accountName": "Multigate Test Buyer",
                    "bankOrSortCode": "057",
                    "bic": "ZEIBNGLA",
                    "accountNumber": "1285493578",
                    "bankCountry": "NGA",
                    "bankName": "Zenith Bank Plc",
                    "bankAddress": "Plot 84/87, Ajose Adeogun Street, Victoria Island, Lagos, Nigeria",
                    "countryIso3Code": "NGA"
                },
                {
                    "accountName": "Multigate Test Buyer",
                    "bankOrSortCode": "100039",
                    "bic": "100039",
                    "accountNumber": "9715261624",
                    "bankCountry": "NGA",
                    "bankName": "Paystack-Titan",
                    "bankAddress": "26 Joel Ogunnaike Street, Ikeja GRA, Lagos, Nigeria",
                    "countryIso3Code": "NGA"
                },
                {
                    "accountName": "Multigate Test Buyer",
                    "bankOrSortCode": "214",
                    "bic": "FCMBNGLA",
                    "accountNumber": "8700002468",
                    "bankCountry": "NGA",
                    "bankName": "FCMB",
                    "bankAddress": "Primrose Tower, 17A, Tinubu Street, Marina, Lagos",
                    "countryIso3Code": "NGA"
                }
            ]
        }
    ],
    "totalItems": 3,
    "pageSize": 1000,
    "currentPage": 1,
    "totalPages": 1
}
🟠400Bad Request
🟠401Unauthorized
Modified at 2026-05-20 10:04:19
Previous
Get Accounts By
Next
Simulate Inflow (UAT only)
Built with