Get Contract by ID

Return the contract information given an id.

This method will use 20 Compute Units.

---

Get contract by id

Return the contract information given an id

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/contracts/{contractIdOrAddress}

Path parameters

contractIdOrAddress*string

The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.

Pattern: ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40})$

Query parameters

Response

200400404

OK

Body

application/json

admin_keynullable Key (object)

auto_renew_accountnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

auto_renew_periodnullable integer (int64)

Example: 7776000

contract_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

created_timestampnullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

deletedboolean

Example: false

evm_addressEvmAddress (string (binary))

A network entity encoded as an EVM address in hex.

Example: "0000000000000000000000000000000000001f41"

Pattern: ^(0x)?[A-Fa-f0-9]{40}$

expiration_timestampnullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

file_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

max_automatic_token_associationsnullable integer (int32)

memostring

Example: "contract memo"

obtainer_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

permanent_removalnullable boolean

proxy_account_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

timestampTimestampRange (object)

A timestamp range an entity is valid for

bytecodenullable string (binary)

The contract bytecode in hex during deployment

Example: "0x01021a1fdc9b"

runtime_bytecodenullable string (binary)

The contract bytecode in hex after deployment

Example: "0x0302fa1ad39c"

Request

JavaScriptCurlPython

const response = await fetch('https://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/contracts/{contractIdOrAddress}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400404

{
  "admin_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "auto_renew_account": "0.1.2",
  "auto_renew_period": 7776000,
  "contract_id": "0.1.2",
  "created_timestamp": "1586567700.453054000",
  "deleted": false,
  "evm_address": "0000000000000000000000000000000000001f41",
  "expiration_timestamp": "1586567700.453054000",
  "file_id": "0.1.2",
  "max_automatic_token_associations": 0,
  "memo": "contract memo",
  "obtainer_id": "0.1.2",
  "permanent_removal": false,
  "proxy_account_id": "0.1.2",
  "timestamp": {
    "from": {},
    "to": {}
  },
  "bytecode": "0x01021a1fdc9b",
  "runtime_bytecode": "0x0302fa1ad39c"
}