1. Beneficiary Creation
FOMO API (v20260326)
  • Welcome
    • Onboarding
    • Webhook
    • Version History
  • OAuth2
    • Request an access token
  • Storage
    • Overview 🗺️
    • File
      • Create a file
      • Retrieve a file
      • Download file content
  • Simulator
    • Overview 🗺️
    • MCP for AI Agents ✨
      • JSON Configuration
    • Incoming Transfer
      • Create an incoming transfer
  • Compliance
    • Clearance
      • Retrieve a clearance
      • List clearances
    • Entity
      • Retrieve an entity
      • List entities
    • Account Declaration
      • Retrieve an account declaration
      • List account declarations
    • Account Declaration Proof
      • Retrieve an account declaration proof
      • List account declaration proofs
    • Intents
      • Entity Creation
        • Create an entity creation intent
        • Confirm an entity creation intent
        • Retrieve an entity creation intent
        • List entity creation intents
      • Account Declaration Creation
        • Create an account declaration creation intent
        • Confirm an account declaration creation intent
        • Retrieve an account declaration creation intent
        • List account declaration creation intents
      • Account Declaration Revocation
        • Create an account declaration revocation intent
        • Confirm an account declaration revocation intent
        • Retrieve an account declaration revocation intent
        • List account declaration revocation intents
      • Account Declaration Proof Creation
        • Create an account declaration proof creation intent
        • Confirm an account declaration proof creation intent
        • Retrieve an account declaration proof creation intent
        • List account declaration proof creation intents
      • Account Declaration Proof Answer
        • Create an account declaration proof answer intent
        • Confirm an account declaration proof answer intent
        • Retrieve an account declaration proof answer intent
        • List account declaration proof answer intents
  • Treasury
    • Overview 🗺️
    • MCP for AI Agents ✨
      • (Option 1) MCP Bundles (Recommended)
      • (Option 2) JSON Configuration (Most Compatible)
    • 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
    • Account Holder
      • Retrieve an account holder
      • List account holders
    • Outgoing Transfer
      • Retrieve an outgoing transfer
      • List outgoing transfers
    • Incoming Transfer
      • Retrieve an incoming transfer
      • List incoming transfers
    • Internal Transfer
      • Retrieve an internal transfer
      • List internal transfers
    • Beneficiary
      • Retrieve a beneficiary
      • List beneficiaries
    • Beneficiary Account
      • Retrieve a beneficiary account
      • List beneficiary accounts
    • Quote
      • Retrieve a quote
      • List quotes
    • Trade
      • Retrieve a trade
      • List trades
    • Intents
      • Account Holder Creation
        • Create an account holder creation intent
        • Confirm an account holder creation intent
        • Retrieve an account holder creation intent
        • List account holder creation intents
      • Outgoing Transfer Creation
        • Create an outgoing transfer creation intent
        • Confirm an outgoing transfer creation intent
        • Retrieve an outgoing transfer creation intent
        • List outgoing transfer creation intents
      • Virtual Account Creation
        • Create a virtual account creation intent
        • Set account holder for virtual account creation intent
        • Set account name for virtual account creation intent
        • Set external account for virtual account creation intent
        • Confirm a virtual account creation intent
        • Retrieve a virtual account creation intent
        • List virtual account creation intents
      • Virtual Account Update
        • Create a virtual account update intent
        • Set account name for virtual account update intent
        • Confirm a virtual account update intent
        • Retrieve a virtual account update intent
        • List virtual account update intents
      • Virtual Account Closure
        • Create a virtual account closure intent
        • Confirm a virtual account closure intent
        • Retrieve a virtual account closure intent
        • List virtual account closure intents
      • Beneficiary Creation
        • Create a beneficiary creation intent
          POST
        • Confirm a beneficiary creation intent
          PATCH
        • Retrieve a beneficiary creation intent
          GET
        • List beneficiary creation intents
          GET
      • Beneficiary Account Creation
        • Create a beneficiary account creation intent
        • Confirm a beneficiary account creation intent
        • Retrieve a beneficiary account creation intent
        • List beneficiary account creation intents
      • Quote Creation
        • Create a quote creation intent
        • Confirm a quote creation intent
        • Retrieve a quote creation intent
        • List quote creation intents
      • Trade Creation
        • Create a trade creation intent
        • Confirm a trade creation intent
        • Retrieve a trade creation intent
        • List trade creation intents
      • Trade Cancellation
        • Create a trade cancellation intent
        • Confirm a trade cancellation intent
        • Retrieve a trade cancellation intent
        • List trade cancellation intents
      • Internal Transfer Creation
        • Create an internal transfer creation intent
        • Confirm an internal transfer creation intent
        • Retrieve an internal transfer creation intent
        • List internal transfer creation intents
  • Issuing
    • Cardholder
      • Retrieve a cardholder
      • List cardholders
    • Card Program
      • Retrieve a card program
      • List card programs
    • Card
      • Reveal a card's details
      • Retrieve a card
      • List cards
    • Card Transaction
      • Retrieve a card transaction
      • List card transactions
    • Card Transaction Event
      • Retrieve a card transaction event
      • List card transaction events
    • Intents
      • Cardholder Creation
        • Create a cardholder creation intent
        • Confirm a cardholder creation intent
        • Retrieve a cardholder creation intent
        • List cardholder creation intents
      • Card Creation
        • Create a card creation intent
        • Confirm a card creation intent
        • Retrieve a card creation intent
        • List card creation intents
      • Card Update
        • Create a card update intent
        • Confirm a card update intent
        • Retrieve a card update intent
        • List card update intents
      • Card Closure
        • Create a card closure intent
        • Confirm a card closure intent
        • Retrieve a card closure intent
        • List card closure intents
  • Sumsub (Provider)
    • Applicant
      • Create an access token for an applicant
      • Create a WebSDK link for an applicant
      • Retrieve an applicant
      • List applicants
    • Applicant Action
      • Create an access token for an applicant action
      • Create a WebSDK link for an applicant action
      • Retrieve an applicant action
      • List applicant actions
    • Intents
      • Applicant Action Creation
        • Create an applicant action creation intent
        • Confirm an applicant action creation intent
        • Retrieve an applicant action creation intent
        • List applicant action creation intents
      • Applicant Creation
        • Create an applicant creation intent
        • Confirm an applicant creation intent
        • Retrieve an applicant creation intent
        • List applicant creation intents
      • Applicant Update
        • Create an applicant update intent
        • Confirm an applicant update intent
        • Retrieve an applicant update intent
        • List applicant update intents
  • DCS (Provider)
    • Decard Customer
      • Retrieve a decard customer
      • List decard customers
    • Intents
      • Decard Customer Creation
        • Create a decard customer creation intent
        • Confirm a decard customer creation intent
        • Retrieve a decard customer creation intent
        • List decard customer creation intents
  • 🚧 CMS (Provider)
    • Application
      • Retrieve an application
      • List applications
    • Entity
      • Retrieve an entity
      • List entities
    • Intents
      • Application Creation Intent
        • Create an application creation intent
        • Confirm an application creation intent
        • Retrieve an application creation intent
        • List application creation intents
      • Entity Creation Intent
        • Create an entity creation intent
        • Confirm an entity creation intent
        • Retrieve an entity creation intent
        • List entity creation intents
  1. Beneficiary Creation

