OriginStamp Docs

# Check a tree's status

Status Changes

Because of the timestamping interval and blockchain network times, we cannot exactly predict when a timestamp is going to be tamper-proof. Instead of polling the API for tree status updates, you should rely on the automatic webhook notification via your API Key settings notification.

For querying the status of hashes for a certain blockchain it is best to use the provided treeId field by which the hash is linked.

You can look up on how to send a status request in our API Reference (opens new window).

An example response looks as follows:

{
  "treeId": "4dc4c401-5a55-48ee-802c-3f1659b10aa5",
  "currencyId": 0,
  "currency": "BTC",
  "submitStatus": 3,
  "timestamp": 1710000000000,
  "rootHash": "dc19dddc4e9f8742e31cbbaafe894daa01760f32b11d5cce29224981cef4ba1b",
  "transactionHash": "9f2c93c0edc444f17e6a96c771f34243c0978be4cf90c5d33bb8bfb5a1e5a4f3"
}

If the tree is not yet verified, the submitStatus will be less than 3 and the transaction related information will be missing.

{
  "treeId": "4dc4c401-5a55-48ee-802c-3f1659b10aa5",
  "currencyId": 0,
  "currency": "BTC",
  "submitStatus": 0,
}

# currencyId

The ID of the blockchain currency used for the timestamp. For example, 0 for Bitcoin (BTC), 1 for Ethereum (ETH). This is also human-readable presented in the currency field.

# rootHash

The private key represents the top hash in the Merkle Tree. Synonyms: root hash, private key, top hash, seed hash.

# submitStatus

  • 0: Hashes contained in this tree were only submitted to OriginStamp and added to the timestamping queue. They will be timestamped with the next timestamp submission.
  • 1: Hashes contained in this tree were submitted to the blockchain network, but are not yet included.
  • 2: Hashes contained in this tree are included in the latest block.
  • 3: Hashes contained in this seed have a tamper-proof timestamp.

# timestamp

The tamper-proof timestamp of all hashes contained in this tree. It is formatted as follows:

[ms] since 1.1.1970 (unix epoch), timezone: UTC

# transactionHash

The transaction ID of the timestamp, e.g., a transaction hash in Bitcoin.

← Verify a Timestamp with OriginStamp →