---
title: "Full-text search for addresses by query string; optional chain filter and pagination."
method: GET
path: "/services/multichain/api/v1/clusters/{cluster_id}/search/addresses"
tags: ["ClusterExplorerService"]
---

# Full-text search for addresses by query string; optional chain filter and pagination.

`GET /services/multichain/api/v1/clusters/{cluster_id}/search/addresses`

## Request

- Base URL: `https://api.blockscout.com`
- URL: `https://api.blockscout.com/services/multichain/api/v1/clusters/{cluster_id}/search/addresses`
- 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/addresses/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.

- V1SearchAddressesResponse
  - `items` V1GetAddressResponse[]
    - `chain_infos` object: Map of chain id to chain-specific information.
    - `coin_balance` string: Sum of coin balances across all chains.
    - `domains` V1BasicDomainInfo[]
      - `name` string
      - `protocol` V1ProtocolInfo
        - `deployment_blockscout_base_url` string
        - `description` string
        - `docs_url` string
        - `icon_url` string
        - `id` string
        - `short_name` string
        - `title` string
        - `tld_list` string[]
    - `exchange_rate` string: Exchange rate of the cluster native coin.
    - `has_interop_message_transfers` boolean
    - `has_tokens` boolean
    - `hash` string
  - `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)