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

# Validator withdrawal history

> Retrieve withdrawal operations attributed to one or more validators within a bounded epoch window. By default, the service returns data for the last 100 epochs ending at the latest processed epoch. You can set the optional `epoch` query parameter to move the 100-epoch window back in time (the window becomes `[epoch-99, epoch]`, clamped at 0 when `epoch < 99`).
Each item includes the epoch and slot of inclusion, the canonical block root, the global withdrawal index, the validator index, the recipient execution address, and the amount in gwei.



## OpenAPI

````yaml /api/v1/bundled.yaml get /api/v1/validator/{indexOrPubkey}/withdrawals
openapi: 3.0.4
info:
  title: beaconcha.in API Documentation
  license:
    name: GPL-3.0
    url: https://www.gnu.org/licenses/gpl-3.0.en.html
  description: >-
    > ⚠️ No new features or endpoints will be added to V1. We recommend the [V2
    API](/api/overview) for all new projects. See the [migration
    guide](/api/v1-to-v2-migration).

    ## Introduction

    **Advanced and reliable API for accessing comprehensive Ethereum blockchain
    data.**


    - **Free Usage Policy:** The API is free to use under a fair use policy,
    with rate limits of 10 requests per minute per IP.

    - **Caching:** All responses are cached for 1 minute.

    - **Higher Usage Plans:** For higher usage plans, visit:
    [https://beaconcha.in/pricing](https://beaconcha.in/pricing). An API key is
    required to use these plans.


    ### API Key Usage

    API keys can be obtained at
    [/user/settings](https://beaconcha.in/user/settings) and must be included in
    requests either as a query string parameter or in the request header.


    #### Example: Query String Parameter

    ```bash

    curl https://beaconcha.in/api/v1/slot/1?apikey=<your_key>

    ```


    #### Example: Request Header

    ```bash

    curl -H 'apikey: <your_key>' https://beaconcha.in/api/v1/slot/1

    ```
  contact: {}
  version: '1.1'
servers:
  - url: https://beaconcha.in
    description: Ethereum mainnet
  - url: https://hoodi.beaconcha.in
    description: Hoodi Ethereum testnet
security:
  - ApiKeyAuthQuery: []
  - ApiKeyAuthHeader: []
tags:
  - name: Epoch
    description: Data related to consensus layer epochs
  - name: Slots
    description: Data related to consensus layer slots
  - name: Validators
    description: Data related to consensus layer validators
  - name: Rewards
    description: Data related to validator rewards
  - name: Sync Committees
    description: Data related to sync committees
  - name: Rocketpool
    description: Data related to the rocketpool protocol
  - name: ETH.Store®
    description: Data related to the ETH.Store® metric
  - name: Validator deposits
    description: Data related to execution layer validator deposits
  - name: Blocks
    description: Data related to execution layer blocks
  - name: Gas
    description: Data related to gas prices
  - name: Address
    description: Data related to ethereum addresses
  - name: Network
    description: Network data
  - name: Misc
    description: Miscellaneous data
  - name: User
    description: User data
  - name: Machine Metrics
    description: Submit machine, beacon-node, and validator-client monitoring metrics
paths:
  /api/v1/validator/{indexOrPubkey}/withdrawals:
    get:
      tags:
        - Validators
      summary: Validator withdrawal history
      description: >-
        Retrieve withdrawal operations attributed to one or more validators
        within a bounded epoch window. By default, the service returns data for
        the last 100 epochs ending at the latest processed epoch. You can set
        the optional `epoch` query parameter to move the 100-epoch window back
        in time (the window becomes `[epoch-99, epoch]`, clamped at 0 when
        `epoch < 99`).

        Each item includes the epoch and slot of inclusion, the canonical block
        root, the global withdrawal index, the validator index, the recipient
        execution address, and the amount in gwei.
      operationId: listValidatorWithdrawals
      parameters:
        - name: indexOrPubkey
          in: path
          description: >-
            Comma-separated validator indices and/or public keys (maximum 100
            items by default).
          required: true
          style: simple
          explode: false
          schema:
            $ref: '#/components/schemas/primitives.indicesOrPubkeys'
        - name: epoch
          in: query
          description: >-
            Upper bound (inclusive) for the 100-epoch window used to fetch
            withdrawals. Defaults to the latest processed epoch when omitted.
            Must be a non-negative integer.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            minimum: 0
            example: 399359
      responses:
        '200':
          description: >-
            Matching withdrawals were retrieved successfully. The `data` array
            contains one item per withdrawal observed for any of the specified
            validators within the requested epoch window. If no withdrawals are
            found, the array is empty.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/types.ApiResponse'
                  - type: object
                    properties:
                      data:
                        type: array
                        items:
                          $ref: >-
                            #/components/schemas/types.ApiValidatorWithdrawalResponse
        '400':
          description: >-
            The request is invalid (for example, malformed identifiers, too many
            identifiers, or no valid indices).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/types.ApiErrorResponse'
              examples:
                invalidParam:
                  summary: Invalid validator identifier
                  value:
                    status: 'ERROR: invalid validator-parameter'
                    data: null
                tooMany:
                  summary: Too many identifiers
                  value:
                    status: 'ERROR: only a maximum of 100 query parameters are allowed'
                    data: null
                unresolvedPubkeys:
                  summary: Pubkey did not resolve to an index
                  value:
                    status: >-
                      ERROR: invalid validator argument, pubkey(s) did not
                      resolve to a validator index
                    data: null
                empty:
                  summary: No or invalid indices provided
                  value:
                    status: 'ERROR: no or invalid validator indicies provided'
                    data: null
        '500':
          description: An unexpected server error occurred while processing your request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/types.ApiErrorResponse'
              examples:
                serverError:
                  summary: Internal error
                  value:
                    status: 'ERROR: internal server error'
                    data: null
components:
  schemas:
    primitives.indicesOrPubkeys:
      type: string
      description: >
        Comma-separated list (no spaces) of validator identifiers. Each
        identifier must be either:

        - A validator index as a base-10 integer (for example, 652648)

        - A BLS public key as a 96-hex-character string with or without the 0x
        prefix (case-insensitive)


        Resolution and limits:

        - The server resolves public keys to validator indices before querying
        data.

        - The total number of identifiers must not exceed the server-enforced
        limit (default 100).

        - Identifiers that cannot be parsed or resolved result in HTTP 400.
      example: 1,2,3
    types.ApiResponse:
      type: object
      description: Standard success envelope used by all API endpoints.
      properties:
        status:
          type: string
          description: >-
            HTTP-independent status of the API operation. For successful
            responses this is always "OK".
          enum:
            - OK
        data:
          description: Response payload specific to the endpoint.
          nullable: true
          x-omitempty: true
    types.ApiValidatorWithdrawalResponse:
      type: object
      description: >-
        Withdrawal credited to a validator and included in a beacon block's
        execution payload.
      properties:
        epoch:
          type: integer
          description: Epoch containing the block that included this withdrawal (>= 0).
          minimum: 0
          example: 399379
        slot:
          type: integer
          description: >-
            Slot number of the beacon block that included this withdrawal (>=
            0).
          minimum: 0
          example: 12780154
        blockroot:
          type: string
          description: 0x-prefixed 32-byte root of the including beacon block.
          pattern: ^0x[a-fA-F0-9]{64}$
          example: '0xf5068b6240d2ca8d77b6924a4397263fda4647b09c7d767865637643a7be421d'
        withdrawalindex:
          type: integer
          description: Global sequential index assigned to this withdrawal (>= 0).
          minimum: 0
          example: 104312607
        validatorindex:
          type: integer
          description: Index of the validator whose balance was withdrawn (>= 0).
          minimum: 0
          example: 1440116
        address:
          type: string
          description: >-
            Recipient execution-layer address (0x-prefixed, 20-byte hex; 40 hex
            characters after 0x).
          pattern: ^0x[a-fA-F0-9]{40}$
          example: '0x4c66c2055f6a7a01e102bde8d8d71d1d36667e21'
        amount:
          type: integer
          description: Withdrawn amount in gwei (1 gwei = 1e9 wei).
          minimum: 0
          example: 18402466
    types.ApiErrorResponse:
      type: object
      description: Standard error envelope returned when a request fails.
      properties:
        status:
          type: string
          description: >-
            Human-readable error indicator and message. The value begins with
            "ERROR:" followed by details.
          example: 'ERROR: <Message>'
        data:
          type: string
          description: Optional additional context for the error. Null in most cases.
          nullable: true
          default: null
  securitySchemes:
    ApiKeyAuthQuery:
      type: apiKey
      in: query
      name: apikey
      description: ''
    ApiKeyAuthHeader:
      type: apiKey
      in: header
      name: apikey
      description: ''

````