Skip to main content
GET
/
v2
/
tx
/
status
cURL
curl --request GET \
  --url https://api.skip.build/v2/tx/status
{
  "state": "STATE_SUBMITTED",
  "transfer_sequence": [
    {
      "ibc_transfer": {
        "to_chain_id": "<string>",
        "packet_txs": {
          "acknowledge_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "error": {
            "details": "<unknown>",
            "message": "<string>",
            "type": "PACKET_ERROR_UNKNOWN"
          },
          "receive_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "send_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "timeout_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          }
        },
        "from_chain_id": "<string>",
        "state": "TRANSFER_UNKNOWN"
      },
      "axelar_transfer": {
        "to_chain_id": "<string>",
        "from_chain_id": "<string>",
        "state": "AXELAR_TRANSFER_UNKNOWN",
        "txs": {
          "contract_call_with_token_txs": {
            "approve_tx": {
              "explorer_link": "<string>",
              "chain_id": "<string>",
              "tx_hash": "<string>",
              "on_chain_at": "<string>"
            },
            "confirm_tx": {
              "explorer_link": "<string>",
              "chain_id": "<string>",
              "tx_hash": "<string>",
              "on_chain_at": "<string>"
            },
            "error": {
              "message": "<string>",
              "type": "CONTRACT_CALL_WITH_TOKEN_EXECUTION_ERROR"
            },
            "execute_tx": {
              "explorer_link": "<string>",
              "chain_id": "<string>",
              "tx_hash": "<string>",
              "on_chain_at": "<string>"
            },
            "gas_paid_tx": {
              "explorer_link": "<string>",
              "chain_id": "<string>",
              "tx_hash": "<string>",
              "on_chain_at": "<string>"
            },
            "send_tx": {
              "explorer_link": "<string>",
              "chain_id": "<string>",
              "tx_hash": "<string>",
              "on_chain_at": "<string>"
            }
          }
        },
        "axelar_scan_link": "<string>",
        "type": "AXELAR_TRANSFER_CONTRACT_CALL_WITH_TOKEN"
      },
      "cctp_transfer": {
        "to_chain_id": "<string>",
        "from_chain_id": "<string>",
        "state": "CCTP_TRANSFER_UNKNOWN",
        "txs": {
          "send_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "receive_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          }
        }
      },
      "hyperlane_transfer": {
        "from_chain_id": "<string>",
        "to_chain_id": "<string>",
        "state": "HYPERLANE_TRANSFER_UNKNOWN",
        "txs": {
          "send_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "receive_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          }
        }
      },
      "op_init_transfer": {
        "to_chain_id": "<string>",
        "from_chain_id": "<string>",
        "state": "OPINIT_TRANSFER_UNKNOWN",
        "txs": {
          "send_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "receive_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          }
        }
      },
      "stargate_transfer": {
        "from_chain_id": "<string>",
        "to_chain_id": "<string>",
        "state": "STARGATE_TRANSFER_UNKNOWN",
        "txs": {
          "send_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "receive_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "error_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          }
        }
      },
      "go_fast_transfer": {
        "from_chain_id": "<string>",
        "to_chain_id": "<string>",
        "state": "GO_FAST_TRANSFER_UNKNOWN",
        "txs": {
          "order_submitted_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "order_filled_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "order_refunded_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "order_timeout_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          }
        },
        "error_message": "<string>"
      },
      "eureka_transfer": {
        "from_chain_id": "<string>",
        "to_chain_id": "<string>",
        "state": "TRANSFER_UNKNOWN",
        "packet_txs": {
          "acknowledge_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "error": {
            "details": "<unknown>",
            "message": "<string>",
            "type": "PACKET_ERROR_UNKNOWN"
          },
          "receive_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "send_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "timeout_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          }
        }
      },
      "layer_zero_transfer": {
        "from_chain_id": "<string>",
        "to_chain_id": "<string>",
        "state": "LAYER_ZERO_TRANSFER_UNKNOWN",
        "txs": {
          "send_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "receive_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "compose_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          },
          "error_tx": {
            "explorer_link": "<string>",
            "chain_id": "<string>",
            "tx_hash": "<string>",
            "on_chain_at": "<string>"
          }
        }
      }
    }
  ],
  "transfers": [
    {
      "state": "STATE_SUBMITTED",
      "transfer_sequence": [
        {
          "ibc_transfer": {
            "to_chain_id": "<string>",
            "packet_txs": {
              "acknowledge_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "error": {
                "details": "<unknown>",
                "message": "<string>",
                "type": "PACKET_ERROR_UNKNOWN"
              },
              "receive_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "send_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "timeout_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              }
            },
            "from_chain_id": "<string>",
            "state": "TRANSFER_UNKNOWN"
          },
          "axelar_transfer": {
            "to_chain_id": "<string>",
            "from_chain_id": "<string>",
            "state": "AXELAR_TRANSFER_UNKNOWN",
            "txs": {
              "contract_call_with_token_txs": {
                "approve_tx": {
                  "explorer_link": "<string>",
                  "chain_id": "<string>",
                  "tx_hash": "<string>",
                  "on_chain_at": "<string>"
                },
                "confirm_tx": {
                  "explorer_link": "<string>",
                  "chain_id": "<string>",
                  "tx_hash": "<string>",
                  "on_chain_at": "<string>"
                },
                "error": {
                  "message": "<string>",
                  "type": "CONTRACT_CALL_WITH_TOKEN_EXECUTION_ERROR"
                },
                "execute_tx": {
                  "explorer_link": "<string>",
                  "chain_id": "<string>",
                  "tx_hash": "<string>",
                  "on_chain_at": "<string>"
                },
                "gas_paid_tx": {
                  "explorer_link": "<string>",
                  "chain_id": "<string>",
                  "tx_hash": "<string>",
                  "on_chain_at": "<string>"
                },
                "send_tx": {
                  "explorer_link": "<string>",
                  "chain_id": "<string>",
                  "tx_hash": "<string>",
                  "on_chain_at": "<string>"
                }
              }
            },
            "axelar_scan_link": "<string>",
            "type": "AXELAR_TRANSFER_CONTRACT_CALL_WITH_TOKEN"
          },
          "cctp_transfer": {
            "to_chain_id": "<string>",
            "from_chain_id": "<string>",
            "state": "CCTP_TRANSFER_UNKNOWN",
            "txs": {
              "send_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "receive_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              }
            }
          },
          "hyperlane_transfer": {
            "from_chain_id": "<string>",
            "to_chain_id": "<string>",
            "state": "HYPERLANE_TRANSFER_UNKNOWN",
            "txs": {
              "send_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "receive_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              }
            }
          },
          "op_init_transfer": {
            "to_chain_id": "<string>",
            "from_chain_id": "<string>",
            "state": "OPINIT_TRANSFER_UNKNOWN",
            "txs": {
              "send_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "receive_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              }
            }
          },
          "stargate_transfer": {
            "from_chain_id": "<string>",
            "to_chain_id": "<string>",
            "state": "STARGATE_TRANSFER_UNKNOWN",
            "txs": {
              "send_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "receive_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "error_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              }
            }
          },
          "go_fast_transfer": {
            "from_chain_id": "<string>",
            "to_chain_id": "<string>",
            "state": "GO_FAST_TRANSFER_UNKNOWN",
            "txs": {
              "order_submitted_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "order_filled_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "order_refunded_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "order_timeout_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              }
            },
            "error_message": "<string>"
          },
          "eureka_transfer": {
            "from_chain_id": "<string>",
            "to_chain_id": "<string>",
            "state": "TRANSFER_UNKNOWN",
            "packet_txs": {
              "acknowledge_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "error": {
                "details": "<unknown>",
                "message": "<string>",
                "type": "PACKET_ERROR_UNKNOWN"
              },
              "receive_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "send_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "timeout_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              }
            }
          },
          "layer_zero_transfer": {
            "from_chain_id": "<string>",
            "to_chain_id": "<string>",
            "state": "LAYER_ZERO_TRANSFER_UNKNOWN",
            "txs": {
              "send_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "receive_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "compose_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              },
              "error_tx": {
                "explorer_link": "<string>",
                "chain_id": "<string>",
                "tx_hash": "<string>",
                "on_chain_at": "<string>"
              }
            }
          }
        }
      ],
      "next_blocking_transfer": {
        "transfer_sequence_index": 123
      },
      "transfer_asset_release": {
        "chain_id": "<string>",
        "denom": "<string>",
        "amount": "<string>",
        "released": true
      },
      "error": {
        "details": {
          "code": 123,
          "message": "<string>"
        },
        "message": "<string>",
        "type": "STATUS_ERROR_UNKNOWN"
      }
    }
  ],
  "next_blocking_transfer": {
    "transfer_sequence_index": 123
  },
  "transfer_asset_release": {
    "chain_id": "<string>",
    "denom": "<string>",
    "amount": "<string>",
    "released": true
  },
  "error": {
    "details": {
      "code": 123,
      "message": "<string>"
    },
    "message": "<string>",
    "type": "STATUS_ERROR_UNKNOWN"
  },
  "status": "STATE_COMPLETED"
}

Query Parameters

tx_hash
string
required

Hex encoded hash of the transaction to query for

chain_id
string
required

Chain ID of the transaction

Response

The status of the transaction and any subsequent ibc or Axelar transfers.

state
enum<string>
required

The overall state reflecting the end-to-end status of all transfers initiated by the original transaction.

Available options:
STATE_SUBMITTED,
STATE_PENDING,
STATE_ABANDONED,
STATE_COMPLETED_SUCCESS,
STATE_COMPLETED_ERROR,
STATE_PENDING_ERROR
transfer_sequence
object[]
required
deprecated

DEPRECATED. This field provides a flat list of all transfer events. For a more structured and detailed status of each transfer leg, including its individual events, please use the 'transfers' array instead. This field may be removed in a future version.

transfers
object[]

Transfer status for all transfers initiated by the transaction in the order they were initiated.

next_blocking_transfer
object

Details about the next transfer in the sequence that is preventing further progress, if any.

transfer_asset_release
object

Indicates location and denom of transfer asset release.

error
object

Details about any error encountered during the transaction or its subsequent transfers.

status
string

A high-level status indicator for the transaction's completion state.

Example:

"STATE_COMPLETED"