# tx - NEAR Protocol This method returns the **full details of a transaction** on the NEAR blockchain, including its status, outcome, receipts, and metadata. ## Supported Networks * Mainnet ## Parameters Description | **Parameter** | **Type** | **Required** | **Description** | | --------------------- | -------- | ------------ | ------------------------------------------------------------- | | **transaction\_hash** | string | Yes | The hash of the transaction to retrieve. | | **signer\_id** | string | Yes | The NEAR account ID of the sender who signed the transaction. | ## Request Example **Base URL** ```bash https://go.getblock.io/ ``` **Example(cURL)** ```bash curl -X POST https://go.getblock.io/ \ -H "Content-Type: application/json" \ -d '{"jsonrpc": "2.0", "method": "tx", "params": ["Ce4DPVFyDRdx54iLoSiKA6gqwGnE5V4mTZyVvFDQsvmN","relay.aurora"], "id": "getblock.io"}' ``` ## Response Example ```json { "jsonrpc": "2.0", "id": "getblock.io", "result": { "status": { "SuccessValue": "" }, "transaction": { "signer_id": "sender.testnet", "public_key": "ed25519:Gowpa4kXNyTMRKgt5W7147pmcc2PxiFic8UHW9rsNvJ6", "nonce": 15, "receiver_id": "receiver.testnet", "actions": [ { "Transfer": { "deposit": "1000000000000000000000000" } } ], "signature": "ed25519:3168QMdTpcwHvM1dmMYBc8hg9J3Wn8n7MWBSE9WrEpns6P5CaY87RM6k4uzyBkQuML38CZhU18HzmQEevPG1zCvk", "hash": "6zgh2u9DqHHiXzdy9ouTP7oGky2T4nugqzqt9wJZwNFm" }, "transaction_outcome": { "proof": [ { "hash": "F7mL76CMdfbdZ3xCehVGNh1fCyaR37gr3MeGX3EZkiVf", "direction": "Right" } ], "block_hash": "ADTMLVtkhsvzUxuf6m87Pt1dnF5vi1yY7ftxmNpFx7y", "id": "6zgh2u9DqHHiXzdy9ouTP7oGky2T4nugqzqt9wJZwNFm", "outcome": { "logs": [], "receipt_ids": [ "3dMfwczW5GQqXbD9GMTnmf8jy5uACxG6FC5dWxm3KcXT" ], "gas_burnt": 223182562500, "tokens_burnt": "22318256250000000000", "executor_id": "sender.testnet", "status": { "SuccessReceiptId": "3dMfwczW5GQqXbD9GMTnmf8jy5uACxG6FC5dWxm3KcXT" } } }, "receipts_outcome": [ { "proof": [ { "hash": "6h95oEd7ih62KXfyPT4zsZYont4qy9sWEXc5VQVDhqtG", "direction": "Right" }, { "hash": "6DnibgZk1T669ZprcehUy1GpCSPw1kjzXRGu69nSaUNn", "direction": "Right" } ], "block_hash": "GgFTVr33r4MrpAiHc9mr8TZqLnpZAX1BaZTNvhBnciy2", "id": "3dMfwczW5GQqXbD9GMTnmf8jy5uACxG6FC5dWxm3KcXT", "outcome": { "logs": [], "receipt_ids": [ "46KYgN8ddxs4Qy8C7BDQH49XUfcYZsaQmAvdU1nfcL9V" ], "gas_burnt": 223182562500, "tokens_burnt": "22318256250000000000", "executor_id": "receiver.testnet", "status": { "SuccessValue": "" } } }, { "proof": [ { "hash": "CD9Y7Bw3MSFgaPZzpc1yP51ajhGDCAsR61qXcMNcRoHf", "direction": "Left" } ], "block_hash": "EGAgKuW6Bd6QKYSaxAkx2pPGmnjrjAcq4UpoUiqMXvPH", "id": "46KYgN8ddxs4Qy8C7BDQH49XUfcYZsaQmAvdU1nfcL9V", "outcome": { "logs": [], "receipt_ids": [], "gas_burnt": 0, "tokens_burnt": "0", "executor_id": "sender.testnet", "status": { "SuccessValue": "" } } } ] } } ``` ## Response Parameters Definition | **Field** | **Type** | **Description** | | --------------------------------------------------------- | -------- | -------------------------------------------------------------- | | **receipts\_outcome** | array | The receipts outcome for the transaction. | | **receipts\_outcome.block\_hash** | string | The hash of the block this transaction was associated with. | | **receipts\_outcome.id** | string | The transaction ID. | | **receipts\_outcome.outcome** | object | The outcome associated with the transaction. | | **receipts\_outcome.outcome.executor\_id** | string | The ID of the transaction originator. | | **receipts\_outcome.outcome.gas\_burnt** | integer | The gas burnt while executing the transaction. | | **receipts\_outcome.outcome.logs** | array | Logs for the application being executed by this transaction. | | **receipts\_outcome.outcome.metadata** | object | Describes transaction metadata and contextual information. | | **receipts\_outcome.outcome.gas\_profile** | array | Details about gas usage, cost, and category. | | **receipts\_outcome.outcome.gas\_profile.cost** | string | The cost of the gas used. | | **receipts\_outcome.outcome.gas\_profile.cost\_category** | string | The category of the gas cost (e.g., compute, storage). | | **receipts\_outcome.outcome.gas\_profile.gas\_used** | string | The total amount of gas used. | | **receipts\_outcome.outcome.version** | string | Version number of the transaction execution. | | **receipts\_outcome.outcome.receipt\_ids** | array | The IDs of receipts generated by the transaction. | | **receipts\_outcome.outcome.status** | string | The status of the transaction (e.g., Success, Failure). | | **receipts\_outcome.outcome.successReceiptId** | string | The transaction ID of the successful receipt. | | **receipts\_outcome.outcome.tokens\_burnt** | string | The amount of tokens burnt during execution. | | **receipts\_outcome.proof** | array | The cryptographic proof for the transaction. | | **receipts\_outcome.proof.hash** | string | The hash of the proof. | | **receipts\_outcome.proof.direction** | string | The proof direction. | | **receipts\_outcome.status** | string | Final transaction status. | | **receipts\_outcome.successValue** | string | Value successfully sent after execution. | | **transaction** | object | The transaction object containing metadata and action details. | | **transaction.actions** | array | Actions performed within the transaction. | | **transaction.actions.FunctionCall** | object | Represents a function call action on the `receiver_id`. | | **transaction.actions.FunctionCall.args** | string | Transaction-specific arguments (Base64-encoded). | | **transaction.actions.FunctionCall.deposit** | string | Amount of tokens deposited (in yoctoNEAR). | | **transaction.actions.FunctionCall.gas** | integer | Gas allocated for function execution. | | **transaction.actions.FunctionCall.method\_name** | string | The method being called on the contract. | | **transaction.hash** | string | Hash of the transaction. | | **transaction.nonce** | integer | Number of prior transactions from the signer (nonce). | | **transaction.public\_key** | string | The public key of the signer. | | **transaction.receiver\_id** | string | The account ID of the transaction receiver. | | **transaction.signature** | string | The standard `ed25519` signature type. | | **transaction.signer\_id** | string | The account ID of the transaction originator. | | **transaction\_outcome** | object | The main transaction outcome object. | | **transaction\_outcome.block\_hash** | string | The hash of the block this transaction was associated with. | | **transaction\_outcome.id** | string | The transaction ID. | | **transaction\_outcome.outcome** | object | The outcome associated with transaction execution. | | **transaction\_outcome.outcome.executor\_id** | string | The executor of the transaction. | | **transaction\_outcome.outcome.gas\_burnt** | integer | Gas consumed during execution. | | **transaction\_outcome.outcome.logs** | array | Logs generated by the transaction. | | **transaction\_outcome.outcome.metadata** | object | Describes transaction execution metadata. | | **transaction\_outcome.outcome.gas\_profile** | array | Details of gas consumption and categorization. | | **transaction\_outcome.outcome.version** | string | Version number of transaction outcome. | | **transaction\_outcome.outcome.receipt\_ids** | array | The IDs of the receipts generated. | | **transaction\_outcome.outcome.status** | string | Status of the transaction execution. | | **transaction\_outcome.outcome.successReceiptId** | string | ID of the successful receipt. | | **transaction\_outcome.outcome.tokens\_burnt** | string | Total tokens burnt. | | **transaction\_outcome.proof** | array | Cryptographic proof of the transaction. | | **transaction\_outcome.proof.hash** | string | Hash value of the proof. | | **transaction\_outcome.proof.direction** | string | Direction of the proof in Merkle path. | ## Use Cases * Retrieve **transaction status** and validate results. * Track **gas consumption and receipts**. * Display **user transaction history** in wallets or explorers. * Debug and **trace smart contract executions**. ## Code Example **Node(axios)** ```js import axios from 'axios'; let data = JSON.stringify({ "jsonrpc": "2.0", "method": "tx", "params": [ "Ce4DPVFyDRdx54iLoSiKA6gqwGnE5V4mTZyVvFDQsvmN", "relay.aurora" ], "id": "getblock.io" }); let config = { method: 'post', maxBodyLength: Infinity, url: 'https://go.getblock.io/', headers: { 'Content-Type': 'application/json' }, data : data }; axios.request(config) .then((response) => { console.log(JSON.stringify(response.data)); }) .catch((error) => { console.log(error); }); ``` **Python(Requests)** ```python import requests import json url = "https://go.getblock.io/" payload = json.dumps({ "jsonrpc": "2.0", "method": "tx", "params": [ "Ce4DPVFyDRdx54iLoSiKA6gqwGnE5V4mTZyVvFDQsvmN", "relay.aurora" ], "id": "getblock.io" }) headers = { 'Content-Type': 'application/json' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text) ``` ## Error Handling | **HTTP Code** | **Error Message** | **Description** | | ----------------------------- | --------------------------------------- | ------------------------------------------------ | | **400 Bad Request** | `Invalid transaction hash or signer_id` | Missing or malformed transaction parameters. | | **403 Forbidden** | `RBAC: access denied` | The getblock access token is missing or incrrect | | **500 Internal Server Error** | `Node processing error` | The NEAR node failed to process the request. | | **503 Service Unavailable** | `Node temporarily unavailable` | The node is syncing or temporarily offline. | ## Integration with Web3 By integrating `tx` into dApp, developers can: * Build **blockchain explorers** and **wallet transaction trackers**. * Verify transaction confirmations and receipts. * Automate **transaction monitoring** for smart contracts and bots. * Improve **user experience** by showing accurate success/failure messages. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.getblock.io/api-reference/near-protocol-near/near_tx.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.