Check transaction status

Checks whether an executed transaction in Tetrium has been sealed in the blockchain.


Call URL

/transactions/(transactionHash)

Type : GET


Call request URL parameters

Field Type Required/Optional Description Accepted values
transactionHash string (without quotation marks) Required A hash that identifies a particular transaction. Any valid transactionHash

Sample Call Request

https://api.tetrium.io/tokenize/transactions/0x5ff710ede5f75f07002f6b3b4f3298159ae05bf6d6ce81d21af8c111e03f8c51

Call responses

Success response

Field Type Description Respond Values
status string Status of the API call. "success"
message string Information about the status. "transaction status checked"
transactionStatus string The sealing status of the transaction. (See below)

The information contained in transactionStatus may varies for different types of transactions but they share the common few:

Field Description
date The date and time the transaction was executed.
type The type of the transaction.
txHash The transaction hash identifying this transaction in the Tetrium private blockchain. As it is unique across Tetrium, you can always use this information for verification and audit purposes.
blockNo The number of the block this transaction is sealed in Tetrium private blockchain. As it is unique across Tetrium, you can always use this information for verification and audit purposes.
blockHash The hash of the block this transaction is sealed in Tetrium private blockchain. As it is unique across Tetrium, you can always use this information for verification and audit purposes.
currencyAddress The currencyAddress of the involved currency.
from The address of the wallet executing the transaction.
to (optional) The address of the wallet at the receiving end of the transaction, if there is any.
value (optional) The value of the transaction, if there is any.
walletAddress (optional) The address of the generated wallet, if this transaction is to generate a new wallet.
member (optional) The address of the wallet being added or removed from a currency, if this transaction is to add or remove a currency member.
currencyName (optional) The name of the involved currency.
currencySymbol (optional) The symbol of the involved currency.
currencyDecimals (optional) The decimals of the involved currency.
status The current status of the transaction.

Error response

Field Type Description Respond Values
status string Status of the API call. "fail"
error string Information about the error. (See below)

Information contained in error:

Error Messages Description
"invalid transactionHash" transactionHash provided was not in the correct format.
"transaction not found" The transaction does not exist in Tetrium, or the transaction was not executed under the developer account making this API call. Your provided transaction hash parameter might be invalid. Else, the transaction might still be in preliminary processing and you may try again in a short while.

For any other errors, please refer to List of Common Error Messages

Sample Call Response

{
   "status":"success",
   "message":"transaction status checked",
   "transactionStatus":{
      "date":"2018-04-15T08:42:04.793Z",
      "type":"Create currency",
      "txHash":"0x5ff710ede5f75f07002f6b3b4f3298159ae05bf6d6ce81d21af8c111e03f8c51",
      "blockNo":"110536",
      "blockHash":"0x9a1c6146001995f490552b702affce6eecfd8f7bbd8566d0087bbf1ab62c7a13",
      "currencyAddress":"0x29341b674091d600c227B137a457b0573515A7A8",
      "from":"0xc7731ba1b2cfb4e5fdbce6492928a7c7787e211e",
      "currencyName":"SampleCurrency",
      "currencySymbol":"SMC",
      "currencyDecimals":"2",
      "status":"success"
   }
}

results matching ""

    No results matching ""