---
title: "List verified smart contracts with optional filtering options"
method: GET
path: "/{chain_id}/api/v2/smart-contracts/"
tags: ["smart-contracts"]
---

# List verified smart contracts with optional filtering options

`GET /{chain_id}/api/v2/smart-contracts/`

Retrieves a paginated list of verified smart contracts with optional filtering by proxy status or programming language.

## Path parameters

- `chain_id` string, required

## Query parameters

- `sort` 'balance' | 'transactions_count'
- `order` 'asc' | 'desc'
- `q` string, nullable
- `filter` 'solidity' | 'vyper' | 'yul' | 'geas' | 'stylus_rust'
- `items_count` integer
- `smart_contract_id` integer
- `coin_balance` union
  - integer
  - string
  - string
- `hash` string
- `transactions_count` union
  - integer
  - string
  - string

## Response `200`

List of verified smart contracts matching the filter criteria, with pagination.

- object
  - `items` SmartContractListItem[], required
    - `address` Address, required — Address
      - `ens_domain_name` string, nullable, required — ENS domain name associated with the address
      - `hash` string, required
      - `implementations` Implementation[], required — Implementations linked with the contract
        - `address_hash` string, required
        - `name` string, nullable, required
      - `is_contract` boolean, nullable, required — Has address contract code?
      - `is_scam` boolean, required — Has address scam badge?
      - `is_verified` boolean, nullable, required — Has address associated source code?
      - `metadata` Metadata, required — Metadata struct
        - `tags` MetadataTag[], required — Metadata tags linked with the address
          - `meta` object, nullable, required
          - `name` string, required
          - `ordinal` integer, required
          - `slug` string, required
          - `tagType` 'name' | 'generic' | 'classifier' | 'information' | 'note' | 'protocol', required
      - `name` string, nullable, required — Name associated with the address
      - `private_tags` Tag[] — Private tags associated with the address
        - `address_hash` string, required
        - `display_name` string, required
        - `label` string, required
      - `proxy_type` 'eip1167' | 'eip1967' | 'eip1822' | 'eip1967_oz' | 'eip1967_beacon' | 'master_copy' | 'basic_implementation' | 'basic_get_implementation' | 'comptroller' | 'eip2535' | 'clone_with_immutable_arguments' | 'eip7702' | 'resolved_delegate_proxy' | 'erc7760' | 'minimal_proxy', nullable, required
      - `public_tags` Tag[] — Public tags associated with the address
        - `address_hash` string, required
        - `display_name` string, required
        - `label` string, required
      - `reputation` 'ok' | 'scam', required — Reputation of the address
      - `watchlist_names` WatchlistName[] — Watchlist name associated with the address
        - `display_name` string, required
        - `label` string, required
    - `certified` boolean, required
    - `coin_balance` string, nullable
    - `compiler_version` string, nullable, required
    - `github_repository_metadata` object, nullable
    - `has_constructor_args` boolean, nullable, required
    - `language` string, nullable, required
    - `license_type` string, nullable, required
    - `market_cap` string, nullable
    - `optimization_enabled` boolean, nullable, required
    - `package_name` string, nullable
    - `reputation` string, nullable, required
    - `transactions_count` integer, nullable
    - `verified_at` string, date-time, nullable, 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)