getInflightBundleStatuses

getInflightBundleStatuses

Returns the status of submitted bundles within the last five minutes, allowing up to five bundle IDs per request. If a bundle ID returns Failed, it means all regions have marked the bundle as failed, and it has not been forwarded. A Pending status indicates the bundle has not failed, landed, or been deemed invalid. When a bundle ID shows Landed, it signifies the bundle has successfully landed on-chain, verified through RPC or the bundles_landed table. Lastly, an Invalid status means the bundle is no longer in the system.

Request

Parameter	Type	Description
params	array[string]	REQUIRED An array of bundle ids to confirm, (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": "getInflightBundleStatuses",
  "params": [
    [
    "b31e5fae4923f345218403ac1ab242b46a72d4f2a38d131f474255ae88f1ec9a",
    "e3c4d7933cf3210489b17307a14afbab2e4ae3c67c9e7157156f191f047aa6e8",
    "a7abecabd9a165bc73fd92c809da4dc25474e1227e61339f02b35ce91c9965e2",
    "e3934d2f81edbc161c2b8bb352523cc5f74d49e8d4db81b222c553de60a66514",
    "2cd515429ae99487dfac24b170248f6929e4fd849aa7957cccc1daf75f666b54" 
    ]
  ]
}
'

Response

Field	Type	Description
null	null	If the bundle(s) is not found.
object	object	If the bundle is found, an array of objects with the following fields:
bundle_id	string	Bundle id
status	string	Invalid: BundleId not in our system (5 minute look back). Pending: Not failed, not landed, not invalid. Failed: All regions that have received the bundle have marked it as failed and it hasn't been forwarded. Landed: Landed on-chain (determined using RPC or bundles_landed table).
landed_slot	u64	The slot this bundle landed in, otherwise null if it is Invalid

Response Example:

JSON

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 280999028
    },
    "value": [
      {
        "bundle_id": "b31e5fae4923f345218403ac1ab242b46a72d4f2a38d131f474255ae88f1ec9a",
        "status": "Invalid",
        "landed_slot": null
      },
      {
        "bundle_id": "e3c4d7933cf3210489b17307a14afbab2e4ae3c67c9e7157156f191f047aa6e8",
        "status": "Invalid",
        "landed_slot": null
      },
      {
        "bundle_id": "a7abecabd9a165bc73fd92c809da4dc25474e1227e61339f02b35ce91c9965e2",
        "status": "Invalid",
        "landed_slot": null
      },
      {
        "bundle_id": "e3934d2f81edbc161c2b8bb352523cc5f74d49e8d4db81b222c553de60a66514",
        "status": "Invalid",
        "landed_slot": null
      },
      {
        "bundle_id": "2cd515429ae99487dfac24b170248f6929e4fd849aa7957cccc1daf75f666b54",
        "status": "Invalid",
        "landed_slot": null
      }
    ]
  },
  "id": 1
}