Retrieve a beneficiary creation intent

UAT Env
https://treasury.uat.fomoapis.com
UAT Env
https://treasury.uat.fomoapis.com
GET
https://treasury.uat.fomoapis.com
/beneficiary-creation-intents/{beneficiary_creation_intent_id}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Header Params

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://treasury.uat.fomoapis.com/beneficiary-creation-intents/' \
--header 'x-fomo-api-version: v20260326' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "id": "019fdbc2-cf40-7a00-881d-ee93536583a8",
    "create_time": "2026-08-07T10:26:45.253819+00:00",
    "update_time": "2026-08-07T10:26:52.069829+00:00",
    "token": "AZ_bws9AegCIHe6TU2WDqA",
    "etag": "\"AZ_bws9AegCIHe6TU2WDqAAAAAAAAAAD\"",
    "life_cycle": "completed",
    "result": "successful",
    "fail_reason": null,
    "customer_id": "725040eb-ed2c-4926-967c-39c8769eb622",
    "country_code": "SG",
    "name": "John Doe",
    "address": {
        "department": null,
        "sub_department": null,
        "street_name": "West Avenue 2",
        "building_number": null,
        "building_name": null,
        "floor": null,
        "post_box": null,
        "room": null,
        "post_code": "675762",
        "town_name": "Singapore",
        "town_location_name": null,
        "district_name": null,
        "country_sub_division": "SG",
        "country": "SG"
    },
    "type": "individual",
    "requirements": [],
    "submitted_requirements": [],
    "confirm_time": "2026-08-07T10:26:51.574+00:00",
    "approve_time": "2026-08-07T10:26:51.741+00:00",
    "complete_time": "2026-08-07T10:26:52.050+00:00",
    "beneficiary_id": "c471deb7-5d06-4d0b-a972-dc37e9c1c766",
    "supplementary_information": {
        "automated_clearing_house": null
    },
    "supporting_information": []
}
Previous
Confirm a beneficiary creation intent
Next
List beneficiary creation intents
Built with