1. 👤 Beneficiaries
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
    • Update Subclient Shareholder
  • 🏦 Accounts
    • 📄 Statements
      • V2
        • Get statement by account entity Id
        • Download statement by account entity Id
        • Download statement by account entity Id
      • Get Statement
      • Download statement
    • Create Virtual Account
    • Get Account
    • Get Accounts By
    • Get All Accounts
    • Simulate Inflow (UAT only)
    • Get Accounts By
  • 🔃 Conversions
    • Get Quote
    • Lock Rate
    • Get Trade
    • Get All Trades
  • 💸 Transfers
    • 🏦 Banks
      • Get Bank Details
    • 👤 Beneficiaries
      • Create Beneficiary
        POST
      • Get All Beneficiaries
        GET
      • Get Beneficiary
        GET
      • Update Beneficiary
        PUT
      • Validate Beneficiary Account (NGN only)
        POST
      • Get Beneficiary
        GET
      • Update Beneficiary
        PUT
    • Create Single Transfer
      POST
    • Get Transfer Fee
      POST
    • Find Transfers
      GET
    • Get Transfer Fee
      GET
  • 🔔 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
  • 🔔 Webhooks
    • Push Notifications
      • Update Client Configuration Current Mode
      • Get Client Configuration
  • Schemas
    • Default Folder
      • SubClientInput
      • CreateShareHolderInput
      • DocumentOutputArray
      • StatementOutput
      • AccountInput
      • AccountOutput
      • AccountOutputArray
      • BeneficiaryOutput
      • BeneficiaryOutputArray
      • SingleTransferResponse
      • RemittanceRequest
      • ReceivableInput
      • NewReceivableOutput
      • ReceivableOutput
    • InlineTransferBeneficiary
  1. 👤 Beneficiaries

Get Beneficiary

GET
/client-service/api/v1/beneficiaries/{entityId}

Request

Path 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/beneficiaries/'

Responses

🟢200OK
application/json
success response
Bodyapplication/json

Example
{
    "accountName": "string",
    "accountNumber": "string",
    "bankBicOrCode": "string",
    "bankName": "string",
    "bankAddress": "string",
    "name": "string",
    "addressLine1": "string",
    "addressLine2": "string",
    "city": "string",
    "state": "string",
    "country": "string",
    "currencyIso3Code": "string",
    "emailAddress": "string",
    "phoneNumber": "string",
    "clientId": "string",
    "subClientId": "string",
    "intermediaryBank": {},
    "branchInformation": {}
}
🟠400Bad Request
🟠401Unauthorized
Modified at 2026-09-10 09:41:46
Previous
Validate Beneficiary Account (NGN only)
Next
Update Beneficiary
Built with