# Hive Developer Portal

Methods:

- find_transaction

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

- Since: The Mysterious Future
- Related

#### 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.openhive.network

    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.openhive.network