---
title: "List Celo epochs."
method: GET
path: "/{chain_id}/api/v2/celo/epochs"
tags: ["celo"]
---

# List Celo epochs.

`GET /{chain_id}/api/v2/celo/epochs`

Retrieves a paginated list of Celo epochs.

## Path parameters

- `chain_id` string, required

## Query parameters

- `items_count` integer
- `number` integer

## Response `200`

List of Celo epochs.

- object
  - `items` Epoch[], required
    - `distribution` object, nullable, required
    - `end_block_number` integer, required
    - `is_finalized` boolean, required
    - `number` integer, required
    - `start_block_number` integer, required
    - `timestamp` string, date-time, nullable, required
    - `type` 'L1' | 'L2', required
  - `next_page_params` object, nullable, required

## Other responses

- `422` — Unprocessable Entity

---

[API](https://skmtc.net/blockscout/apis/blockscout-pro-api.md) · [All operations](https://skmtc.net/blockscout/apis/blockscout-pro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockscout/blockscout-pro-api/revisions/59ac5466233b/schema)