---
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

## Changes

> 35 revisions in range; 4 could not be searched.

- **2025-09-30** `ab4fb98e80fd` — 1 info
  - api operation id `getEpochs` was added
- **2025-09-12** `4024d7b1f833` — 1 info
  - endpoint added
- **2025-07-07** `34d0f6bf1d98` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ethpandaops/apis/dora-explorer-api/changes/v1/epochs/get.md)

---

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