contracts

Get contract by id

Return the contract information given an id

get/api/v1/contracts/{contractIdOrAddress}

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

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.

Response

ContractResponse required— unresolved $ref

Changes

Changed in 1 of the 53 revisions of this API.19

Aug 8, 2025v1db389f03b09719See 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/data became nullable for the status 404
  response-property-became-nullable
- ▲
  the response property _status/messages/items/detail became nullable for the status 400
  response-property-became-nullable
- ▲
  the response property _status/messages/items/detail became nullable for the status 404
  response-property-became-nullable
- ▲
  the response property allOf[Contract]/admin_key became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[Contract]/auto_renew_account became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[Contract]/auto_renew_period became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[Contract]/contract_id became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[Contract]/created_timestamp became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[Contract]/expiration_timestamp became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[Contract]/file_id became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[Contract]/max_automatic_token_associations became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[Contract]/nonce became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[Contract]/obtainer_id became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[Contract]/permanent_removal became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[Contract]/proxy_account_id became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[Contract]/timestamp/to/allOf[TimestampNullable]/ became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[subschema #2]/bytecode became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[subschema #2]/runtime_bytecode became nullable for the status 200
  response-property-became-nullable
This revision also has 22 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history