Get the status of a transaction by path parameter
/v1/tx/{txid}Retrieves the current network status of a transaction using the txid as a path parameter. Semantically equivalent to GET /v1/tx?txid={txid}.
Header Parameters
Bearer token: Bearer <apiKey>
Deployment identifier for correlating requests. Auto-generated if not set.
Path Parameters
Transaction ID (64 hex characters).
Response
Transaction status.
Transaction ID.
Network status of the transaction as reported by ARC. Success statuses (HTTP 200, not treated as failure):
- STORED — received but not yet broadcast
- ANNOUNCED_TO_NETWORK — gossiped to peers
- REQUESTED_BY_NETWORK — requested by a peer
- SENT_TO_NETWORK — submitted to the network
- ACCEPTED_BY_NETWORK — accepted by at least one miner
- SEEN_ON_NETWORK — seen propagating on the network
- MINED — included in a block (Merkle proof available)
- SEEN_IN_ORPHAN_MEMPOOL — in an orphan block mempool (not a stable success) Failure statuses (HTTP 200 body, treated as BroadcastFailure by ts-sdk):
- DOUBLE_SPEND_ATTEMPTED
- REJECTED
- INVALID
- MALFORMED
- MINED_IN_STALE_BLOCK
- (any value containing “ORPHAN” in extraInfo or txStatus) Unknown:
- UNKNOWN
Additional human-readable context about the status.
Present when txStatus is DOUBLE_SPEND_ATTEMPTED. Lists competing
transaction IDs.
Unauthorized.
Transaction ID if known at the time of error.
Human-readable error detail. Mapped to description in BroadcastFailure.
HTTP status code echoed in the body (ARC convention).
Short error title.
URI identifying the error type.
URI identifying the specific occurrence.
Transaction not found.
Transaction ID if known at the time of error.
Human-readable error detail. Mapped to description in BroadcastFailure.
HTTP status code echoed in the body (ARC convention).
Short error title.
URI identifying the error type.
URI identifying the specific occurrence.