Skip to main content

starknet_getMessagesStatus RPC Method

Returns the l1_handler transaction hashes and statuses for all L1 to L2 messages sent by an L1 transaction.

Updated on
Jul 30, 2026

Parameters

transaction_hash
string
REQUIRED

The hash of the L1 transaction that sent L1 to L2 messages

Returns

result
array

The array of message statuses, each with the following fields:

transaction_hash
string

The hash of the l1_handler transaction on Starknet

finality_status
string

The finality status of the transaction. Possible values includes - 'PRE_CONFIRMED', 'ACCEPTED_ON_L2' or 'ACCEPTED_ON_L1'

execution_status
string

The execution status of the transaction. Possible values includes - 'SUCCEEDED' or 'REVERTED'

failure_reason
string

The failure reason. Only appears if execution_status is REVERTED

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free