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

# Your balances

> **Scope:** `accounts:read`

One entry per account, each with its `acc_` id: `type` `crypto` — your USDT wallet, the same balance `GET /wallets` shows — and `fiat` — the BOB you can pay out right now, net of payments already in flight. The BOB entry is payout capacity, not money you hold, and is listed only once a payout balance is provisioned for you. `reserved` is held by payments that have not finished, or `null` where it is not tracked. Pass `account_id` for one account only. Check the BOB entry before quoting a large payment to avoid `INSUFFICIENT_FUNDS`.



## OpenAPI

````yaml api-reference/openapi.json GET /accounts/balances
openapi: 3.0.3
info:
  title: Rampa Pay API
  version: 1.0.0
  description: >-
    Hold a USDT balance at Rampa and pay Bolivian merchant QRs in bolivianos.
    Amounts are decimal strings.
servers:
  - url: https://examples.staging.rampapay.com/v1
    description: 'Example server: sample answers, nothing real moves'
security:
  - apiKey: []
tags:
  - name: Accounts
    description: Every balance you hold with Rampa, in one place.
  - name: Wallet
    description: Your USDT balance at Rampa, and how money gets into it.
  - name: Payouts
    description: >-
      Quote a BOB amount in USDT; once your end user accepts, pay it out at that
      quote from your USDT wallet — to a merchant QR today, to a bank account
      soon.
  - name: Webhooks
    description: Where we send events. Each endpoint gets its own signing secret.
paths:
  /accounts/balances:
    get:
      tags:
        - Accounts
      summary: Your balances
      description: >-
        **Scope:** `accounts:read`


        One entry per account, each with its `acc_` id: `type` `crypto` — your
        USDT wallet, the same balance `GET /wallets` shows — and `fiat` — the
        BOB you can pay out right now, net of payments already in flight. The
        BOB entry is payout capacity, not money you hold, and is listed only
        once a payout balance is provisioned for you. `reserved` is held by
        payments that have not finished, or `null` where it is not tracked. Pass
        `account_id` for one account only. Check the BOB entry before quoting a
        large payment to avoid `INSUFFICIENT_FUNDS`.
      operationId: account-balances
      parameters:
        - name: account_id
          in: query
          required: false
          schema:
            type: string
          description: >-
            `acc_ id`. Only this account. 404 ACCOUNT_NOT_FOUND when it is not
            one of yours.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        account_id:
                          type: string
                        type:
                          type: string
                        currency:
                          type: string
                        available:
                          type: string
                        reserved:
                          type: string
                          nullable: true
                        as_of:
                          type: string
              example:
                data:
                  - account_id: acc_7Hq2Lx9TbR4mW1cZ8kP3sN6v
                    type: crypto
                    currency: USDT
                    available: '897.960000'
                    reserved: '0.000000'
                    as_of: '2026-10-16T13:05:00.000Z'
                  - account_id: acc_Qm4Vb8Xc2Nz6Lk1Jh5Gf9Ds3
                    type: fiat
                    currency: BOB
                    available: '12500.00'
                    reserved: null
                    as_of: '2026-10-16T13:05:00.000Z'
        '400':
          description: account_id is not acc_ followed by 24 letters and digits.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: '`ACCOUNT_NOT_FOUND` — No account with that id for your key.'
components:
  responses:
    Unauthorized:
      description: >-
        `AUTHENTICATION_FAILED` — the key is missing, unknown, revoked or
        expired, or the tenant is suspended.
    Forbidden:
      description: '`SCOPE_REQUIRED` — your key lacks this endpoint''s scope. Ask Rampa.'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        On the example server, any key that starts with `rpk_mock_`, e.g.
        `rpk_mock_yourname`. Never your real key.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.