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	curl -X POST https://linea-mainnet.g.alchemy.com/v2/{apiKey} \
2	-H "Content-Type: application/json" \
3	-d '{
4	"jsonrpc": "2.0",
5	"method": "linea_getTransactionExclusionStatusV1",
6	"params": [
7	"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
8	],
9	"id": 1
10	}'

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	}