contracts

List contract results from a contract on the network

Returns a list of all ContractResults for a contract's function executions.

get/api/v1/contracts/{contractIdOrAddress}/results

Path parameters

contractIdOrAddressstring required

Contract or account identifier in format shard.realm.num, realm.num, num or a 20-byte EVM address (with or without 0x prefix).

Query parameters

block.hashstring

The block's hash. If multiple values are provided the last value will be the only value used.

block.numberstring

The block's number

fromstring

Account ID or EVM address executing the contract

internalboolean

Whether to include child transactions or not

limitinteger

The maximum number of items to return

order'asc' | 'desc'

The order in which items are listed

timestampstring[]

The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

transaction.indexinteger

The transaction index in the block

Response

resultsContractResults — unresolved $ref

Changes

Changed in 4 of the 53 revisions of this API.3313

Jul 9, 2026v18ce3e9a7251e2See the full diff
- ▲
  the response property results/items/address became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/failed_initcode became nullable for the status 200
  response-property-became-nullable
May 26, 2026v1c00fd47f5f2511See the full diff
- ▲
  the results/items/access_list response's property type/format changed from string null/ to array/ for status 200
  response-property-type-changed
- ○
  added the optional property results/items/authorization_list to the response with the 200 status
  response-optional-property-added
May 14, 2026v1b940acac6e1d1See the full diff
- ○
  removed the non-success response with the status 404
  response-non-success-status-removed
Aug 8, 2025v1db389f03b0973011See the full diff
- ▲
  the response property _status/messages/items/data became nullable for the status 400
  response-property-became-nullable
- ▲
  the response property _status/messages/items/detail became nullable for the status 400
  response-property-became-nullable
- ▲
  the response property links/next became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/access_list became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/amount became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/block_gas_used became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/block_hash became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/block_number became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/bloom/allOf[Bloom]/ became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/call_result became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/chain_id became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/contract_id became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/created_contract_ids became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/created_contract_ids/items/ became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/error_message became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/from became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/function_parameters became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/gas_consumed became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/gas_price became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/gas_used became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/max_fee_per_gas became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/max_priority_fee_per_gas became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/nonce became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/r became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/s became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/to became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/transaction_index became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/type became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/v became nullable for the status 200
  response-property-became-nullable
- ▲
  the results/items/access_list response's property type/format changed from array/ to string/ for status 200
  response-property-type-changed
- ●
  removed the optional property results/items/authorization_list from the response with the 200 status
  response-optional-property-removed
- ○
  added the non-success response with the status 404
  response-non-success-status-added
This revision also has 22 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history