Documentation exported from Bitcoin Core 31.0

gettransaction (31.0.0 RPC)

blockchain

control

mining

network

rawtransactions

signer

util

wallet

zmq

gettransaction "txid" ( include_watchonly verbose )

Get detailed information about in-wallet transaction <txid>

Arguments:
1. txid                 (string, required) The transaction id
2. include_watchonly    (boolean, optional, default=false) (DEPRECATED) No longer used
3. verbose              (boolean, optional, default=false) Whether to include a `decoded` field containing the decoded transaction (equivalent to RPC decoderawtransaction)

Result:
{                                   (json object)
  "amount" : n,                     (numeric) The amount in BTC
  "fee" : n,                        (numeric, optional) The amount of the fee in BTC. This is negative and only available for the
                                    'send' category of transactions.
  "confirmations" : n,              (numeric) The number of confirmations for the transaction. Negative confirmations means the
                                    transaction conflicted that many blocks ago.
  "generated" : true|false,         (boolean, optional) Only present if the transaction's only input is a coinbase one.
  "trusted" : true|false,           (boolean, optional) Whether we consider the transaction to be trusted and safe to spend from.
                                    Only present when the transaction has 0 confirmations (or negative confirmations, if conflicted).
  "blockhash" : "hex",              (string, optional) The block hash containing the transaction.
  "blockheight" : n,                (numeric, optional) The block height containing the transaction.
  "blockindex" : n,                 (numeric, optional) The index of the transaction in the block that includes it.
  "blocktime" : xxx,                (numeric, optional) The block time expressed in UNIX epoch time.
  "txid" : "hex",                   (string) The transaction id.
  "wtxid" : "hex",                  (string) The hash of serialized transaction, including witness data.
  "walletconflicts" : [             (json array) Confirmed transactions that have been detected by the wallet to conflict with this transaction.
    "hex",                          (string) The transaction id.
    ...
  ],
  "replaced_by_txid" : "hex",       (string, optional) Only if 'category' is 'send'. The txid if this tx was replaced.
  "replaces_txid" : "hex",          (string, optional) Only if 'category' is 'send'. The txid if this tx replaces another.
  "mempoolconflicts" : [            (json array) Transactions in the mempool that directly conflict with either this transaction or an ancestor transaction
    "hex",                          (string) The transaction id.
    ...
  ],
  "to" : "str",                     (string, optional) If a comment to is associated with the transaction.
  "time" : xxx,                     (numeric) The transaction time expressed in UNIX epoch time.
  "timereceived" : xxx,             (numeric) The time received expressed in UNIX epoch time.
  "comment" : "str",                (string, optional) If a comment is associated with the transaction, only present if not empty.
  "bip125-replaceable" : "str",     (string) ("yes|no|unknown") Whether this transaction signals BIP125 replaceability or has an unconfirmed ancestor signaling BIP125 replaceability.
                                    May be unknown for unconfirmed transactions not in the mempool because their unconfirmed ancestors are unknown.
  "parent_descs" : [                (json array, optional) Only if 'category' is 'received'. List of parent descriptors for the output script of this coin.
    "str",                          (string) The descriptor string.
    ...
  ],
  "details" : [                     (json array)
    {                               (json object)
      "address" : "str",            (string, optional) The bitcoin address involved in the transaction.
      "category" : "str",           (string) The transaction category.
                                    "send"                  Transactions sent.
                                    "receive"               Non-coinbase transactions received.
                                    "generate"              Coinbase transactions received with more than 100 confirmations.
                                    "immature"              Coinbase transactions received with 100 or fewer confirmations.
                                    "orphan"                Orphaned coinbase transactions received.
      "amount" : n,                 (numeric) The amount in BTC
      "label" : "str",              (string, optional) A comment for the address/transaction, if any
      "vout" : n,                   (numeric) the vout value
      "fee" : n,                    (numeric, optional) The amount of the fee in BTC. This is negative and only available for the 
                                    'send' category of transactions.
      "abandoned" : true|false,     (boolean) 'true' if the transaction has been abandoned (inputs are respendable).
      "parent_descs" : [            (json array, optional) Only if 'category' is 'received'. List of parent descriptors for the output script of this coin.
        "str",                      (string) The descriptor string.
        ...
      ]
    },
    ...
  ],
  "hex" : "hex",                    (string) Raw data for transaction
  "decoded" : {                     (json object, optional) The decoded transaction (only present when `verbose` is passed)
    "txid" : "hex",                 (string) The transaction id
    "hash" : "hex",                 (string) The transaction hash (differs from txid for witness transactions)
    "size" : n,                     (numeric) The serialized transaction size
    "vsize" : n,                    (numeric) The virtual transaction size (differs from size for witness transactions)
    "weight" : n,                   (numeric) The transaction's weight (between vsize*4-3 and vsize*4)
    "version" : n,                  (numeric) The version
    "locktime" : xxx,               (numeric) The lock time
    "vin" : [                       (json array)
      {                             (json object)
        "coinbase" : "hex",         (string, optional) The coinbase value (only if coinbase transaction)
        "txid" : "hex",             (string, optional) The transaction id (if not coinbase transaction)
        "vout" : n,                 (numeric, optional) The output number (if not coinbase transaction)
        "scriptSig" : {             (json object, optional) The script (if not coinbase transaction)
          "asm" : "str",            (string) Disassembly of the signature script
          "hex" : "hex"             (string) The raw signature script bytes, hex-encoded
        },
        "txinwitness" : [           (json array, optional)
          "hex",                    (string) hex-encoded witness data (if any)
          ...
        ],
        "sequence" : n              (numeric) The script sequence number
      },
      ...
    ],
    "vout" : [                      (json array)
      {                             (json object)
        "value" : n,                (numeric) The value in BTC
        "n" : n,                    (numeric) index
        "scriptPubKey" : {          (json object)
          "asm" : "str",            (string) Disassembly of the output script
          "desc" : "str",           (string) Inferred descriptor for the output
          "hex" : "hex",            (string) The raw output script bytes, hex-encoded
          "address" : "str",        (string, optional) The Bitcoin address (only if a well-defined address exists)
          "type" : "str"            (string) The type (one of: nonstandard, anchor, pubkey, pubkeyhash, scripthash, multisig, nulldata, witness_v0_scripthash, witness_v0_keyhash, witness_v1_taproot, witness_unknown)
        },
        "ischange" : true|false     (boolean, optional) Output script is change (only present if true)
      },
      ...
    ]
  },
  "lastprocessedblock" : {          (json object) hash and height of the block this information was generated on
    "hash" : "hex",                 (string) hash of the block this information was generated on
    "height" : n                    (numeric) height of the block this information was generated on
  }
}

Examples:
> bitcoin-cli gettransaction "1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d"
> bitcoin-cli gettransaction "1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d" true
> bitcoin-cli gettransaction "1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d" false true
> curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "gettransaction", "params": ["1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d"]}' -H 'content-type: application/json' http://127.0.0.1:8332/