---
title: "List batches."
method: GET
path: "/{chain_id}/api/v2/optimism/batches"
tags: ["optimism"]
---

# List batches.

`GET /{chain_id}/api/v2/optimism/batches`

Retrieves a paginated list of batches.

## Path parameters

- `chain_id` string, required

## Query parameters

- `items_count` integer
- `id` integer

## Response `200`

List of batches.

- object
  - `items` OptimismBatch[], required
    - `batch_data_container` 'in_blob4844' | 'in_celestia' | 'in_eigenda' | 'in_alt_da' | 'in_calldata', nullable, required
    - `l1_timestamp` string, date-time, required
    - `l1_transaction_hashes` FullHash[], required
    - `l2_end_block_number` integer, required
    - `l2_start_block_number` integer, required
    - `number` integer, required
    - `transactions_count` integer, 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)