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": "a2e211aa-72d6-4ac2-a9ad-9bde8a77a3c3",
  "email": "[email protected]",
  "status": "approved",
  "createdAt": "2025-07-18T17:46:05.150Z",
  "firstName": null,
  "lastName": null,
  "phone": null,
  "type": "individual",
  "kyc": {
    "profiles": [
      {
        "country": "GH",
        "status": "approved"
      },
      {
        "country": "ZM",
        "status": "approved"
      },
      {
        "country": "BR",
        "status": "approved"
      }
    ]
  },
  "capabilities": {
    "currencies": {
      "USD": {
        "status": "locked",
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "Additional Verification required for USD operations",
        "rails": {
          "wire": false,
          "ach": false,
          "swift": false
        },
        "requiredActions": [
          {
            "type": "kyc",
            "description": "Complete verification",
            "url": "https://in.sumsub.com/websdk/p/0k9A7pIrtmbDR4PD"
          }
        ]
      },
      "NGN": {
        "status": "locked",
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "Additional Verification required for NGN operations",
        "rails": {
          "banktransfer": false
        },
        "requiredActions": [
          {
            "type": "kyc",
            "description": "Complete verification",
            "url": "https://in.sumsub.com/websdk/p/0k9A7pIrtmbDR4PD"
          }
        ]
      },
      "BRL": {
        "status": "approved",
        "canOnramp": true,
        "canOfframp": true,
        "canDeposit": true,
        "canWithdraw": true,
        "rails": {
          "pix": true
        }
      },
      "EUR": {
        "status": "locked",
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "Additional Verification required for EUR operations",
        "rails": {
          "sepa": false
        },
        "requiredActions": [
          {
            "type": "kyc",
            "description": "Complete verification",
            "url": "https://in.sumsub.com/websdk/p/0k9A7pIrtmbDR4PD"
          }
        ]
      },
      "GHS": {
        "status": "approved",
        "canOnramp": true,
        "canOfframp": true,
        "canDeposit": true,
        "canWithdraw": true,
        "rails": {
          "momo": true
        }
      },
      "ZMW": {
        "status": "approved",
        "canOnramp": true,
        "canOfframp": true,
        "canDeposit": true,
        "canWithdraw": true,
        "rails": {
          "momo": true
        }
      },
      "AED": {
        "status": "locked",
        "canOnramp": false,
        "canOfframp": false,
        "canDeposit": false,
        "canWithdraw": false,
        "requiredKyc": "Additional Verification required for AED operations",
        "rails": {
          "uaefts": false
        },
        "requiredActions": [
          {
            "type": "kyc",
            "description": "Complete verification",
            "url": "https://in.sumsub.com/websdk/p/0k9A7pIrtmbDR4PD"
          }
        ]
      },
      "USDCARD": {
        "status": "approved",
        "canOnramp": true,
        "canOfframp": true,
        "canDeposit": true,
        "canWithdraw": true,
        "rails": {}
      }
    },
    "assets": {
      "USDT": {
        "networks": [
          "ETH",
          "SOL",
          "CELO"
        ]
      },
      "USDC": {
        "networks": [
          "ETH",
          "SOL",
          "CELO",
          "POLY"
        ]
      },
      "EURC": {
        "networks": [
          "ETH",
          "SOL",
          "CELO"
        ]
      },
      "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

firstName
string | null

First name of the subaccount holder

lastName
string | null

Last name of the subaccount holder

phone
string | null

Phone number of the subaccount holder

type
enum<string>

Type of the subaccount

Available options:
individual,
business
kyc
object

KYC verification status across different countries

capabilities
object

Available capabilities for this subaccount