---
title: "Full-text search for block numbers (returns chain + block number); optional chain filter and pagination."
method: GET
path: "/services/multichain/api/v1/clusters/{cluster_id}/search/block-numbers"
tags: ["ClusterExplorerService"]
---

# Full-text search for block numbers (returns chain + block number); optional chain filter and pagination.

`GET /services/multichain/api/v1/clusters/{cluster_id}/search/block-numbers`

## Request

- Base URL: `https://api.blockscout.com`
- URL: `https://api.blockscout.com/services/multichain/api/v1/clusters/{cluster_id}/search/block-numbers`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `apikey`
- TypeScript: <https://skmtc.dev/blockscout/apis/blockscout-pro-api/docs/services/multichain/api/v1/clusters/:cluster_id/search/block-numbers/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `cluster_id` string, required

## Query parameters

- `q` string
- `chain_id` string[]
- `page_size` integer
- `page_token` string

## Response `200`

A successful response.

- V1SearchBlockNumbersResponse
  - `items` V1ChainBlockNumber[]
    - `block_number` string, uint64
    - `chain_id` string, int64
  - `next_page_params` V1Pagination
    - `page_token` string
    - `page_size` integer

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/blockscout/apis/blockscout-pro-api.md) - [All operations](https://skmtc.dev/blockscout/apis/blockscout-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blockscout/apis/blockscout-pro-api/revisions/59ac5466233b?raw)