Multigate
  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
      • 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
    • Get Transfer Fields & Fees
    • Find Transfers
  • 📩 Webhooks / Push Notifications
    • Add a New Client Configuration
    • Update Client Configuration Current Mode
    • Get Client Configuration
  • 📲 Remittance
    • Initiate Remittance
    • Get Remittance
  1. 💰 Accounts

Get Accounts By

GET
/client-service/api/v1/accounts/by
Retrieve accounts by accountNumber or, if no accountNumber is available, the account entityId.

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 --request GET 'https://api-gateway-uat.mmacs.io/platform/client-service/api/v1/accounts/by?accountNumber=1238286123&accountId=8nlhb1PyH1M5IdvcNOab9'

Responses

🟢200OK
application/json
success response
Body

Example
{
    "message": "account(s) successfully retrieved",
    "account": {
        "accountId": "gSTjTZAfnf0a3ALyemiHD",
        "entityId": "9va0EY5wREalB8ESQRdgo",
        "uniqueRequestId": "7ae5b77c-454a-4990-ba5c-71060504d78e",
        "currencyIso3Code": "NGN",
        "accountName": "UAT Client",
        "status": "active",
        "availableBalance": 0,
        "accountType": "multigate",
        "fundingDetails": [
            {
                "bankOrSortCode": "232232",
                "bic": "TESTBANK",
                "accountNumber": "0259601196",
                "bankCountry": "NGA",
                "bankName": "test-bank",
                "bankAddress": "",
                "countryIso3Code": "NGA"
            },
            {
                "bankOrSortCode": "214",
                "bic": "FCMBNGLA",
                "accountNumber": "1000065346",
                "bankCountry": "NGA",
                "bankName": "FCMB",
                "bankAddress": "",
                "countryIso3Code": "NGA"
            },
            {
                "bankOrSortCode": "test-bank",
                "bic": "",
                "accountNumber": "1238363395",
                "bankCountry": "NGA",
                "bankName": "Paystack Titan",
                "bankAddress": "",
                "countryIso3Code": "NGA"
            }
        ]
    }
}
🟠400Bad Request
🟠401Unauthorized
Modified at 2025-07-20 12:33:18
Previous
Get Account
Next
Get All Accounts
Built with