---
title: "BroadcastTx broadcast transaction."
method: POST
path: "/cosmos/tx/v1beta1/txs"
tags: ["Service"]
---

# BroadcastTx broadcast transaction.

`POST /cosmos/tx/v1beta1/txs`

## Request body

- CosmosTxV1beta1BroadcastTxRequest — BroadcastTxRequest is the request type for the Service.BroadcastTxRequest RPC method.
  - `mode` 'BROADCAST_MODE_UNSPECIFIED' | 'BROADCAST_MODE_BLOCK' | 'BROADCAST_MODE_SYNC' | 'BROADCAST_MODE_ASYNC' — BroadcastMode specifies the broadcast mode for the TxService.Broadcast RPC method. - BROADCAST_MODE_UNSPECIFIED: zero-value for mode ordering - BROADCAST_MODE_BLOCK: DEPRECATED: use BROADCAST_MODE_SYNC instead, BROADCAST_MODE_BLOCK is not supported by the SDK from v0.47.x onwards. - BROADCAST_MODE_SYNC: BROADCAST_MODE_SYNC defines a tx broadcasting mode where the client waits for a CheckTx execution response only. - BROADCAST_MODE_ASYNC: BROADCAST_MODE_ASYNC defines a tx broadcasting mode where the client returns immediately.
  - `tx_bytes` string, byte — tx_bytes is the raw transaction.

## Response `200`

A successful response.

- CosmosTxV1beta1BroadcastTxResponse — BroadcastTxResponse is the response type for the Service.BroadcastTx method.
  - `tx_response` CosmosBaseAbciV1beta1TxResponse — TxResponse defines a structure containing relevant tx data and metadata. The tags are stringified and the log is JSON decoded.
    - `code` integer — Response code.
    - `codespace` string
    - `data` string — Result bytes, if any.
    - `events` TendermintAbciEvent[] — Events defines all the events emitted by processing a transaction. Note, these events include those emitted by processing all the messages and those emitted from the ante. Whereas Logs contains the events, with additional metadata, emitted only by processing the messages.
      - `attributes` TendermintAbciEventAttribute[]
        - `index` boolean
        - `key` string
        - `value` string
      - `type` string
    - `gas_used` string, int64 — Amount of gas consumed by transaction.
    - `gas_wanted` string, int64 — Amount of gas requested for transaction.
    - `height` string, int64
    - `info` string — Additional information. May be non-deterministic.
    - `logs` CosmosBaseAbciV1beta1ABCIMessageLog[] — The output of the application's logger (typed). May be non-deterministic.
      - `events` CosmosBaseAbciV1beta1StringEvent[] — Events contains a slice of Event objects that were emitted during some execution.
        - `attributes` CosmosBaseAbciV1beta1Attribute[]
          - `key` string
          - `value` string
        - `type` string
      - `log` string
      - `msg_index` integer
    - `raw_log` string — The output of the application's logger (raw string). May be non-deterministic.
    - `timestamp` string — Time of the previous block. For heights > 1, it's the weighted median of the timestamps of the valid votes in the block.LastCommit. For height == 1, it's genesis time.
    - `tx` GoogleProtobufAny
      - `@type` string
    - `txhash` string — The transaction hash.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2025-05-21** `3874a03b0e7b` — 1 info
  - api operation id `UpgradeService_BroadcastTx` removed and replaced with `EvidenceService_BroadcastTx`
- **2025-05-09** `8dbfaa2bebb2` — 1 info
  - api operation id `CircuitService_BroadcastTx` removed and replaced with `UpgradeService_BroadcastTx`
- **2025-04-08** `21a675703a05` — 1 info
  - api operation id `AuthService_BroadcastTx` removed and replaced with `CircuitService_BroadcastTx`
- **2025-03-27** `4f349536c8f3` — 1 info
  - api operation id `FeegrantService_BroadcastTx` removed and replaced with `AuthService_BroadcastTx`
- **2025-02-24** `2ab9d24288c2` — 1 info
  - api operation id `CircuitService_BroadcastTx` removed and replaced with `FeegrantService_BroadcastTx`

[Full history](https://skmtc.dev/pokt-network/apis/http-api-console/changes/cosmos/tx/v1beta1/txs/post.md)

---

[API](https://skmtc.dev/pokt-network/apis/http-api-console.md) · [All operations](https://skmtc.dev/pokt-network/apis/http-api-console/llms.txt) · [OpenAPI document](https://skmtc.dev/pokt-network/apis/http-api-console/revisions/671fab54b729?raw)