linea_getTransactionExclusionStatusV1

Returns the status of a transaction's exclusion from blocks. This helps identify if a transaction was excluded due to rate limiting, sequencer rules, or other reasons specific to Linea.

Path Parameters

apiKeystringRequiredDefaults to docs-demo

Request

This endpoint expects an object.

transactionHashstringRequiredformat: "^0x[0-9a-f]{64}$"

The hash of the transaction to check.

Response

The exclusion status of the transaction.

txHashstring or nullformat: "^0x[0-9a-f]{64}$"

fromstring or nullformat: "^0x[0-9a-fA-F]{40}$"

statusstring or null

The status of the transaction (e.g., “EXCLUDED”, “INCLUDED”, “PENDING”).

reasonMessagestring or null

Human-readable message explaining the exclusion reason if excluded.

blockNumberstring or nullformat: "^0x([1-9a-f]+[0-9a-f]*|0)$"

The block number where the transaction was included (if applicable).

1	import requests
2
3	url = "https://linea-mainnet.g.alchemy.com/v2/:apiKey"
4
5	payload = ["0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"]
6	headers = {"Content-Type": "application/json"}
7
8	response = requests.post(url, json=payload, headers=headers)
9
10	print(response.json())

1	{
2	"jsonrpc": "2.0",
3	"id": "1",
4	"result": {
5	"txHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
6	"from": "0x1234567890123456789012345678901234567890",
7	"status": "EXCLUDED",
8	"reasonMessage": "Transaction exceeds Linea gas limit",
9	"blockNumber": "0x0"
10	}
11	}