How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Hedera

Hedera contracts API

The contracts objects represents the information associated with contract entities.The contracts list endpoint is cached and not updated as frequently as the contract lookup by a specific ID endpoint.

Documentation Provider Profile APIs.io OpenAPI GitHub

Hedera contracts API is one of 10 APIs that Hedera publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Contracts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and rate-limit docs.

This API exposes 12 operations across 12 paths, and defines 38 schemas. It is described by OpenAPI 3.2.0, at version 0.156.0.

Requests are made against a single base URL, {scheme}://{network}.mirrornode.hedera.com.

12 operations 12 paths 38 schemas 11 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.156.0
Base URL
https://mainnet.mirrornode.hedera.com
Contact
Mirror Node Team
License
Apache-2.0
Resource Areas
1

Paths & Operations 12

Across 12 paths, the API surfaces 12 operations — 11 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

contracts 12

The contracts objects represents the information associated with contract entities.The contracts list endpoint is cached and not updated as frequently as the contract lookup by a…

POST
/api/v1/contracts/call
Invoke a smart contract
contractCall body → 200400404415429500501
GET
/api/v1/contracts
List contract entities on network
getContracts 3 params → 200400
GET
/api/v1/contracts/{contractIdOrAddress}
Get contract by id
getContract 2 params → 200400404
GET
/api/v1/contracts/{contractIdOrAddress}/results
List contract results from a contract on the network
getContractResultsByContractId 9 params → 200400
GET
/api/v1/contracts/{contractIdOrAddress}/state
The contract state from a contract on the network
getContractState 5 params → 200400
GET
/api/v1/contracts/{contractIdOrAddress}/results/{timestamp}
Get the contract result from a contract on the network executed at a given timestamp
getContractResultByIdAndTimestamp 3 params → 200206400404
GET
/api/v1/contracts/results
List contract results from all contracts on the network
getContractsResults 9 params → 200400
GET
/api/v1/contracts/results/{transactionIdOrHash}
Get the contract result from a contract on the network for a given transactionId or ethereum transaction hash
getContractResultByTransactionIdOrHash 3 params → 200206400404
GET
/api/v1/contracts/results/{transactionIdOrHash}/actions
Get the contract actions from a contract on the network for a given transactionId or ethereum transaction hash
getContractActions 4 params → 200400404
GET
/api/v1/contracts/results/{transactionIdOrHash}/opcodes
Get the opcode traces for a historical transaction on the network with the given transaction ID or hash
getContractOpcodes 4 params → 200400404429
GET
/api/v1/contracts/{contractIdOrAddress}/results/logs
List contract logs from a contract on the network
getContractLogsByContractId 9 params → 200400
GET
/api/v1/contracts/results/logs
List contracts logs across many contracts on the network
getContractsLogs 9 params → 200400

Schemas 38

The contract defines 38 schemas that model the data the API accepts and returns. The most detailed are ContractResult (33 properties), ContractAction (17 properties), Contract (16 properties), Opcode (9 properties). Each schema is shown below with its type and property counts.

Timestamp
string
A Unix timestamp in seconds.nanoseconds format
ContractResultLogs
array
EvmAddress
string
A network entity encoded as an EVM address in hex.
ContractResults
array
Error
object
1 property
ContractCallResponse
object
1 property
OpcodesResponse
object
6 properties 6 required
Bloom
stringnull
EvmAddressNullable
stringnull
A network entity encoded as an EVM address in hex.
ContractCallRequest
object
8 properties 1 required
ContractLog
ContractActions
array
Contracts
array
ContractLogs
array
ContractResultLog
object
6 properties
Links
object
1 property
ContractsResponse
object
2 properties
Key
objectnull
The public key which controls access to various network entities.
2 properties
ContractLogsResponse
object
2 properties
LogTopicQueryParam
array
ContractResultStateChange
object
5 properties
ContractActionsResponse
object
2 properties
Contract
object
16 properties
ContractResultDetails
ContractResultsResponse
object
2 properties
Opcode
object
Represents a struct/opcode log entry in a trace
9 properties 8 required
TimestampNullable
stringnull
A Unix timestamp in seconds.nanoseconds format
ContractState
object
5 properties 5 required
ContractStateResponse
object
2 properties
AuthorizationList
object
6 properties
ContractResult
object
33 properties
ContractLogTopics
array
A list of hex encoded topics associated with this log event
AccessList
object
2 properties
ContractResultStateChanges
array
EntityId
stringnull
Network entity ID in the format of shard.realm.num
ContractAction
object
17 properties
TimestampRange
object
A timestamp range an entity is valid for
2 properties
ContractResponse

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hedera-contracts-api-openapi.yml Raw ↑

Other APIs Hedera publishes across the network.

Hedera accounts API
AE Profile APIs.io
Hedera airdrops API
AE Profile APIs.io
Hedera balances API
AE Profile APIs.io
Hedera blocks API
AE Profile APIs.io
Hedera network API
AE Profile APIs.io
Hedera schedules API
AE Profile APIs.io
Hedera tokens API
AE Profile APIs.io
Hedera topics API
AE Profile APIs.io
Hedera transactions API
AE Profile APIs.io
#Contracts
← Back to H APIs
API Details
ID
hedera:hedera-contracts-api
Base URL
https://mainnet.mirrornode.hedera.com
Docs
https://docs.hedera.com/hedera/sdks-and-apis/rest-api
Provider
Hedera
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=hedera-contracts-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/hedera-contracts-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Hedera contracts API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.