List beneficiaries

UAT Env

https://treasury.uat.fomoapis.com/v1

GET

/beneficiaries

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://treasury.uat.fomoapis.com/v1/beneficiaries?token=oVBzX1tGSk2vkatBKq4Ycw%3D%3D&count=3&country_code=HK&type=individual' \
--header 'x-fomo-api-version: v20260326' \
--header 'Authorization: Bearer <token>'

Response Example

[
    {
        "id": "3a56e0a3-5741-4542-8480-e40714a3d516",
        "create_time": "2026-07-26T09:45:28.805595+00:00",
        "update_time": "2026-07-26T09:45:28.805595+00:00",
        "token": "Olbgo1dBRUKEgOQHFKPVFg",
        "etag": "\"Olbgo1dBRUKEgOQHFKPVFgAAAAAAAAAA\"",
        "customer_id": "725040eb-ed2c-4926-967c-39c8769eb622",
        "country_code": "HK",
        "name": "John Doe",
        "address": {
            "department": "",
            "sub_department": "",
            "street_name": "Queen's Road Central",
            "building_number": "28",
            "building_name": "Central Tower",
            "floor": "12",
            "post_box": "",
            "room": "1205",
            "post_code": "",
            "town_name": "Hong Kong",
            "town_location_name": "Central",
            "district_name": "Central",
            "country_sub_division": "HK",
            "country": "HK"
        },
        "type": "individual",
        "supplementary_information": {
            "automated_clearing_house": null
        }
    }
]

Retrieve a beneficiary

Retrieve a beneficiary account