# /v1/transactions/by\_hash/{transaction\_hash} - Aptos This endpoint gets a transaction from the Aptos blockchain by its **transaction hash**. Every transaction has a unique hash that can be used to retrieve full details. ## Supported network * Mainnet ## Parameter | **Parameter** | **Type** | **In** | **Required** | **Description** | | ----------------- | -------- | ------ | ------------ | ----------------------- | | transaction\_hash | String | Path | Yes | Hash of the transaction | ## Request **Base URL** ```bash https://go.getblock.io/ ``` **Example(cURL)** ```curl curl --location 'https://go.getblock.io//v1/transactions/by_hash/0xd797b944ed8657406a1b09a5928048093399fc0a2f576d3e57c0f9cedbf95c4a' ``` ## Response Example ```json { "version": "3556737308", "hash": "0x4c3248d4c2f3a5ca1617e43e69332c66586478871ee44634cdb4554fe537dff6", "state_change_hash": "0x50148eff819eeb093efbe1cb56936ba02b3169db3343f5df0cb47aba016ea227", "event_root_hash": "0x1c432ce28a587287ef8abf14f025b78f5e288e886f16f217919cd2e35274f5f3", "state_checkpoint_hash": null, "gas_used": "195", "success": false, "vm_status": "Move abort in 0x31deb490728ae8e1a89675ee4c1877af8e5849c526d2c9a64238c49d8ece08a0::fa: E_NO_PROFIT(0x385): ", "accumulator_root_hash": "0xdc354eb8f4a96e9267bab2727240965becd154e35a21fede212af96f56333955", "changes": [ { "address": "0xa", "state_key_hash": "0x1db5441d8fa4229c5844f73fd66da4ad8176cb8793d8b3a7f6ca858722030043", "data": { "type": "0x1::coin::PairedCoinType", "data": { "type": { "account_address": "0x1", "module_name": "0x6170746f735f636f696e", "struct_name": "0x4170746f73436f696e" } } }, "type": "write_resource" }, { "address": "0xa", "state_key_hash": "0x1db5441d8fa4229c5844f73fd66da4ad8176cb8793d8b3a7f6ca858722030043", "data": { "type": "0x1::coin::PairedFungibleAssetRefs", "data": { "burn_ref_opt": { "vec": [ { "metadata": { "inner": "0xa" } } ] }, "mint_ref_opt": { "vec": [ { "metadata": { "inner": "0xa" } } ] }, "transfer_ref_opt": { "vec": [ { "metadata": { "inner": "0xa" } } ] } } }, "type": "write_resource" }, { "address": "0xa", "state_key_hash": "0x1db5441d8fa4229c5844f73fd66da4ad8176cb8793d8b3a7f6ca858722030043", "data": { "type": "0x1::fungible_asset::ConcurrentSupply", "data": { "current": { "max_value": "340282366920938463463374607431768211455", "value": "25726501655234340" } } }, "type": "write_resource" }, { "address": "0xa", "state_key_hash": "0x1db5441d8fa4229c5844f73fd66da4ad8176cb8793d8b3a7f6ca858722030043", "data": { "type": "0x1::fungible_asset::Metadata", "data": { "decimals": 8, "icon_uri": "", "name": "Aptos Coin", "project_uri": "", "symbol": "APT" } }, "type": "write_resource" }, { "address": "0xa", "state_key_hash": "0x1db5441d8fa4229c5844f73fd66da4ad8176cb8793d8b3a7f6ca858722030043", "data": { "type": "0x1::object::ObjectCore", "data": { "allow_ungated_transfer": true, "guid_creation_num": "1125899906842625", "owner": "0x1", "transfer_events": { "counter": "0", "guid": { "id": { "addr": "0xa", "creation_num": "1125899906842624" } } } } }, "type": "write_resource" }, { "address": "0xa", "state_key_hash": "0x1db5441d8fa4229c5844f73fd66da4ad8176cb8793d8b3a7f6ca858722030043", "data": { "type": "0x1::primary_fungible_store::DeriveRefPod", "data": { "metadata_derive_ref": { "self": "0xa" } } }, "type": "write_resource" }, { "address": "0x60d8ef2e962b1d1b4f602c72e23eed6fbba86eefb41853a7688073fc918d912", "state_key_hash": "0x222b15ff81f90d75937ef6012807f0de0e0d488ccb5a229e55a954bc7870c75d", "data": { "type": "0x1::fungible_asset::FungibleStore", "data": { "balance": "566263899", "frozen": false, "metadata": { "inner": "0xa" } } }, "type": "write_resource" }, { "address": "0x60d8ef2e962b1d1b4f602c72e23eed6fbba86eefb41853a7688073fc918d912", "state_key_hash": "0x222b15ff81f90d75937ef6012807f0de0e0d488ccb5a229e55a954bc7870c75d", "data": { "type": "0x1::object::ObjectCore", "data": { "allow_ungated_transfer": false, "guid_creation_num": "1125899906842625", "owner": "0x31deb490728ae8e1a89675ee4c1877af8e5849c526d2c9a64238c49d8ece08a0", "transfer_events": { "counter": "0", "guid": { "id": { "addr": "0x60d8ef2e962b1d1b4f602c72e23eed6fbba86eefb41853a7688073fc918d912", "creation_num": "1125899906842624" } } } } }, "type": "write_resource" }, { "address": "0x95a0fd88b11286d4790c253b39c6678b798c54b54b63bfd2bfe042411ee2e3e8", "state_key_hash": "0xf389cd5138744eb2c2c40a6b708ff717cb7a04bec7c9c1b9b8847857eaf617cd", "data": { "type": "0x1::account::Account", "data": { "authentication_key": "0x95a0fd88b11286d4790c253b39c6678b798c54b54b63bfd2bfe042411ee2e3e8", "coin_register_events": { "counter": "0", "guid": { "id": { "addr": "0x95a0fd88b11286d4790c253b39c6678b798c54b54b63bfd2bfe042411ee2e3e8", "creation_num": "0" } } }, "guid_creation_num": "2", "key_rotation_events": { "counter": "0", "guid": { "id": { "addr": "0x95a0fd88b11286d4790c253b39c6678b798c54b54b63bfd2bfe042411ee2e3e8", "creation_num": "1" } } }, "rotation_capability_offer": { "for": { "vec": [] } }, "sequence_number": "1680", "signer_capability_offer": { "for": { "vec": [] } } } }, "type": "write_resource" } ], "sender": "0x95a0fd88b11286d4790c253b39c6678b798c54b54b63bfd2bfe042411ee2e3e8", "sequence_number": "1679", "max_gas_amount": "5000", "gas_unit_price": "100", "expiration_timestamp_secs": "1760341246", "payload": { "function": "0x31deb490728ae8e1a89675ee4c1877af8e5849c526d2c9a64238c49d8ece08a0::lesserafim_3::crazy", "type_arguments": [ "0x1::aptos_coin::AptosCoin", "0x111ae3e5bc816a5e63c2da97d0aa3886519e0cd5e4b046659fa35796bd11542a::stapt_token::StakedApt", "0xf22bede237a07e121b56d91a491eb7bcdfd1f5907926a9e58338f964a01b17fa::asset::USDC", "0x159df6b7689437016108a019fd5bef736bac692b6d4a1f10c941f6fbb9a74ca6::oft::CakeOFT", "0x8d87a65ba30e09357fa2edea2c80dbac296e5dec2b18287113500b902942929d::celer_coin_manager::UsdcCoin", "0x1::aptos_coin::AptosCoin", "u64", "u64", "u64", "u64", "u64" ], "arguments": [ "0x010f0a0101", "0x01010101010000", [ "25", "10", "30", "25", "25" ], [ { "inner": "0xa" }, { "inner": "0xa" }, { "inner": "0xa" }, { "inner": "0xa" }, { "inner": "0xa" }, { "inner": "0xa" } ], [ "0x1", "0x5669f388059383ab806e0dfce92196304205059874fd845944137d96bbdfc8de", "0x1", "0x1", "0x1" ], [ false, true, false, true, false ], "28452012" ], "type": "entry_function_payload" }, "signature": { "sender": { "public_key": "0x1e9d94603ebd6b4a1d38e760be2b0523f09fb1f59e1e43c657f0ab3ef6205427", "signature": "0x05f71501658fdc40b6f42f71d6c298a378434a5825af5bc0efcc15aba2aa38625064612139299f43ae40e710bad18ce0b9935dee00b705285a8f73318f06a301", "type": "ed25519_signature" }, "secondary_signer_addresses": [], "secondary_signers": [], "fee_payer_address": "0x31deb490728ae8e1a89675ee4c1877af8e5849c526d2c9a64238c49d8ece08a0", "fee_payer_signer": { "public_key": "0x17dfb6544cf49621c75af067528755a38061bdd210342f8bdf565bcdf561f056", "signature": "0x7866a52d642e7442671d0614cf7b201a29bdbd8b709ea59462d32917c368f596d771ab6592d1659952970cb277a35d536d0966a754c2cd610858f8c04eb93e08", "type": "ed25519_signature" }, "type": "fee_payer_signature" }, "replay_protection_nonce": null, "events": [ { "guid": { "creation_number": "0", "account_address": "0x0" }, "sequence_number": "0", "type": "0x1::transaction_fee::FeeStatement", "data": { "execution_gas_units": "130", "io_gas_units": "65", "storage_fee_octas": "0", "storage_fee_refund_octas": "0", "total_charge_gas_units": "195" } } ], "timestamp": "1760341227055115", "type": "user_transaction" } ``` ## Response parameter Definition | **Field** | **Type** | **Description** | | ----------------------- | -------- | ------------------------------------------------------------------------- | | version | String | Global transaction version number. | | hash | String | Transaction hash used for lookup. | | state\_change\_hash | String | Hash of all state changes from this transaction. | | event\_root\_hash | String | Merkle root hash of emitted events. | | state\_checkpoint\_hash | String | State checkpoint hash for this transaction. | | gas\_used | String | Amount of gas consumed. | | success | Boolean | Whether execution succeeded. | | vm\_status | String | Aptos VM execution result. | | accumulator\_root\_hash | String | Ledger accumulator root hash. | | changes | Array | State changes caused (may be empty). | | timestamp | String | Unix timestamp in microseconds. | | block\_end\_info | Object | Block execution metadata. | | type | String | Transaction type (e.g., user\_transaction, block\_epilogue\_transaction). | ## Use cases This method can be used for: * Retrieve any transaction directly by hash (common for explorers and wallets). * Debug and verify contract execution results. * Cross-reference hash → version → block for indexing. * Track system and user transactions separately. ## Code example **Node(axios)** ```js const axios = require('axios'); let config = { method: 'get', maxBodyLength: Infinity, url: 'https://go.getblock.io//v1/transactions/by_hash/0xd797b944ed8657406a1b09a5928048093399fc0a2f576d3e57c0f9cedbf95c4a', }; axios.request(config) .then((response) => { console.log(JSON.stringify(response.data)); }) .catch((error) => { console.log(error); }); ``` **Python(Request)** ```python import requests url = "https://go.getblock.io//v1/transactions/by_hash/0xd797b944ed8657406a1b09a5928048093399fc0a2f576d3e57c0f9cedbf95c4a" response = requests.request("GET", url, headers=headers, data=payload) print(response.text) ``` ## Error handling | **Status Code** | **Error Message** | **Cause** | | --------------- | ------------------------ | ---------------------------------------------- | | **400** | Invalid transaction hash | Hash format is invalid (not hex or malformed). | | **403** | Forbidden | Missing or invalid \. | | **500** | Internal server error | Node or network issue; retry later. | ## Integration with Web3 By integrating `/v1/transactions/by_hash/{txn_hash}`, developers can: * Fetch transactions directly from wallet or explorer UIs. * Debug dApps by verifying hash results against VM status. * Enable search bars in explorers where users paste transaction hashes. * Support analytics pipelines that track txns by hash across modules.