BTbtcpayserver
Transactions

Get transaction by ID

Changed on

Retrieves details of a specific transaction by its transaction ID (txId) for the specified cryptocurrency.

get/v1/cryptos/{cryptoCode}/transactions/{txId}

Request

Path parameters

cryptoCodestring required

The cryptocurrency code to track (e.g., 'BTC' for Bitcoin, 'LTC' for Litecoin).

txIdstring required

The transaction ID to retrieve.

Query parameters

includeTransactionboolean

Optional. If set to true, the response will include the raw transaction data in hexadecimal format (transaction field). Default is true.

Response

Transaction details retrieved successfully.

blockIdstring nullable

The hash of the block containing this transaction. Will be null if the transaction is unconfirmed.

confirmationsinteger

Number of confirmations the transaction has.

heightinteger nullable

The block height. Will be null if the transaction is unconfirmed.

transactionHashstring

The transaction ID.

transactionstring

Raw transaction in hex format. Included only if includeTransaction is true.

timestampinteger

The UNIX timestamp indicating when the transaction was first seen by NBXplorer.

replacedBystring nullable

If present, indicates the transaction ID that replaced this transaction via RBF.

Example response

{
  "blockId": "7639350b31f3ce07ff976ebae772fef1602b30a10ccb8ca69047fe0fe8b9083c",
  "confirmations": 1,
  "height": 876593,
  "transactionHash": "14a679cd743f3d2aa51b998747c58dfa9b31c8c669006fc6c6efe4b4f5f76e5b",
  "transaction": "02000000000101b596e23a22ea753251a5da4b7d415604dc05ab7c45ff675e077ed60a0d0a8d277401000000fdffffff0126010000000000001600140e48fd70dbb5af35119bfe7d626944c48c98ed9d0340e6c77a58ede14930d83002f05b8a13320a4140ab40a45b7f677f05c7653479d62b3d121823503563096156429b8fe5d818381812b4854ed3f59ec999b6fca8a94420afd36e561af10735e88f95d9655e5b3f7bc79de0a4781ef99d1e030c0c567422ac0063036f7264510a746578742f706c61696e000d3837363537382e6269746d61706821c0afd36e561af10735e88f95d9655e5b3f7bc79de0a4781ef99d1e030c0c56742200000000",
  "metadata": {
    "vsize": 141,
    "fees": 2820,
    "feeRate": 20,
    "chunk": {
      "fees": 2820,
      "weight": 564,
      "feeRate": 20
    }
  },
  "timestamp": 1540376171,
  "replacedBy": "8fdac258458f9216b035b30a62ca0400697d76a83f50cd7dc18eb8352e936cf2"
}

Changes

  • 52231f42c765Revision changes
    • breaking

      for the query request parameter includeTransaction, default value was changed from false to true

    • breaking

      the response property became nullable for the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      api operation id GetTransaction was added

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

  • c7263f21ffa4Revision changes
    • info

      added the optional property / to the response with the status