1. OAuth2
FOMO API (v20260326)
  • Welcome
    • Onboarding
    • Webhook
    • Version History
  • OAuth2
    • Request an access token
      POST
  • 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
  • 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 update intent
        • List virtual account update intents
      • Beneficiary Creation
        • Create a beneficiary creation intent
        • Confirm a beneficiary creation intent
        • Retrieve a beneficiary creation intent
        • List beneficiary creation intents
      • 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
  • Compliance
    • Party
      • Retrieve a party
      • List parties
    • Party Attribute
      • Retrieve a party attribute
      • List party attributes
    • Verification
      • Retrieve a verification
      • List verifications
    • Disclosure Consent
      • Retrieve a disclosure consent
      • List disclosure consents
    • Requirement
      • Retrieve a requirement
      • List requirements
    • Capability Grant
      • Retrieve a capability grant
      • List capability grants
    • Collection Session
      • Retrieve a collection session
      • List collection sessions
    • Evidence
      • Retrieve an evidence
      • List evidences
    • Screening
      • Retrieve a screening
      • List screenings
    • Crypto Address
      • Retrieve a crypto address
      • List crypto addresses
    • Travel Rule Message
      • Retrieve a travel rule message
      • List travel rule messages
    • Partner Access
      • Retrieve a partner access
      • List partner accesses
    • Crypto Address Declaration
      • Retrieve a crypto address declaration
      • List crypto address declarations
    • Requirement Type
      • Retrieve a requirement type
      • List requirement types
    • Capability
      • Check a capability
    • Partner
      • Retrieve a partner
      • List partners
    • Intents
      • Verification Creation
        • Create a verification creation intent
        • Set share token for verification creation intent
        • Answer a requirement for verification creation intent
        • Confirm a verification creation intent
        • Retrieve a verification creation intent
        • List verification creation intents
      • Verification Update
        • Create a verification update intent
        • Answer a requirement for verification update intent
        • Confirm a verification update intent
        • Retrieve a verification update intent
        • List verification update intents
      • Party Creation
        • Create a party creation intent
        • Confirm a party creation intent
        • Retrieve a party creation intent
        • List party creation intents
      • Party Attribute Creation
        • Create a party attribute creation intent
        • Confirm a party attribute creation intent
        • Retrieve a party attribute creation intent
        • List party attribute creation intents
      • Party Attribute Update
        • Create a party attribute update intent
        • Confirm a party attribute update intent
        • Retrieve a party attribute update intent
        • List party attribute update intents
      • Crypto Address Creation
        • Create a crypto address creation intent
        • Confirm a crypto address creation intent
        • Retrieve a crypto address creation intent
        • List crypto address creation intents
      • Partner Access Creation
        • Create a partner access creation intent
        • Confirm a partner access creation intent
        • Retrieve a partner access creation intent
        • List partner access creation intents
      • Crypto Address Declaration
        • Create a crypto address declaration intent
        • Confirm a crypto address declaration intent
        • Retrieve a crypto address declaration intent
        • List crypto address declaration intents
  1. OAuth2

Request an access token

UAT Env
https://oauth2.uat.fomoapis.com/v1
UAT Env
https://oauth2.uat.fomoapis.com/v1
POST
https://oauth2.uat.fomoapis.com/v1
/token

1. Prepare claims for JWT (JSON Web Token) assertion#

