> ## 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 activation and exit queue

> Retrieve current queue metrics for validators awaiting activation (entering) and validators scheduled to exit (exiting). The response includes the number of validators in each queue, the total effective balance in gwei for each queue, and the total validator count known to the explorer. No parameters are required.



## OpenAPI

````yaml /api/v1/bundled.yaml get /api/v1/validators/queue
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/validators/queue:
    get:
      tags:
        - Validators
      summary: Validator activation and exit queue
      description: >-
        Retrieve current queue metrics for validators awaiting activation
        (entering) and validators scheduled to exit (exiting). The response
        includes the number of validators in each queue, the total effective
        balance in gwei for each queue, and the total validator count known to
        the explorer. No parameters are required.
      operationId: getValidatorsQueue
      responses:
        '200':
          description: >-
            Queue metrics retrieved successfully. The `data` object contains
            counts and balances for entering and exiting validators.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/types.ApiResponse'
                  - type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/types.ApiValidatorQueueResponse'
        '400':
          description: The request is invalid or results could not be retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/types.ApiErrorResponse'
              examples:
                badRequest:
                  summary: Failed to retrieve results
                  value:
                    status: 'ERROR: could not retrieve db results'
                    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:
    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.ApiValidatorQueueResponse:
      type: object
      description: >-
        Current validator activation and exit queue metrics at the time of the
        request.
      properties:
        beaconchain_entering:
          type: integer
          description: >-
            Number of validators currently in the activation queue (awaiting
            entry into the active set).
          minimum: 0
          example: 7493
        beaconchain_exiting:
          type: integer
          description: >-
            Number of validators that have initiated exit and are in the exit
            queue.
          minimum: 0
          example: 55869
        validatorscount:
          type: integer
          description: >-
            Total number of validators known to the explorer (active + pending +
            exiting), not limited to either queue.
          minimum: 0
          example: 1031945
        beaconchain_entering_balance:
          type: integer
          description: >-
            Sum of effective balances for validators in the activation queue, in
            gwei.
          minimum: 0
          example: 1363143622559455
        beaconchain_exiting_balance:
          type: integer
          description: Sum of effective balances for validators in the exit queue, in gwei.
          minimum: 0
          example: 2365910000000000
    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: ''

````