Transaction Operations
resource: transaction — lookups, status, hex, merkle proofs, spend status, and broadcast
get
Returns full transaction details for a txid. Esplora's own JSON shape is returned as-is.
| Field | Type | Required | Description |
|---|---|---|---|
txid | text | ✓ Yes | Transaction ID (hex). |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
getStatus
Returns just the confirmation state — lighter than get when that's all you need.
| Field | Type | Required | Description |
|---|---|---|---|
txid | text | ✓ Yes | Transaction ID. |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
Example response:
{
"confirmed": true,
"blockHeight": 831422,
"blockHash": "00000000000000000001a2b3...",
"blockTime": 1717000000
}All three block fields are null while confirmed is false.
getHex
Returns the transaction's raw hex encoding.
| Field | Type | Required | Description |
|---|---|---|---|
txid | text | ✓ Yes | Transaction ID. |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
getMerkleProof
Returns the transaction's Merkle inclusion proof against its containing block.
| Field | Type | Required | Description |
|---|---|---|---|
txid | text | ✓ Yes | Transaction ID. |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
getOutspend
Returns whether a specific output of a transaction has been spent, and by what.
| Field | Type | Required | Description |
|---|---|---|---|
txid | text | ✓ Yes | Transaction ID. |
vout | number | No (default 0) | Output index to check. |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
getOutspends
Returns spend status for every output of a transaction in one call.
| Field | Type | Required | Description |
|---|---|---|---|
txid | text | ✓ Yes | Transaction ID. |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
broadcast
Submits a raw signed transaction to the network. This is the final step after
psbt/extract produces the raw hex — it does not
wrap or reinterpret it in any way.
| Field | Type | Required | Description |
|---|---|---|---|
rawTransactionHex | text | ✓ Yes | Fully-signed raw transaction hex (from psbt/extract). |
expectedTxid | text | No | If supplied, the node can cross-check this is the transaction you expect before submitting. |
network | select | ✓ Yes | Fund-moving — must be explicit. |
Example response:
{
"txid": "8f3c...e21a",
"alreadyKnown": false
}| Response Field | Meaning |
|---|---|
txid | Bare txid string — a real Esplora broadcast endpoint returns just the id, not a nested status object. Poll getStatus separately for confirmation. |
alreadyKnown | true when this exact transaction was already accepted or confirmed — an "already known" rejection from Esplora is treated as an idempotent success, not an error, so a lost-response retry never falsely reports failure for a broadcast that actually went through. |