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).

Example Request

• cURL

curl -d '{

"id": "1",

"jsonrpc": "2.0",

"method": "GetTransactionStatus",

"params": ["1bb178b023f816e950d862f6505cd79a32bb97e71fd78441cbc3486940a2e1b7"]

}' -H "Content-Type: application/json" -X POST "https://api.zilliqa.com/"

Example Response

{

"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	0	Transaction not found
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 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

HTTP Request

Chain(s)	URL(s)
Zilliqa mainnet	https://api.zilliqa.com/
Developer testnet	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.