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

# Get Wallet Balance

> This API fetches the balance of a specific wallet.



## OpenAPI

````yaml get /v1/wallet/{walletId}/balance
openapi: 3.0.3
info:
  title: meCash API
  version: 3.0.3
  description: >-
    API for meCash services, including FIAT and Ramp operations. This is the
    OpenAPI specification for the meCash API, covering all available endpoints
    for wallet management, currency quotes, and payouts.


    It follows a design-first approach based on OpenAPI 3.0.


    Authentication is handled via an API key passed in the `x-api-key` header.
    Replace `YOUR_API_KEY` with your actual key when making requests.


    Some useful links:

    - [meCash Documentation](https://docs.me-cash.com/)

    - [Authentication Guide](https://docs.me-cash.com/authentication)
servers:
  - url: https://sandboxapi.me-cash.com
    description: Sandbox Server for Testing
security:
  - ApiKeyAuth: []
tags:
  - name: Wallet
    description: Wallet management operations
  - name: Quote
    description: Currency quote operations
  - name: Payout
    description: Payout operations
  - name: Transaction
    description: Transaction management
  - name: Virtual Account
    description: Virtual account operations for static and dynamic accounts
  - name: Bank
    description: Bank account and list operations
  - name: Ramp
    description: Ramp operations for crypto
  - name: Miscellaneous
    description: Utility and miscellaneous operations
  - name: Collection
    description: Mobile money and wallet funding operations
  - name: Bulk Payout
    description: >-
      Bulk transfer operations for sending to multiple beneficiaries in a single
      request
paths:
  /v1/wallet/{walletId}/balance:
    get:
      tags:
        - Wallet
      summary: Get Wallet Balance
      description: This API fetches the balance of a specific wallet.
      operationId: getWalletBalance
      parameters:
        - name: walletId
          in: path
          required: true
          schema:
            type: string
          description: The unique identifier of the wallet
      responses:
        '200':
          description: Wallet balance retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: wallet balance fetched successfully
                  status:
                    type: string
                    example: success
                  data:
                    $ref: '#/components/schemas/Wallet'
components:
  schemas:
    Wallet:
      type: object
      description: An object representing a user's wallet.
      properties:
        id:
          type: string
          format: uuid
          description: The unique identifier for the wallet.
          example: cfd2de64-a896-4405-8736-a1b2c3d4e5f6
        balance:
          type: number
          format: float
          description: The available balance in the wallet.
          example: 23094071
        currency:
          type: string
          description: The currency code (ISO 4217) of the wallet.
          example: NGN
        country:
          type: string
          description: The country code (ISO 3166-1 alpha-2) associated with the wallet.
          example: NG
      required:
        - id
        - balance
        - currency
        - country
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````