Developer Docs
WebsiteDashboard
GuidesAPI ReferenceHelp
PaymentFiat Account

Retrieve an account

GET
/openapi/v1/fiat-accounts/{accountId}

Retrieve the account detail by account ID.

GLDB

  • accountId is the application number returned by create.
  • Do not send providerCustomerId.
  • The status is PENDING during review and ACTIVE after approval. If the account is later deactivated or closed, the status is INACTIVE or CLOSED. If the review is rejected or the application is cancelled, the status is FAILED.
  • After the account is opened, accountNumber, bankName, bankAddress, swiftBic, iban, bankCountry, and accountHolderName are returned. openedAt is returned only when the status is ACTIVE.
  • No Webhook is sent for status changes. Poll this endpoint.
  • If the account does not exist, fiat.account.not_found is returned. Only single-currency accounts are supported. A query for a multi-currency account returns fiat.account.multi_currency_unsupported.

Authorization

bearerAuth
headerAuthorizationBearer <token>

The access_token obtained from POST /oauth2/token. Header format: Authorization: Bearer {accessToken}.

Path Parameters

accountId*string

Account ID. For LEGEND, such as bnk_abc123. For GLDB, the application number returned by create.

Query Parameters

providerCustomerId?string

Customer identifier on the provider side, supplied by the caller. Required for LEGEND; it is the user_short_id. Do not send it for GLDB.

Header Parameters

X-Channel-Provider*string

Provider identifier, such as GLDB

Response Body

Returns the account detail.

application/json
  1. response
code?integer

Business status code

message?string
traceId?string

Request trace ID. Provide it when you contact technical support

data?

Fiat account detail.

Example Request
curl -X GET 'https://api.test.stabofx.com/openapi/v1/fiat-accounts/bnk_abc123' \  -H 'X-Channel-Provider: GLDB'
Example Response
{  "code": 200,  "message": "OK",  "traceId": "t_xxxxxxxx",  "data": {    "accountId": "bnk_abc123",    "providerCustomerId": "usr_user123",    "currency": "USD",    "status": "ACTIVE",    "alias": "Main USD Account",    "bankCountry": "SG",    "bankName": "DBS Bank",    "bankAddress": "12 Marina Boulevard",    "accountHolderName": "Acme Pte Ltd",    "swiftBic": "DBSSSGSG",    "accountNumber": "072001234",    "routingCodes": [      {        "type": "ROUTING_NUMBER",        "value": "123456789"      }    ],    "openedAt": "2026-11-06T10:30:00Z"  }}

List opening options GET

List the available opening routes and fees for a customer. `currency` and `bankCountry` are both optional. Without both, all options of the customer are returned. `partnerBanks` are candidate banks only; the account detail shows the bank actually used. Applies to LEGEND only. GLDB does not support it and returns `openapi.channel.unsupported`.