---
title: "List of verified contracts per chain"
method: GET
path: "/v2/contracts/{chainId}"
tags: ["Contract Lookup"]
---

# List of verified contracts per chain

`GET /v2/contracts/{chainId}`

Retrieve the verified contracts on a chain

## Path parameters

- `chainId` 31318 | 42431 | 4217, required

## Query parameters

- `sort` 'asc' | 'desc'
- `limit` number
- `afterMatchId` string

## Response `200`

Returns an array of VerifiedContractMinimal objects under `results` field.

If not verified on any chain, the `results` array will be empty.

- object
  - `results` object[]
    - `match` string, required
    - `creationMatch` string, required
    - `runtimeMatch` string, required
    - `chainId` string, required
    - `address` string, required — Contract Address in hex string. Can be checksummed or not (i.e. can contain capital letters)
    - `verifiedAt` string, date-time, nullable — Timestamp when the contract was verified by Sourcify-compatible bytecode matching. `null` for Tempo-native contracts that only expose curated source.
    - `matchId` string, nullable — Identifier of the verified contract match. `null` for Tempo-native contracts that only expose curated source.

## Other responses

- `400` — Bad request from the client
- `429` — You are sending too many requests to the server
- `500`

## Changes

> 5 revisions in range; 1 could not be searched.

- **2026-03-09** `eef63cd83966` — 2 breaking, 5 info
  - the `path` request parameter `chainId` was restricted to a list of enum values
  - for the `path` request parameter `chainId`, the type/format was changed from `string`/`` to `integer`/``
  - added the new enum value `31318.00` to the `path` request parameter `chainId`
  - added the new enum value `4217.00` to the `path` request parameter `chainId`
  - …3 more
- **2025-12-17** `f02ddb386819` — 5 breaking, 1 warning, 1 info
  - removed the enum value `31318.00` from the `path` request parameter `chainId`
  - removed the enum value `4217.00` from the `path` request parameter `chainId`
  - removed the enum value `42431.00` from the `path` request parameter `chainId`
  - for the `path` request parameter `chainId`, the minLength was increased from `0` to `1`
  - …3 more

[Change history](https://skmtc.dev/tempoxyz/apis/contract-verification-api/changes/v2/contracts/:chainId/get.md)

---

[API](https://skmtc.dev/tempoxyz/apis/contract-verification-api.md) · [All operations](https://skmtc.dev/tempoxyz/apis/contract-verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tempoxyz/contract-verification-api/revisions/a76585f33723/schema)