---
updatedAt: 2025-06-11T20:38:41.000Z
agentTools:
  projectIndex: https://docs.allthatnode.com/llms.txt
---

# Get transactions by hash

Get a transaction

Upon success, the `Cache-Control` header will be set with the default
maximum age.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "CometBFT RPC",
    "contact": {
      "name": "CometBFT",
      "url": "https://cometbft.com/"
    },
    "description": "CometBFT supports the following RPC protocols:\n\n* URI over HTTP\n* JSONRPC over HTTP\n* JSONRPC over websockets\n\n## Configuration\n\nRPC can be configured by tuning parameters under `[rpc]` table in the\n`$CMTHOME/config/config.toml` file or by using the `--rpc.X` command-line\nflags.\n\nThe default RPC listen address is `tcp://127.0.0.1:26657`.\nTo set another address, set the `laddr` config parameter to desired value.\nCORS (Cross-Origin Resource Sharing) can be enabled by setting\n`cors_allowed_origins`, `cors_allowed_methods`, `cors_allowed_headers`\nconfig parameters.\n\nIf testing using a local RPC node, under the `[rpc]`\nsection change the `cors_allowed_origins` property, please add the URL of\nthe site where this OpenAPI document is running, for example:\n\n  `cors_allowed_origins = [\"http://localhost:8088\"]`\n\nor if testing from the official documentation site:\n\n  `cors_allowed_origins = [\"https://docs.cometbft.com\"]`\n\n## Arguments\n\nArguments which expect strings or byte arrays may be passed as quoted\nstrings, like `\"abc\"` or as `0x`-prefixed strings, like `0x616263`.\n\n## URI/HTTP\n\nA REST like interface.\n\n    curl localhost:26657/block?height=5\n\n## JSONRPC/HTTP\n\nJSONRPC requests can be POST'd to the root RPC endpoint via HTTP.\n\n    curl --header \"Content-Type: application/json\" --request POST --data '{\"method\": \"block\", \"params\": [\"5\"], \"id\": 1}' localhost:26657\n\n## JSONRPC/websockets\n\nJSONRPC requests can be also made via websocket.\nThe websocket endpoint is at `/websocket`, e.g. `localhost:26657/websocket`.\nAsynchronous RPC functions like event `subscribe` and `unsubscribe` are\nonly available via websockets.\n\nFor example using the [websocat](https://github.com/vi/websocat) tool, you can subscribe for 'NewBlock` events\nwith the following command:\n\n    echo '{ \"jsonrpc\": \"2.0\",\"method\": \"subscribe\",\"id\": 0,\"params\": {\"query\": \"tm.event='\"'NewBlock'\"'\"} }' | websocat -n -t ws://127.0.0.1:26657/websocket\n",
    "version": "v0.38.x",
    "license": {
      "name": "Apache 2.0",
      "url": "https://github.com/cometbft/cometbft/blob/v0.38.x/LICENSE"
    }
  },
  "servers": [
    {
      "url": "https://rpc.cosmos.directory/cosmoshub",
      "description": "Interact with the CometBFT RPC from a public node in the Cosmos registry"
    },
    {
      "url": "http://localhost:26657",
      "description": "Interact with CometBFT RPC node running locally"
    }
  ],
  "tags": [
    {
      "name": "Info",
      "description": "Informations about the node APIs"
    }
  ],
  "paths": {
    "/tx": {
      "get": {
        "summary": "Get transactions by hash",
        "operationId": "tx",
        "parameters": [
          {
            "in": "query",
            "name": "hash",
            "description": "hash of transaction to retrieve",
            "required": true,
            "schema": {
              "type": "string",
              "example": "0xD70952032620CC4E2737EB8AC379806359D8E0B17B0488F627997A0B043ABDED"
            }
          },
          {
            "in": "query",
            "name": "prove",
            "description": "Include proofs of the transaction's inclusion in the block",
            "required": false,
            "schema": {
              "type": "boolean",
              "example": true,
              "default": false
            }
          }
        ],
        "tags": [
          "Info"
        ],
        "description": "Get a transaction\n\nUpon success, the `Cache-Control` header will be set with the default\nmaximum age.\n",
        "responses": {
          "200": {
            "description": "Get a transaction`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TxResponse"
                }
              }
            }
          },
          "500": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "JSONRPC": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "example": 0
          },
          "jsonrpc": {
            "type": "string",
            "example": "2.0"
          }
        }
      },
      "ErrorResponse": {
        "description": "Error Response",
        "allOf": [
          {
            "$ref": "#/components/schemas/JSONRPC"
          },
          {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "example": "Description of failure"
              }
            }
          }
        ]
      },
      "TxResponse": {
        "type": "object",
        "required": [
          "jsonrpc",
          "id",
          "result"
        ],
        "properties": {
          "jsonrpc": {
            "type": "string",
            "example": "2.0"
          },
          "id": {
            "type": "integer",
            "example": 0
          },
          "result": {
            "required": [
              "hash",
              "height",
              "index",
              "tx_result",
              "tx"
            ],
            "properties": {
              "hash": {
                "type": "string",
                "example": "D70952032620CC4E2737EB8AC379806359D8E0B17B0488F627997A0B043ABDED"
              },
              "height": {
                "type": "string",
                "example": "1000"
              },
              "index": {
                "type": "integer",
                "example": 0
              },
              "tx_result": {
                "required": [
                  "log",
                  "gas_wanted",
                  "gas_used",
                  "tags"
                ],
                "properties": {
                  "log": {
                    "type": "string",
                    "example": "[{\"msg_index\":\"0\",\"success\":true,\"log\":\"\"}]"
                  },
                  "gas_wanted": {
                    "type": "string",
                    "example": "200000"
                  },
                  "gas_used": {
                    "type": "string",
                    "example": "28596"
                  },
                  "tags": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/Event"
                    }
                  }
                },
                "type": "object"
              },
              "tx": {
                "type": "string",
                "example": "5wHwYl3uCkaoo2GaChQmSIu8hxpJxLcCuIi8fiHN4TMwrRIU/Af1cEG7Rcs/6LjTl7YjRSymJfYaFAoFdWF0b20SCzE0OTk5OTk1MDAwEhMKDQoFdWF0b20SBDUwMDAQwJoMGmoKJuta6YchAwswBShaB1wkZBctLIhYqBC3JrAI28XGzxP+rVEticGEEkAc+khTkKL9CDE47aDvjEHvUNt+izJfT4KVF2v2JkC+bmlH9K08q3PqHeMI9Z5up+XMusnTqlP985KF+SI5J3ZOIhhNYWRlIGJ5IENpcmNsZSB3aXRoIGxvdmU="
              }
            },
            "type": "object"
          }
        }
      },
      "Event": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "example": "action"
          },
          "value": {
            "type": "string",
            "example": "send"
          },
          "index": {
            "type": "boolean",
            "example": false
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```