---
title: "Get epochs list"
method: GET
path: "/v1/epochs"
tags: ["epochs"]
---

# Get epochs list

`GET /v1/epochs`

Returns a list of epochs with detailed information and statistics

## Query parameters

- `epoch` integer
- `limit` integer

## Response `200`

OK

- ApiAPIEpochsResponse
  - `data` ApiAPIEpochsData
    - `current_epoch` integer
    - `epoch_count` integer
    - `epochs` ApiAPIEpochInfo[]
      - `attestations` integer
      - `attester_slashings` integer
      - `bls_changes` integer
      - `consolidation_requests` integer
      - `deposits` integer
      - `deposits_amount` integer
      - `eligible_ether` integer
      - `epoch` integer
      - `exits` integer
      - `finalized` boolean
      - `head_voted` integer
      - `max_sync_committee_size` integer
      - `min_sync_committee_size` integer
      - `missed_blocks` integer
      - `missed_payloads` integer
      - `orphaned_blocks` integer
      - `proposed_blocks` integer
      - `proposed_payloads` integer
      - `proposer_slashings` integer
      - `sync_participation` number
      - `target_voted` integer
      - `total_voted` integer
      - `validator_balance` integer
      - `validators` integer
      - `vote_participation` number
      - `voting_finalized` boolean
      - `voting_justified` boolean
      - `withdrawal_requests` integer
      - `withdrawals_amount` integer
      - `withdrawals_count` integer
    - `finalized_epoch` integer
    - `first_epoch` integer
    - `last_epoch` integer
    - `total_epochs` integer
  - `status` string

## Other responses

- `400` — Invalid parameters
- `500` — Internal server error

---

[API](https://skmtc.net/ethpandaops/apis/dora-explorer-api.md) · [All operations](https://skmtc.net/ethpandaops/apis/dora-explorer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ethpandaops/dora-explorer-api/revisions/73a9fb0d9c41/schema)
