> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bullring.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Get All Subaccounts

> Retrieve a paginated list of all user subaccounts for a particular account.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/ramp/subaccount
openapi: 3.0.0
info:
  title: Bullring Finance API
  description: >-
    The Bullring Finance API allows you to build powerful cross-border payment
    solutions.
  version: 1.0.0
servers:
  - url: https://api.bullring.finance
    description: Production Server
  - url: https://staging-api.bullring.finance
    description: Sandbox Server
security:
  - x-api-key: []
tags:
  - name: Subaccounts
    description: Operations related to user subaccounts.
  - name: Verification
    description: Endpoints for subaccount verification, including KYC and KYB processes.
  - name: Balances
    description: Endpoints for retrieving account balances.
  - name: Deposits
    description: Endpoints for handling deposits into subaccounts.
  - name: Recipients
    description: Manage payment recipients for withdrawals.
  - name: Withdrawals
    description: Endpoints for handling withdrawals from subaccounts.
  - name: Conversions
    description: Endpoints for currency conversions.
  - name: Rates
    description: Endpoints for currency conversion rates.
  - name: Fees
    description: Endpoints for checking transaction fees.
  - name: Offramp
    description: Endpoints for handling offramp operations.
  - name: Onramp
    description: Endpoints for handling onramp operations.
paths:
  /v1/ramp/subaccount:
    get:
      tags:
        - Subaccounts
      summary: Get All Subaccounts
      description: >-
        Retrieve a paginated list of all user subaccounts for a particular
        account.
      parameters:
        - name: page
          in: query
          description: Page number for pagination
          schema:
            type: integer
          example: '1'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Unique identifier for the subaccount
                        email:
                          type: string
                          format: email
                          description: Email address of the subaccount
                        status:
                          type: string
                          description: Current status of the subaccount
                        createdAt:
                          type: string
                          format: date-time
                          description: Subaccount creation timestamp
                        kyc:
                          type: object
                          properties:
                            profiles:
                              type: array
                              items:
                                type: object
                                properties:
                                  country:
                                    type: string
                                  status:
                                    type: string
                        capabilities:
                          type: object
                        isParent:
                          type: boolean
                  meta:
                    type: object
                    properties:
                      total:
                        type: integer
                        description: Total number of subaccounts
                      page:
                        type: integer
                        description: Current page number
                      limit:
                        type: integer
                        description: Number of items per page
                      pages:
                        type: integer
                        description: Total number of pages
              example:
                data:
                  - id: 800f5374-8854-4790-97e0-1fa45a15b672
                    email: dafeengineer@gmail.com
                    status: approved
                    createdAt: '2025-11-19T16:48:49.565Z'
                    kyc:
                      profiles:
                        - country: NG
                          status: approved
                    capabilities:
                      currencies:
                        USD:
                          canOnramp: false
                          canOfframp: false
                          canDeposit: false
                          canWithdraw: false
                        NGN:
                          canOnramp: true
                          canOfframp: true
                          canDeposit: true
                          canWithdraw: true
                        BRL:
                          canOnramp: true
                          canOfframp: true
                          canDeposit: true
                          canWithdraw: true
                        EUR:
                          canOnramp: false
                          canOfframp: false
                          canDeposit: false
                          canWithdraw: false
                        GHS:
                          canOnramp: true
                          canOfframp: true
                          canDeposit: true
                          canWithdraw: true
                        ZMW:
                          canOnramp: true
                          canOfframp: true
                          canDeposit: true
                          canWithdraw: true
                        TZS:
                          canOnramp: true
                          canOfframp: true
                          canDeposit: true
                          canWithdraw: true
                      assets:
                        USDT:
                          networks:
                            - ETHEREUM
                            - SOLANA
                        USDC:
                          networks:
                            - ETHEREUM
                            - SOLANA
                        BTC:
                          networks:
                            - LIGHTNING
                    isParent: true
                  - id: 878beae6-e2f5-40a5-b7bf-449c73924aaa
                    email: user1+15124@bullring.finance
                    status: created
                    createdAt: '2026-01-12T13:09:58.033Z'
                    kyc:
                      profiles: []
                    capabilities:
                      currencies:
                        USD:
                          canOnramp: false
                          canOfframp: false
                          canDeposit: false
                          canWithdraw: false
                        NGN:
                          canOnramp: false
                          canOfframp: false
                          canDeposit: false
                          canWithdraw: false
                        BRL:
                          canOnramp: false
                          canOfframp: false
                          canDeposit: false
                          canWithdraw: false
                        EUR:
                          canOnramp: false
                          canOfframp: false
                          canDeposit: false
                          canWithdraw: false
                        GHS:
                          canOnramp: false
                          canOfframp: false
                          canDeposit: false
                          canWithdraw: false
                        ZMW:
                          canOnramp: false
                          canOfframp: false
                          canDeposit: false
                          canWithdraw: false
                        TZS:
                          canOnramp: false
                          canOfframp: false
                          canDeposit: false
                          canWithdraw: false
                      assets:
                        USDT:
                          networks:
                            - ETHEREUM
                            - SOLANA
                        USDC:
                          networks:
                            - ETHEREUM
                            - SOLANA
                        BTC:
                          networks:
                            - LIGHTNING
                meta:
                  total: 25
                  page: 1
                  limit: 15
                  pages: 2
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
              example:
                error: Unauthorized
                message: Invalid or missing API key
        '403':
          description: Forbidden - Insufficient permissions
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
              example:
                error: Forbidden
                message: You do not have permission to access this resource
        '404':
          description: Not Found - Account not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
              example:
                error: Not Found
                message: Account not found
components:
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````