getBundleStatuses

getBundleStatuses

Returns the status of submitted bundle(s). This function operates similarly to the Solana RPC method getSignatureStatuses. If a bundle_id is not found or has not landed, it returns null. If found and processed, it returns context information including the slot at which the request was made and results with the bundle_id(s) and the transactions along with their slot and confirmation status.

We use getSignatureStatuses with the default value of searchTransactionHistory set to false to check transaction statuses on-chain. This means the RPC call will search only its recent history, including all recent slots plus up to MAX_RECENT_BLOCKHASHES rooted slots for the transactions. Currently, MAX_RECENT_BLOCKHASHES is 300.

Request

Parameter	Type	Description
params	array[string]	REQUIRED An array of bundle ids to confirm, as base-58 encoded strings (up to a maximum of 5).

Request Example:

HTTP

curl https://mainnet.block-engine.jito.wtf/api/v1/bundles -X POST -H "Content-Type: application/json" -d '
{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBundleStatuses",
    "params": [
      [
        "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d"
      ]
    ]
}
'

Response

Field	Type	Description
null	null	If the bundle is not found.
object	object	If the bundle is found, an array of objects with the following fields:
bundle_id	string	Bundle id
transactions	array[string]	A list of base-58 encoded signatures applied by the bundle. The list will not be empty.
slot	u64	The slot this bundle was processed in.
confirmationStatus	string	The bundle transaction's cluster confirmation status; Either processed, confirmed, or finalized. See Commitment for more on optimistic confirmation.
err	object	This will show any retryable or non-retryable error encountered when getting the bundle status. If retryable, please query again

Response Example:

JSON

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 242806119
    },
    "value": [
      {
        "bundle_id": "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d",
        "transactions": [
          "3bC2M9fiACSjkTXZDgeNAuQ4ScTsdKGwR42ytFdhUvikqTmBheUxfsR1fDVsM5ADCMMspuwGkdm1uKbU246x5aE3",
          "8t9hKYEYNbLvNqiSzP96S13XF1C2f1ro271Kdf7bkZ6EpjPLuDff1ywRy4gfaGSTubsM2FeYGDoT64ZwPm1cQUt"
        ],
        "slot": 242804011,
        "confirmation_status": "finalized",
        "err": {
          "Ok": null
        }
      }
    ]
  },
  "id": 1
}