LogoLogo
HomeMetadata APIAPI PROTwitter
Etherscan V2
Etherscan V2
  • Introduction
  • Chef's Pick
  • Rate Limits
  • V1 to V2 API Migration Guide
  • ✨Getting Started
    • Creating an Account
    • Getting an API Key
    • Supported Chains
    • Supported Endpoints
  • 🎯API Endpoints
    • Nametags
    • Accounts
    • Contracts
    • Transactions
    • Blocks
    • Logs
    • Geth/Parity Proxy
    • Tokens
    • Gas Tracker
    • Stats
    • L2 Deposits/Withdrawals
    • Usage
  • 🏆API PRO
    • Etherscan API PRO
    • Metadata/Name Tag API
  • 🍳Cookbook
    • Track Uniswap V4 DEX Trades
  • Get An Address's Full Transaction History
  • 🤝Support
    • FAQ
    • Legacy V1 Docs
    • Checking Usage
    • Common Error Messages
    • Getting Help
  • Visit Etherscan.io
Powered by GitBook
On this page
  • Check Contract Execution Status
  • Check Transaction Receipt Status
  1. API Endpoints

Transactions

PreviousContractsNextBlocks

Last updated 8 months ago

Check Contract Execution Status

Returns the status code of a contract execution.

https://api.etherscan.io/v2/api
   ?chainid=1&module=transaction
   &action=getstatus
   &txhash=0x15f8e5ea1079d9a0bb04a4c58ae5fe7654b5b2b4463375ff7ffb490aa0032f3a
   &apikey=YourApiKeyToken

Try this endpoint in your

Query Parameters

Parameter
Description

txhash

the string representing the transaction hash to check the execution status

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":{
      "isError":"1",
      "errDescription":"Bad jump destination"
   }
}

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 transactions.

https://api.etherscan.io/v2/api
   ?chainid=1&module=transaction
   &action=gettxreceiptstatus
   &txhash=0x513c1ba0bebf66436b5fed86ab668452b7805593c05073eb2d51d3a52f480a76
   &apikey=YourApiKeyToken

Query Parameters

Parameter
Description

txhash

the string representing the transaction hash to check the execution status

Sample Response

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

Try this endpoint in your

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

🎯
📖
🔗
📖
📝
browser
Byzantium Fork
🔗
browser