Skip to main content
GET
/
v1
/
ramp
/
subaccount
/
{subaccountId}
Get Subaccount
curl --request GET \
  --url https://api.bullring.finance/v1/ramp/subaccount/{subaccountId} \
  --header 'x-api-key: <api-key>'
{
  "id": "878beae6-e2f5-40a5-b7bf-449c73924aaa",
  "email": "[email protected]",
  "status": "created",
  "createdAt": "2026-01-12T13:09:58.033Z",
  "kyc": {
    "profiles": [
      {
        "country": "NG",
        "status": "approved"
      }
    ]
  },
  "capabilities": {
    "currencies": {
      "USD": {
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "TIER_2"
      },
      "NGN": {
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "TIER_1 NG"
      },
      "BRL": {
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "TIER_1 or higher"
      },
      "EUR": {
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "TIER_2"
      },
      "GHS": {
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "TIER_1 or higher"
      },
      "ZMW": {
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "TIER_1 or higher"
      },
      "TZS": {
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "TIER_1 or higher"
      },
      "MXN": {
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "TIER_1 or higher"
      },
      "COP": {
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "TIER_1 or higher"
      },
      "ARS": {
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "TIER_1 or higher"
      }
    },
    "assets": {
      "USDT": {
        "networks": [
          "ETHEREUM",
          "SOLANA"
        ]
      },
      "USDC": {
        "networks": [
          "ETHEREUM",
          "SOLANA"
        ]
      },
      "BTC": {
        "networks": [
          "LIGHTNING"
        ]
      }
    }
  }
}

Authorizations

x-api-key
string
header
required

Path Parameters

subaccountId
string<uuid>
required

The unique identifier of the subaccount

Example:

"6a0fd7af-181d-4c0f-b24b-b8cfb739d67a"

Response

Successful response

id
string<uuid>

Unique identifier for the subaccount

email
string<email>

Email address of the subaccount

status
enum<string>

Current status of the subaccount

Available options:
created,
approved,
review
createdAt
string<date-time>

Subaccount creation timestamp

kyc
object
capabilities
object