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

# Get Recovery Balances

> List credited hub balances for a recovery owner

[How do programmatic withdrawals work?](/references/protocol/guides/withdrawals)

<Note>
  Lists balances already credited to the recovery owner's account on the hub. Deposits awaiting attestation or recovery are excluded — see [Attest Deposit](/references/api/attest-deposit) to credit eligible deposits. Discovery is eventually consistent.

  `ownerChainId` is the numeric Relay chain id of the recovery owner's account; [Request Withdrawal](/references/api/request-withdrawal) takes protocol chain slugs. A returned balance does not guarantee withdrawal eligibility; the withdrawal flow checks eligibility and the executable amount.
</Note>


## OpenAPI

````yaml get /withdrawals/balances
openapi: 3.0.3
info:
  title: Cross-chain solver
  version: 1.0.0
servers:
  - url: https://api.relay.link
    description: Mainnet API
  - url: https://api.testnets.relay.link
    description: Testnet API
security: []
paths:
  /withdrawals/balances:
    get:
      description: >-
        Lists credited Hub balances for one recovery owner. Excludes deposits
        awaiting attestation or recovery; discovery is eventually consistent.
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 256
          in: query
          name: recoveryAddress
          required: true
        - schema:
            type: number
            minimum: 1
            maximum: 9007199254740991
            multipleOf: 1
          in: query
          name: ownerChainId
          required: true
        - schema:
            type: number
            minimum: 1
            maximum: 50
            multipleOf: 1
            default: 20
          in: query
          name: limit
          required: false
        - schema:
            type: string
            minLength: 1
            maxLength: 512
          in: query
          name: continuation
          required: false
        - schema:
            type: string
          in: header
          name: x-api-key
          required: false
          description: Optional API key for higher rate limits.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - balances
                  - continuation
                properties:
                  balances:
                    type: array
                    items:
                      type: object
                      required:
                        - hubTokenId
                        - currency
                        - amount
                        - amountFormatted
                        - amountUsd
                      properties:
                        hubTokenId:
                          type: string
                        currency:
                          type: object
                          nullable: true
                          required:
                            - chainId
                            - address
                            - name
                            - symbol
                            - decimals
                          properties:
                            chainId:
                              type: number
                            address:
                              type: string
                            name:
                              type: string
                              nullable: true
                            symbol:
                              type: string
                              nullable: true
                            decimals:
                              type: number
                              nullable: true
                        amount:
                          type: string
                        amountFormatted:
                          type: string
                          nullable: true
                        amountUsd:
                          type: string
                          nullable: true
                  continuation:
                    type: string
                    nullable: true
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - errorCode
                properties:
                  message:
                    type: string
                  errorCode:
                    type: string
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - errorCode
                properties:
                  message:
                    type: string
                  errorCode:
                    type: string

````