> ## 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 Wallets

> This API is used to fetch all wallets for a user.



## OpenAPI

````yaml get /v1/wallet
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:
    get:
      tags:
        - Wallet
      summary: Get All Wallets
      description: This API is used to fetch all wallets for a user.
      operationId: getAllWallets
      responses:
        '200':
          $ref: '#/components/responses/WalletsSuccess'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          $ref: '#/components/responses/ForbiddenError'
        '404':
          $ref: '#/components/responses/NotFoundError'
components:
  responses:
    WalletsSuccess:
      description: ' A list of wallets was successfully retrieved.'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GetAllWalletsSuccessResponse'
    UnauthorizedError:
      description: Unauthorized. The provided API key is invalid or missing.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            status: error
            message: Invalid API key.
            data: null
    ForbiddenError:
      description: >-
        Forbidden. The request is not allowed, e.g., the source IP is not
        whitelisted.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            status: error
            message: IP not whitelisted.
    NotFoundError:
      description: >-
        Not Found. The requested resource, like a specific wallet, could not be
        found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            status: error
            message: Invalid Wallet Address
  schemas:
    GetAllWalletsSuccessResponse:
      type: object
      properties:
        status:
          type: string
          example: success
        message:
          type: string
          example: Wallets fetched successfully
        data:
          type: array
          items:
            $ref: '#/components/schemas/Wallet'
    ErrorResponse:
      type: object
      properties:
        status:
          type: string
          example: error
        message:
          type: string
          description: A human-readable error message.
        data:
          nullable: true
          description: Optional data payload, often null in case of an error.
          example: null
      required:
        - status
        - message
    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

````