BSV blockchainBSV blockchain

Get the status of a transaction by path parameter

GET/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

Authorizationstring

Bearer token: Bearer <apiKey>

XDeployment-IDstring

Deployment identifier for correlating requests. Auto-generated if not set.

Path Parameters

txidstringrequired

Transaction ID (64 hex characters).

Response

Transaction status.

txidstring

Transaction ID.

txStatus"STORED" | "ANNOUNCED_TO_NETWORK" | "REQUESTED_BY_NETWORK" | "SENT_TO_NETWORK" | "ACCEPTED_BY_NETWORK" | "SEEN_ON_NETWORK" | "MINED" | "SEEN_IN_ORPHAN_MEMPOOL" | "DOUBLE_SPEND_ATTEMPTED" | "REJECTED" | "INVALID" | "MALFORMED" | "MINED_IN_STALE_BLOCK" | "UNKNOWN"

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
extraInfostring

Additional human-readable context about the status.

competingTxsstring[]

Present when txStatus is DOUBLE_SPEND_ATTEMPTED. Lists competing transaction IDs.

Unauthorized.

txidstring

Transaction ID if known at the time of error.

detailstring

Human-readable error detail. Mapped to description in BroadcastFailure.

statusinteger

HTTP status code echoed in the body (ARC convention).

titlestring

Short error title.

typestring<uri>

URI identifying the error type.

instancestring

URI identifying the specific occurrence.

extraInfostring

Transaction not found.

txidstring

Transaction ID if known at the time of error.

detailstring

Human-readable error detail. Mapped to description in BroadcastFailure.

statusinteger

HTTP status code echoed in the body (ARC convention).

titlestring

Short error title.

typestring<uri>

URI identifying the error type.

instancestring

URI identifying the specific occurrence.

extraInfostring
Request
curl -X GET "https://arc.taal.com/v1/tx/<txid>" \
  -H "Authorization: <Authorization>" \
  -H "XDeployment-ID: <XDeployment-ID>"
Response
{
  "txid": "string",
  "txStatus": "STORED",
  "extraInfo": "string",
  "competingTxs": [
    "string"
  ]
}