HeaderValue
typFixed value JWT
algFixed value RS256
kidYour Key ID
ClaimValue
issYour Customer ID
subYour Customer ID (unless otherwise instructed)
audFull URL of this access token endpoint
iatCurrent UNIX timestamp in seconds
expExpiration timestamp of current JWT assertion
(expiration does not affect access_token lifetime, so it's recommended to keep this short for security)
scopePlease choose only the scopes you need to use with the access token. Separate scopes with spaces. Refer to below for full list of scopes. You may use an asterisk (*) as a wildcard to specify a group of scopes. The wildcard is only permitted as a standalone terminating segment of a scope. Valid examples include treasury:v1:account:*, treasury:v1:*, treasury:* or *. Invalid examples include *:get, treasury:v1:*:get, and treasury:v1:acc*.
Scope

2. Sign the JWT using RS256 with your RSA private key#

Header
{
  "alg": "RS256",
  "typ": "JWT",
  "kid": "73d78dfe-3e40-44d3-b686-e2be7f6ef961"
}
Payload
{
  "iss": "725040eb-ed2c-4926-967c-39c8769eb622",
  "sub": "725040eb-ed2c-4926-967c-39c8769eb622",
  "aud": "https://oauth2.uat.fomoapis.com/v1/token",
  "iat": 1780476011,
  "exp": 1780479611,
  "scope": "treasury:v1:account:* storage:v1:file:get"
}
Signed JWT Assertion (assertion)
eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IjczZDc4ZGZlLTNlNDAtNDRkMy1iNjg2LWUyYmU3ZjZlZjk2MSJ9.eyJpc3MiOiI3MjUwNDBlYi1lZDJjLTQ5MjYtOTY3Yy0zOWM4NzY5ZWI2MjIiLCJzdWIiOiI3MjUwNDBlYi1lZDJjLTQ5MjYtOTY3Yy0zOWM4NzY5ZWI2MjIiLCJhdWQiOiJodHRwczovL29hdXRoMi51YXQuZm9tb2FwaXMuY29tL3YxL3Rva2VuIiwiaWF0IjoxNzgwNDc2MDExLCJleHAiOjE3ODA0Nzk2MTEsInNjb3BlIjoidHJlYXN1cnk6djE6YWNjb3VudDoqIHN0b3JhZ2U6djE6ZmlsZTpnZXQifQ.fOdJseKJwG2lV2PX4PsZlZwuHarlCzTM-ZrNC2e1octr2mlMbFfaNP-0pa3DCZrsrlYTX3CQR2GMSAOJSYznyADM0It1Rf0575hNCW2-J4CZ_rbkksJACUg3TU_dOW1F5vx5YLUg5sWyD-ozya32hSidA7P9LDiLd5TT2bbFWLo8QjQTG8MqWgow52TIWXadg5FcbZuynrFeEdcCRMW5b65vea-sNTpbSswSZXMfrh_o7uKXp_lZQm32iwrUiJ8oBi89kJHRFmYtWgZ_fgTuaJr5eaTDYzIMEk31aJWUIooFQlYdVu2oEmDeUil3oj9NxVh9g9HlGy_6FOnulKDQJBz-dNVFSZT7GlE7zVNU3lkBwTdTmPJCa_od0F8vzK0oIav698EgWjrwUwObcPaaCvZRzFDt0aE4EhMAuaJDx5FCLSFKq40prs51LPp5iaWopZgoiFQpY18s9ewJ-12iiEorta53vDca42Uy1sAXY-7g1foILGBnWs7O-iMV_K-_Gc1WVMBskddmeSp3fmd-0Ff2_nTuN4CijK6PTksgZAUyXPoCRJ4hl4xzPfhOoAEj6pqCdH7EJoDgXcYpXHKN2Agcfv5JovoGyu1b5cE0mVAxY1g0zZ7IwlyRQqLonaFxf1jvmGEWlmPGXNqc1UTQUTbd_qpUf_jlQXm249vA2b4

Request

Header Params

Body Params application/x-www-form-urlencodedRequired

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://oauth2.uat.fomoapis.com/v1/token' \
--header 'x-fomo-api-version: v20260326' \
--data-urlencode 'grant_type=' \
--data-urlencode 'assertion='
Response Response Example
{
    "access_token": "1/AZ1nGoeMfsCa93slpJj1Lg/f6VkoIHlHjGBsjrZD6m-ZrXF0Sd-eSrAljh6GuAXXm8rE1kkW1znaPw6RkStEBTnrNEaEyNjPdYFQwioxxofv5furnpT7yDSInEmv0MN6FsB-G3mXQlm0z5Zftyu5geSJKMjCP3losZTSt7kiCIXNybNM95CeJJg7GboPh3JKLrH7N27Zcs1RbS9TcNg1g4gvUQ_NOHwAbhPqrKeCXUcCCFplWUlCm0PfvBWVo_jHpfQtbS20iYwyfScoh97I_-yjMe3En3EOEPSrmpykz_QcqcguBwSODbr4Gl1Y8q72DAFk6WdsIHBt5cwpf_-nrLFKrOCOr2Bk80M76XgpCDAB4Fi-nnfJMshukyIi8qYuSCSHkJtJYlufRIW5aPHlsKpJyYySds9nsXvxhTw3ieXGqsjgfEDd9WYAhOzW3KgCg8DsdiCGgHu8O80bVja4Iioe76-ZpHAgwNSzlOLU6zOV6ulyZD_osd5f4fQcEQ0KW_kvgxMRYTeAdGU6qmFK8dOXRyycAvznRPKghHPIkYUCqXi1bHzSaOZhMqr6uxZ7OUfd_55hxgZAXHhF2vCha9H2nQXIB2r_5Ghd0p-NLtkH8W-EhdP6A2IavnbF6BdiVDsDFdPaxcPKusF-8PwTWzngFuBnbL0As9KuCIZP5SRuI9_rUiX4zZKlareOTrVGcZG3fqjaFYJPKlAA7MULngRklDgYnS4dzydnNLk1VNlBKWUzh52PUlBabvlfttLCRjPlc8ZnMHRmvOtLSfQ2I4aUBPMNodbcRbl0S-Dm4RrZysuItCs71mr2OuzpNOUZR_yHCML7b2ykh9INaaPflnL6olwuO2te-tyPMa84E1OpJIwfNhu6W-xeAhHh_vF8qfi-SE45kGHehRD_eoPDdiinlUOz0JuLOZ7PBi_emF89f8pypW1m58X-Oeixk0A2GJKZpdMpYya-lffbYx8d6DuqXAUxOO07zYaysjO_vOXuS2mwZX3LtD1VBglvCDKGOkeZ8ZDqJP5ZIntFgzRBgGvmSETp-9D4BjIuVkZrPkHIt6V7d4A1Au_JMFucwW4fE4tVjb9l7x36S4V6U3rhMFLlF7zrmY7bzrABbs9R_mrmG22WeTSmll9poc_-KHuoBDJ6jRrkNVWPENZbONN-rpMW1LhT44dnh_KPztrVvvbyCNmG5rRxbpH4fZr2Q1JvZCiF7N_3-k1v4tZd63pxnlLEaXXTPyN-20",
    "token_type": "Bearer",
    "expires_in": 299
}
Previous
Version History
Next
Overview 🗺️
Built with