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

# Get user wallet

> Retrieve the wallet assigned to a specific user.

Fetch the user's wallet to access the dedicated IBAN and current status. Pass the user identifier
in the `owner` query parameter to retrieve the wallet that was automatically provisioned when the
user account was created.

The response includes the wallet's unique IBAN and status, which indicates whether the wallet is
ready to receive funds.


## OpenAPI

````yaml GET /wallets
openapi: 3.0.3
info:
  title: Wealthyhood Wallets API
  version: 1.0.0
  description: >
    Wallet management endpoints for retrieving user wallets and their associated
    payment providers.


    All requests require a bearer access token with the advertised scopes, and
    must include

    the `x-user-id` header.
servers:
  - url: https://{host}
    variables:
      host:
        default: api.wealthyhood.com
        description: Wealthyhood API host name.
security:
  - bearerAuth: []
tags:
  - name: Wallets
    description: Retrieve and manage user wallets.
paths:
  /wallets:
    get:
      tags:
        - Wallets
      summary: Get user wallet
      description: >
        Retrieve the wallet that was provisioned for a given user. The wallet
        includes the dedicated IBAN

        and current status.
      parameters:
        - $ref: '#/components/parameters/ExternalUserId'
      responses:
        '200':
          description: Wallet retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WalletResponse'
              example:
                id: wal_64f0c51e7fb3fc001234abcd
                owner: 64f0c51e7fb3fc001234a001
                iban: GR1601101250000000012300695
                status: active
                createdAt: '2024-10-03T10:30:00Z'
                updatedAt: '2024-10-05T09:15:00Z'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
components:
  parameters:
    ExternalUserId:
      name: x-user-id
      in: header
      description: The external user identifier of the acting customer.
      required: true
      schema:
        type: string
        pattern: ^[a-f0-9]{24}$
        example: 64f0c51e7fb3fc001234a001
  schemas:
    WalletResponse:
      type: object
      required:
        - id
        - owner
        - status
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          description: Unique identifier of the wallet
          example: wal_64f0c51e7fb3fc001234abcd
        owner:
          type: string
          description: Identifier of the wallet owner (user id)
          example: 64f0c51e7fb3fc001234a001
        iban:
          type: string
          description: Dedicated IBAN assigned to the wallet
          example: GR1601101250000000012300695
        status:
          type: string
          description: Current status of the wallet
          enum:
            - created
            - delayed
            - active
            - deactivated
            - closed
          example: active
        createdAt:
          type: string
          format: date-time
          description: Timestamp when the wallet was created
          example: '2024-10-03T10:30:00Z'
        updatedAt:
          type: string
          format: date-time
          description: Timestamp when the wallet was last updated
          example: '2024-10-05T09:15:00Z'
    ApiErrorResponse:
      type: object
      properties:
        status:
          type: integer
          description: HTTP status code
        error:
          type: object
          properties:
            message:
              type: string
              description: Error message
            description:
              type: string
              description: Additional error details
              nullable: true
        responseId:
          type: string
          format: uuid
          description: Unique identifier for this error response
      additionalProperties: false
  responses:
    UnauthorizedError:
      description: Missing or invalid bearer token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
          example:
            status: 401
            error:
              message: Unauthorized - Invalid or missing authentication token
            responseId: 145f2b0d-1d5b-4e91-8d0d-7af0ae9ad13a
    NotFoundError:
      description: Resource not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
          example:
            status: 404
            error:
              message: Wallet not found for the provided user
            responseId: 23f3cbb4-9a0b-4f4e-92a7-a6f8e7d9cc21
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Auth0-issued access token that includes the scopes listed for the
        endpoint.

````