Steem Developer logo

Steem Developer Portal

This API is intended to evaluate a transaction status after calling condenser_api.broadcast_transaction.

To enable this API for steemd, the following is required in config.ini by specifying:

plugin = transaction_status_api

See: #3060

transaction_status_api.find_transaction

Returns the status of a given transaction id. Parameters: trx_id:string; expiration:timestamp (optional)

The result will contain one of the following status values:

Status Meaning
unknown Expiration time in future, transaction not included in block or mempool
within_mempool Transaction in mempool
within_reversible_block Transaction has been included in block, block not irreversible
within_irreversible_block Transaction has been included in block, block is irreversible
expired_reversible Transaction has expired, transaction is not irreversible (transaction could be in a fork)
expired_irreversible Transaction has expired, transaction is irreversible (transaction cannot be in a fork)
too_old Transaction is too old, I don’t know about it
Query Parameters JSON
{
  "transaction_id": "0000000000000000000000000000000000000000",
  "expiration": "2016-03-24T18:00:21"
}
Expected Response JSON
{"status": "unknown"}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"transaction_status_api.find_transaction", "params": {"transaction_id": "0000000000000000000000000000000000000000"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"transaction_status_api.find_transaction", "params": {"transaction_id": "0000000000000000000000000000000000000000", "expiration":"2016-03-24T18:00:21"}, "id":1}' https://api.steemit.com