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

# Get Transaction Status

> Polls the current status of a transaction that was previously registered with Track Transaction (`POST /v2/tx/track`). Returns the overall status and the state of each hop in the transfer sequence.

Call this endpoint repeatedly until the status reaches a terminal state (e.g. `STATE_COMPLETED` or `STATE_FAILED`). This is useful for showing transfer progress in your UI.



## OpenAPI

````yaml /api-reference/router-api/openapi.yaml get /v2/tx/status
openapi: 3.1.0
info:
  title: Router API
  description: Cross-chain transfer routing API for the Initia ecosystem.
  version: 1.0.0
servers:
  - url: https://router-api.initia.xyz
    description: Mainnet
  - url: https://router-api.initiation-2.initia.xyz
    description: Testnet
security: []
paths:
  /v2/tx/status:
    get:
      tags:
        - Tracking Transactions
      summary: Get Transaction Status
      description: >-
        Polls the current status of a transaction that was previously registered
        with Track Transaction (`POST /v2/tx/track`). Returns the overall status
        and the state of each hop in the transfer sequence.


        Call this endpoint repeatedly until the status reaches a terminal state
        (e.g. `STATE_COMPLETED` or `STATE_FAILED`). This is useful for showing
        transfer progress in your UI.
      operationId: getTransactionStatus
      parameters:
        - name: tx_hash
          in: query
          required: true
          description: The transaction hash to check.
          schema:
            type: string
        - name: chain_id
          in: query
          required: true
          description: The chain ID where the transaction was submitted.
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  state:
                    type: string
                    description: >-
                      Overall end-to-end transaction state (e.g.
                      STATE_SUBMITTED, STATE_PENDING, STATE_COMPLETED_SUCCESS,
                      STATE_COMPLETED_ERROR, STATE_ABANDONED,
                      STATE_PENDING_ERROR).
                  transfers:
                    type: array
                    description: Transfer status for all transfers in the route.
                    items:
                      type: object
                  transfer_sequence:
                    type: array
                    description: >-
                      Deprecated. Flat list of transfer events in sequence
                      order.
                    items:
                      type: object
                      properties:
                        src_chain_id:
                          type: string
                        dst_chain_id:
                          type: string
                        state:
                          type: string
                  next_blocking_transfer:
                    type: object
                    nullable: true
                    description: The next transfer that is blocking progress, if any.
                    properties:
                      transfer_sequence_index:
                        type: integer
                  transfer_asset_release:
                    type: object
                    nullable: true
                    description: Information about released assets.
                    properties:
                      chain_id:
                        type: string
                      denom:
                        type: string
                      amount:
                        type: string
                        nullable: true
                      released:
                        type: boolean
                  error:
                    type: object
                    nullable: true
                    description: Error details if the transaction failed.
              example:
                state: STATE_COMPLETED_SUCCESS
                transfers: []
                transfer_sequence:
                  - src_chain_id: interwoven-1
                    dst_chain_id: '8453'
                    state: TRANSFER_SUCCESS
                next_blocking_transfer: null
                transfer_asset_release: null
                error: null

````