Transactions

Check Contract Execution Status

Returns the status code of a contract execution.

https://api.basescan.org/api
   ?module=transaction
   &action=getstatus
   &txhash=0x4de3556b73420442ffd825927028bca98c75eb196d8b9e41e5f2ab7dd145a5f1
   &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.basescan.org/api
   ?module=transaction
   &action=gettxreceiptstatus
   &txhash=0x8291daa460156d59c6153a480eaa32c35af4817e0934b09b53be90344733f216
   &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.