Status

Get record status

Get the current state of a record that was written to the blockchain. It takes a few minutes before any transaction is confirmed to be on the blockchain.

GET{your-URL}/api/v1/records/{txId}/status

Path parameters

txId*string

The transaction id of the record to query. Using a value other than a id returned by write record produces undefined behavior.

Header parameters

Response

200400404500

The transaction has been published. The response is an application/json structure containing:

• confirmation: set if transaction has been included in a valid block
  • confirmedBlocks: Number of confirmations (blocks) at the time of request
  • blockHash: block hash if transaction has been included in a block
  • blockTimestamp: block header timestamp (set on a best-effort basis)
  • merkleProof: A JSON object as defined in TSC Merkle Proof (https://tsc.bsvblockchain.org/standards/merkle-proof-standardised-format/#JSONform)

Body

text/plainapplication/jsontext/json

confirmationConfirmation (object)

Request

JavaScriptCurlPython

const response = await fetch('{your-URL}/api/v1/records/{txId}/status', {
    method: 'GET',
    headers: {
      "x-api-key": "text"
    },
});
const data = await response.json();

Response

200400404500

{
  "confirmation": {
    "confirmedBlocks": 0,
    "blockHash": "text",
    "blockTimestamp": "2024-12-22T03:41:53.767Z",
    "merkleProof": {
      "index": 0,
      "txOrId": "text",
      "target": "text",
      "nodes": [
        "text"
      ],
      "targetType": "text",
      "proofType": "text",
      "composite": false
    }
  }
}