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

# Validator Withdrawals by Index

> Paginated list of withdrawals processed for a validator by index.

**Cost:** 1 credit per call. Automatically refunded on 4xx/5xx responses.

**Access:** Requires portfolio entitlement.

**Rate limit:** 360 req/min (shared with portfolio bucket)

**Get your API key:** [Dev Portal](https://data.octav.fi)



## OpenAPI

````yaml /openapi.json get /beacon/validators/withdrawals/index/{index}
openapi: 3.0.0
info:
  title: Octav API
  description: >-
    Comprehensive blockchain data API for portfolio management, transactions,
    and DeFi analytics
  version: 1.0.0
  contact:
    name: Octav Support
    url: https://octav.fi
    email: info@octav.fi
servers:
  - url: https://api.octav.fi/v1
    description: Production API
security:
  - bearerAuth: []
tags:
  - name: Portfolio
    description: Portfolio and holdings endpoints
  - name: Virtual Users
    description: Virtual user management and portfolio endpoints (Pro only)
  - name: Nav
    description: Net Asset Value endpoints
  - name: Wallet
    description: Wallet information endpoints
  - name: Transactions
    description: Transaction history endpoints
  - name: Approvals
    description: Token approval endpoints
  - name: Tokens
    description: Token data endpoints
  - name: Airdrops
    description: Airdrop eligibility endpoints
  - name: Sync
    description: Data synchronization endpoints
  - name: Status
    description: Status check endpoints
  - name: Credits
    description: Credit balance endpoints
  - name: Chains
    description: Blockchain network and protocol endpoints
  - name: Contract Protocol
    description: Resolve a contract address to its DeFi protocol
  - name: Beacon Validators
    description: >-
      Ethereum beacon chain validator endpoints — details, rewards, withdrawals,
      and deposits (mainnet only)
paths:
  /beacon/validators/withdrawals/index/{index}:
    get:
      tags:
        - Beacon Validators
      summary: Validator Withdrawals by Index
      description: >-
        Paginated list of withdrawals processed for a validator by index.


        **Cost:** 1 credit per call. Automatically refunded on 4xx/5xx
        responses.


        **Access:** Requires portfolio entitlement.


        **Rate limit:** 360 req/min (shared with portfolio bucket)


        **Get your API key:** [Dev Portal](https://data.octav.fi)
      operationId: getValidatorWithdrawalsByIndex
      parameters:
        - name: index
          in: path
          required: true
          description: Non-negative validator index
          schema:
            type: integer
            minimum: 0
          example: 123456
        - name: offset
          in: query
          required: false
          description: Pagination offset.
          schema:
            type: number
            default: 0
        - name: limit
          in: query
          required: false
          description: Number of records to return. Max 10.
          schema:
            type: number
            default: 10
            maximum: 10
      responses:
        '200':
          description: Paginated validator withdrawals
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedValidatorWithdrawals'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/BeaconForbidden'
        '404':
          $ref: '#/components/responses/ValidatorNotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
        - bearerAuth: []
components:
  schemas:
    PaginatedValidatorWithdrawals:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/ValidatorWithdrawal'
        offset:
          type: number
          description: Current pagination offset
        limit:
          type: number
          description: Records per page
        totalRows:
          type: number
          description: Total number of withdrawals
        pages:
          type: number
          description: Total number of pages
    ValidatorWithdrawal:
      type: object
      properties:
        slot:
          type: number
          description: Slot in which the withdrawal was processed
        epoch:
          type: number
          description: Epoch containing the slot
        timestamp:
          type: number
          description: Unix timestamp of the withdrawal
        amount:
          type: string
          description: Withdrawn amount in wei
        address:
          type: string
          description: EVM address that received the withdrawal
        index:
          type: number
          description: Validator index
  responses:
    BadRequest:
      description: Input validation failed
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
    Unauthorized:
      description: Missing or invalid Bearer token
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Unauthorized
    BeaconForbidden:
      description: >-
        Forbidden — beacon access requires enterprise subscription. Contact
        sales.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Beacon access requires enterprise subscription. Contact sales.
    ValidatorNotFound:
      description: Validator does not exist on mainnet.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Validator not found for index 99999999
    InternalServerError:
      description: Upstream beacon data error.
      content:
        text/plain:
          schema:
            type: string
            example: Error fetching validator details
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````