Smart Contract Verification API

Overview

The Sourcify API enables programmatic access to smart contract verification services, allowing developers to verify contract source code, check verification status, and retrieve verified contract files. Sourcify is a decentralized, open-source verification service that’s essential for developers and auditors who need to confirm smart contract transparency by proving that the deployed bytecode matches the published source code across EVM-compatible networks.

Sourcify natively supports Hedera Mainnet (chain ID 295) and Hedera Testnet (chain ID 296), so verification on Hedera uses the same API and tooling as any other supported chain.

Key Features

• Contract Verification: Submit smart contract source code and metadata for verification against deployed bytecode on any supported network.
• Multiple Verification Methods: Support for Solidity Standard JSON input, Solidity metadata.json uploads, Etherscan-verified contract import, and similarity-based verification.
• Verification Job Tracking: Asynchronous verification jobs with a verificationId so you can poll for status.
• Contract Lookup: Query verified contract data by address and chain ID, list verified contracts on a given chain, or search all chains for a single address.
• Multi-Chain Support: Compatible with every chain Sourcify recognizes, including Hedera Mainnet and Testnet.

Hedera previously operated a self-hosted Sourcify instance at verify.hashscan.io and server-verify.hashscan.io. Requests to those hosts are forwarded to sourcify.dev so existing integrations continue to work, but the legacy endpoints are deprecated. Please update your tooling and scripts to call sourcify.dev directly.

Hedera Chain IDs

Network	Chain ID
Hedera Mainnet	295
Hedera Testnet	296

Base URL

https://sourcify.dev/server

📣 For interactive API exploration and testing, visit https://sourcify.dev/server/api-docs/

Endpoints

Verify Contracts

Method	Endpoint	Description
POST	/v2/verify/{chainId}/{address}	verify a contract using Solidity Standard JSON input
POST	/v2/verify/metadata/{chainId}/{address}	verify a contract using a Solidity metadata.json file
POST	/v2/verify/etherscan/{chainId}/{address}	import and verify a contract that’s already verified on Etherscan
POST	/v2/verify/similarity/{chainId}/{address}	verify a contract via similarity search against existing verified contracts

Verification Jobs

Method	Endpoint	Description
GET	/v2/verify/{verificationId}	check the status of a verification job by its verificationId

Contract Lookup

Method	Endpoint	Description
GET	/v2/contract/{chainId}/{address}	fetch verification status and source files for a contract on a specific chain
GET	/v2/contract/all-chains/{address}	look up a single address across every chain Sourcify supports
GET	/v2/contracts/{chainId}	paginated list of verified contracts on a given chain

System

Method	Endpoint	Description
GET	/health	service health check
GET	/version	running server version
GET	/chains	list of supported and deprecated chains

API Reference

The full Sourcify v2 API reference (including request/response schemas, authentication details, and worked examples) lives in the official Sourcify documentation:

➡ Sourcify v2 API Documentation

➡ Sourcify Server Swagger UI

➡ Sourcify Web UI

Verifying with Developer Tools

Most developers verify contracts through their build tooling rather than calling the API directly. Both Foundry and Hardhat have first-class Sourcify support:

Deploy and Verify a Smart Contract with Foundry

Deploy and Verify a Smart Contract with Hardhat

Writer: Luke, DevRel Engineer

GitHub | X

Editor: Krystal, Senior DX Engineer

GitHub | X | LinkedIn