> For the complete documentation index, see [llms.txt](https://docs.getblock.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getblock.io/api-reference/tron-trx/tron-grpc-api/gettransactionbyid-tron.md).

# GetTransactionById - Tron

This method returns a transaction by its id, including its contract data, signatures, and result.

## Service

This method is served by the `protocol.Wallet` and `protocol.WalletSolidity` service.

{% hint style="info" %}
This is a read method. It is also served by `protocol.WalletSolidity`, which returns only confirmed, irreversible data. Use the Solidity service for balance and payment verification.
{% endhint %}

## Method

```protobuf
rpc GetTransactionById (BytesMessage) returns (Transaction)
```

## Request Message

`BytesMessage`

| Field | Type  | Description                            |
| ----- | ----- | -------------------------------------- |
| value | bytes | The transaction id (hash) as raw bytes |

## Request

{% tabs %}
{% tab title="grpcurl" %}
{% code overflow="wrap" %}

```bash
grpcurl -H 'x-api-key: <ACCESS-TOKEN>' \
  -d '{"value": "d5ec749ecc2a615399d8a6c864ea4c74ff9f523c2be0e341ac9be5d47d7c2d62"}' \
  shared.eu-central-1.getblock.io:443 protocol.Wallet/GetTransactionById
```

{% endcode %}
{% endtab %}

{% tab title="Python" %}
{% code title="example.py" %}

```python
import grpc
# Stubs generated from java-tron's api.proto with grpcio-tools
from api import api_pb2_grpc
from core import Contract_pb2, Tron_pb2

creds = grpc.ssl_channel_credentials()
channel = grpc.secure_channel('shared.eu-central-1.getblock.io:443', creds)
metadata = [('x-api-key', '<ACCESS-TOKEN>')]
stub = api_pb2_grpc.WalletStub(channel)

response = stub.GetTransactionById(api_pb2.BytesMessage(value=bytes.fromhex('d5ec749ecc2a615399d8a6c864ea4c74ff9f523c2be0e341ac9be5d47d7c2d62')), metadata=metadata)
print(response)
```

{% endcode %}
{% endtab %}

{% tab title="Go" %}
{% code title="example.go" %}

```go
conn, _ := grpc.Dial(
    "shared.eu-central-1.getblock.io:443",
    grpc.WithTransportCredentials(credentials.NewTLS(&tls.Config{})),
)
defer conn.Close()

client := api.NewWalletClient(conn)
ctx := metadata.AppendToOutgoingContext(
    context.Background(), "x-api-key", "<ACCESS-TOKEN>")

resp, _ := client.GetTransactionById(ctx, &api.BytesMessage{Value: txidBytes})
fmt.Println(resp)
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Response Message

`Transaction`

| Field     | Type            | Description                                       |
| --------- | --------------- | ------------------------------------------------- |
| raw\_data | raw             | The transaction's contracts and metadata          |
| signature | repeated bytes  | Signatures over the transaction                   |
| ret       | repeated Result | Transaction result, with the contract return code |

## Use Cases

* **Transaction Views**: Render a transaction's contract and result
* **Payment Confirmation**: Read a transfer's amount and parties
* **Signature Inspection**: Read the signatures on a transaction
* **Debugging**: Inspect the raw contract data

## Error Handling

| Code | Status            | Description                                                 |
| ---- | ----------------- | ----------------------------------------------------------- |
| 3    | INVALID\_ARGUMENT | A request field is missing or malformed                     |
| 5    | NOT\_FOUND        | The requested account, block, or transaction does not exist |
| 16   | UNAUTHENTICATED   | The access token is missing or invalid                      |
| 13   | INTERNAL          | The node failed to process the request                      |