> ## Documentation Index
> Fetch the complete documentation index at: https://xoxno.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# txStatus

> Transaction confirmation events with status and optional failure reason.

The server pushes this event when a transaction's on-chain status changes. It reaches subscribers of `tx-status/{hash}` (one transaction) or `address/{sender}` (all transactions from that sender).

## Topic

`tx-status/{hash}` or `address/{sender}` via [subscribe](/api-reference/ws/subscribe)

## Event fields

<ResponseField name="type" type="string">
  Value is `"txStatus"`.
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="properties" defaultOpen>
    <ResponseField name="hash" type="string">
      Transaction hash.
    </ResponseField>

    <ResponseField name="status" type="string">
      One of `"success"`, `"pending"`, `"fail"`, `"invalid"`, `"dropped"`.
    </ResponseField>

    <ResponseField name="reason" type="string">
      Present when `status` is `"fail"`. Describes the on-chain failure (e.g., `"execution failed"`, `"insufficient funds"`).
    </ResponseField>

    <ResponseField name="sender" type="string">
      Sender address in bech32 format. Included when the notifier provides it.
    </ResponseField>
  </Expandable>
</ResponseField>

When delivered via `address/{sender}`, this event arrives alongside `accountDelta` events. Use the `type` field to distinguish them.

<ResponseExample>
  ```json Success theme={"system"}
  {
    "type": "txStatus",
    "data": {
      "hash": "a1b2c3d4e5f6...",
      "status": "success",
      "reason": null,
      "sender": "erd1spyavw0956vq68xj8y4tenjpq2wd5a9p2c6j8gsz7ztyrnpxrruqzu66jx"
    }
  }
  ```

  ```json Failure theme={"system"}
  {
    "type": "txStatus",
    "data": {
      "hash": "a1b2c3d4e5f6...",
      "status": "fail",
      "reason": "execution failed",
      "sender": "erd1spyavw0956vq68xj8y4tenjpq2wd5a9p2c6j8gsz7ztyrnpxrruqzu66jx"
    }
  }
  ```
</ResponseExample>