---
id: api-transaction-get-transaction-status
title: GetTransactionStatus
---

---

Returns the status of a specified transaction. This API is available from Zilliqa `V7.0.0` onwards and supports all transaction statuses (unconfirmed, confirmed, and rejected).

!!! note

    The `GetTransactionStatus` API relies on an off-chain transaction tracking solution, which may be periodically cleaned. We recommend to still primarily use `GetTransaction` for older (e.g., several days old) transactions, and only use `GetTransactionStatus` mainly for tracking the progress of ongoing transactions.

!!! note

    The `GetTransactionStatus` API is available only on[https://api.zilliqa.com/](https://api.zilliqa.com/) It is disabled for community-hosted or private-hosted seed nodes.

### Example Request

=== "cURL"

    ```shell
    curl -d '{
        "id": "1",
        "jsonrpc": "2.0",
        "method": "GetTransactionStatus",
        "params": ["1bb178b023f816e950d862f6505cd79a32bb97e71fd78441cbc3486940a2e1b7"]
    }' -H "Content-Type: application/json" -X POST "https://api.zilliqa.com/"
    ```

### Example Response

```json
{
  "id": "1",
  "jsonrpc": "2.0",
  "result": {
    "ID": "1bb178b023f816e950d862f6505cd79a32bb97e71fd78441cbc3486940a2e1b7",
    "_id": {
      "$oid": "5fd053b0d127fe45cc5eea24"
    },
    "amount": "0",
    "data": "{\"_tag\":\"AddAccount\",\"params\":[{\"vname\":\"address\",\"type\":\"ByStr20\",\"value\":\"0x0434cdcf27e2294b3539cb6ffe2cc328d7f9757e\"},{\"vname\":\"datetime_added\",\"type\":\"String\",\"value\":\"1607488428\"}]}",
    "epochInserted": "2152402",
    "epochUpdated": "2152405",
    "gasLimit": "30000",
    "gasPrice": "2000000000",
    "lastModified": "1607488477842011",
    "modificationState": 2,
    "nonce": "131",
    "senderAddr": "b8fe5ab2e66c71274216688cf852e6d9f10b94e7",
    "signature": "0xBAA6964C66AE0608C6CEFBAAB69138E9358A1604C647DFFEF94E7022F2AB33D67F70802F71E934A0690BE4BA81CC3866B2FB668B29C528E6B77B1285533A2E2C",
    "status": 3,
    "success": true,
    "toAddr": "db4955ba4b1a957200ee0a36cf5f84eb4d7447e5",
    "version": "21823489"
  }
}
```

### Response Fields

| Field               | Description                                     |
| ------------------- | ----------------------------------------------- |
| `_id`               | Object ID (internal database field)             |
| `epochInserted`     | Tx epoch when this transaction was first logged |
| `epochUpdated`      | Tx epoch when this transaction was last updated |
| `lastModified`      | Timestamp for this transaction's last update    |
| `modificationState` | See next table below                            |
| `status`            | See next table below                            |
| Other fields        | Transaction-related fields                      |

### Status Codes

| `modificationState` | `status` | Description                                                             |
| ------------------- | -------- | ----------------------------------------------------------------------- |
| 0                   | 1        | Pending - Dispatched                                                    |
| 1                   | 2        | Pending - Soft-confirmed (awaiting Tx block generation)                 |
| 1                   | 4        | Pending - Nonce is higher than expected                                 |
| 1                   | 5        | Pending - Microblock gas limit exceeded                                 |
| 1                   | 6        | Pending - Consensus failure in network                                  |
| 2                   | 3        | Confirmed                                                               |
| 2                   | 10       | Rejected - Transaction caused math error                                |
| 2                   | 11       | Rejected - Scilla invocation error                                      |
| 2                   | 12       | Rejected - Contract account initialization error                        |
| 2                   | 13       | Rejected - Invalid source account                                       |
| 2                   | 14       | Rejected - Gas limit higher than shard gas limit                        |
| 2                   | 15       | Rejected - Unknown transaction type                                     |
| 2                   | 16       | Rejected - Transaction sent to wrong shard                              |
| 2                   | 17       | Rejected - Contract & source account cross-shard issue                  |
| 2                   | 18       | Rejected - Code size exceeded limit                                     |
| 2                   | 19       | Rejected - Transaction verification failed                              |
| 2                   | 20       | Rejected - Gas limit too low                                            |
| 2                   | 21       | Rejected - Insufficient balance                                         |
| 2                   | 22       | Rejected - Insufficient gas to invoke Scilla checker                    |
| 2                   | 23       | Rejected - Duplicate transaction exists                                 |
| 2                   | 24       | Rejected - Transaction with same nonce but same/higher gas price exists |
| 2                   | 25       | Rejected - Invalid destination address                                  |
| 2                   | 26       | Rejected - Failed to add contract account to state                      |
| 2                   | 27       | Rejected - Nonce is lower than expected                                 |
| 2                   | 255      | Rejected - Internal error                                               |

!!! warning

    The transaction pool is cleared by design **at the start of a new DS epoch**. Any transaction left in "Pending" state (e.g., "Pending - Dispatched", "Pending - Nonce is higher than expected", ...) after a new DS epoch has started will have most likely been dropped and will no longer be processed further at that point.

### HTTP Request

| Chain(s)              | URL(s)                                                       |
| --------------------- | ------------------------------------------------------------ |
| **Zilliqa mainnet**   | [https://api.zilliqa.com/](https://api.zilliqa.com/)         |
| **Developer testnet** | [https://dev-api.zilliqa.com/](https://dev-api.zilliqa.com/) |

### Arguments

| Parameter | Type   | Required | Description                                              |
| --------- | ------ | -------- | -------------------------------------------------------- |
| `id`      | string | Required | `"1"`                                                    |
| `jsonrpc` | string | Required | `"2.0"`                                                  |
| `method`  | string | Required | `"GetTransactionStatus"`                                 |
| `params`  | string | Required | Transaction hash of 32 bytes of a specified transaction. |