Transactions

Get a transaction by ID

get/v1/agents/{agent_id}/transactions/{tx_id}

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/agents/{agent_id}/transactions/{tx_id}
  • Auth: HTTP bearer

Path parameters

agent_idstring uuid required
tx_idstring uuid required

Query parameters

include_signed_txboolean

Set to true or 1 to include the raw signed transaction hex in the response. Omitted by default to reduce key exfiltration risk. Only the literal values "true" or "1" enable inclusion; any other value or omission returns responses without signed_tx. Applies to GET /v1/agents/{agent_id}/transactions and GET /v1/agents/{agent_id}/transactions/{tx_id}.

Response

Transaction details

idstring uuid
agent_idstring uuid
chainstring
chain_idinteger
tostring
value_weistring
status'pending' | 'signed' | 'sign_only' | 'broadcast' | 'confirmed' | 'reverted' | 'dropped' | 'failed' | 'simulation_failed'

broadcast means the RPC accepted the raw transaction; it does not mean the transaction mined. The receipt reconciler resolves it to confirmed, reverted or dropped once the chain answers. reverted mined and failed on-chain (nonce consumed, gas paid); dropped never mined and never will (the sender's nonce has moved past it), so no value moved and no gas was paid. Non-EVM chains reach confirmed/reverted but never dropped, because the absence of a transaction there cannot be distinguished from a node having pruned it.

signed_txstring nullable

Raw signed transaction hex. On GET list and GET by id, this property is omitted by default (absent from the response). Pass include_signed_tx=true on those endpoints to include it. Always present on the initial POST submit response.

tx_hashstring
error_messagestring
created_atstring date-time
signed_atstring date-time
simulation_idstring
simulation_statusstring
tenderly_dashboard_urlstring uri
max_fee_per_gasstring
max_priority_fee_per_gasstring
from_addressstring

Sender, learned from the chain by the receipt reconciler.

block_numberinteger

Block (EVM), slot (Solana) or ledger index (XRP) the transaction settled in. Absent until it settles.

confirmed_atstring date-time

When settlement was observed. Absent for a dropped transaction, which never settled.

reconciled_atstring date-time

Last time the reconciler asked the chain about this transaction. Set while status is still broadcast means we looked and could not tell yet, as distinct from nobody having looked.

Changes

No recorded changes to this operation across all 2 revisions of this API.