FOMO API (v20250702)
  1. Beneficiary
FOMO API (v20250702)
  • Authorization
  • Webhook
  • API
    • Account
      • Retrieve an account
      • List accounts
    • Balance
      • Retrieve a balance
      • List balances
    • Transaction
      • Retrieve a transaction
      • List transactions
    • Virtual Account
      • Retrieve a virtual account
      • List virtual accounts
    • Beneficiary
      • Beneficiary Acocunt
        • List beneficiary accounts
        • Retrieve a beneficiary account
      • List beneficiaries
        GET
      • Retrieve a beneficiary
        GET
    • Account Holder
      • Retrieve an account holder
      • List account holders
    • Outgoing Transfer
      • List outgoing transfers
      • Retrieve an outgoing transfer
    • Webhook
      • Retrieve a webhook
      • List webhooks
    • Intent
      • Account Holder Creation
        • Create an account holder creation intent
        • Get an account holder creation intent
        • Confirm an account holder creation intent
      • Outgoing Transfer Creation
        • Create an outgoing transfer creation intent
        • Get an outgoing transfer creation intent
        • Confirm an outgoing transfer creation intent
      • Virtual Account Creation
        • Create a virtual account creation intent
        • Set account holder for virtual account creation intent
        • Get a virtual account creation intent
        • Confirm a virtual account creation intent
      • Virtual Account Update
        • Create a virtual account update intent
        • Set account holder for virtual account update intent
        • Get a virtual account update intent
        • Confirm a virtual account update intent
      • Beneficiary Creation
        • Create a beneficiary creation intent
        • Get a beneficiary creation intent
        • Confirm a beneficiary creation intent
      • Beneficiary Account Creation
        • Create a beneficiary account creation intent
        • Get a beneficiary account creation intent
        • Confirm a beneficiary account creation intent
  1. Beneficiary

List beneficiaries

UAT Env
https://uat.fomoapis.com/v1
UAT Env
https://uat.fomoapis.com/v1
GET
https://uat.fomoapis.com/v1
/beneficiaries

Request

Query Params

Header Params

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://uat.fomoapis.com/v1/beneficiaries?token=oVBzX1tGSk2vkatBKq4Ycw==&count=3&country_code=HK&type=individual' \
--header 'x-fomo-api-version;'
Response Response Example
[
    {
        "id": "297d982c-daff-4534-a727-827b92cc8b6f",
        "create_time": "2025-07-30T10:06:39.363957+00:00",
        "update_time": "2025-07-30T10:06:39.363957+00:00",
        "token": "KX2YLNr/RTSnJ4J7ksyLbw==",
        "etag": "KX2YLNr/RTSnJ4J7ksyLbwAAAAAAAAAA",
        "customer_id": "725040eb-ed2c-4926-967c-39c8769eb622",
        "country_code": "HK",
        "name": "Andy Lim",
        "address": "Victoria Hong Kong",
        "type": "individual"
    }
]
Previous
Retrieve a beneficiary account
Next
Retrieve a beneficiary
Built with