Transactions

Check Contract Execution Status

Returns the status code of a contract execution.

https://api-optimistic.etherscan.io/api
   ?module=transaction
   &action=getstatus
   &txhash=0x0ee7a526ccaf6539e4278b9df1b2280a3954bf7f6f77e6c12188ffff3ad8ad3e
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
txhash	the string representing the transaction hash to check the execution status

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":{
      "isError":"1",
      "errDescription":"execution reverted"
   }
}

📖 Tip: The isError field returns 0 for successful transactions and 1 for failed transactions.

Check Transaction Receipt Status

Returns the status code of a transaction execution.

📝 Note: Only applicable for post Byzantium Fork transactions.

https://api-optimistic.etherscan.io/api
   ?module=transaction
   &action=gettxreceiptstatus
   &txhash=0xd7bc69a71d64ac389d38e3d8af6920f7a218c2c9df7086b682e9406dcde64877
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
txhash	the string representing the transaction hash to check the execution status

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":{
      "status":"1"
   }
}

📖 Tip: The status field returns 0 for failed transactions and 1 for successful transactions.