Check CCIP bridge transaction status

curl --request GET \
  --url https://api.enso.build/api/v1/ccip/bridge/check

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enso.build/api/v1/ccip/bridge/check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.enso.build/api/v1/ccip/bridge/check"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.enso.build/api/v1/ccip/bridge/check")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "sourceChainId": 56,
  "sourceTxHash": "0x80f1faf0652a5618ea1de0fc5142418e380676b3c6c74d482cfac1237638d6d4",
  "sourceChainIdFinality": 5,
  "status": "pending",
  "sourceChainEstimatedTimeForFinalitySeconds": 0,
  "ccipSendParams": {
    "destinationChainSelector": "15971525489660198786",
    "message": {
      "receiver": "<string>",
      "tokenAmounts": [
        {
          "token": "<string>",
          "amount": "<string>"
        }
      ],
      "feeToken": "<string>"
    }
  },
  "ccipSendParamsDecoded": {
    "destinationChainId": 8453,
    "data": {
      "receiver": "0x1234567890123456789012345678901234567890",
      "error": "Could not decode message.data as (address,bytes)"
    },
    "tokenAmounts": [
      {
        "token": {
          "address": "0x55d398326f99059fF775485246999027B3197955",
          "symbol": "USDT",
          "name": "Tether USD",
          "decimals": 18
        },
        "amount": "1000000000000000000"
      }
    ],
    "fee": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "5000000000000000"
    },
    "extraArgs": {
      "gasLimit": "2000000",
      "allowOutOfOrderExecution": false
    }
  },
  "destinationChainId": 8453,
  "destinationTxHash": "0x9a3e6a8a52b82a1f4b523b0d50be133df0ad9407814b32e42d67119e1ae1947d",
  "readyForManualExecution": true,
  "ensoSourceEvent": {
    "blockNumber": 123,
    "transactionHash": "<string>",
    "chainId": 123,
    "success": true,
    "accountId": "<string>",
    "requestId": "<string>",
    "error": "<string>",
    "refundDetails": {
      "token": "<string>",
      "amount": "<string>",
      "recipient": "<string>",
      "isNative": true
    }
  },
  "ensoDestinationEvent": {
    "blockNumber": 123,
    "transactionHash": "<string>",
    "chainId": 123,
    "success": true,
    "accountId": "<string>",
    "requestId": "<string>",
    "error": "<string>",
    "refundDetails": {
      "token": "<string>",
      "amount": "<string>",
      "recipient": "<string>",
      "isNative": true
    }
  },
  "intent": {
    "requestId": "<string>",
    "executor": "<string>",
    "phase": "awaiting_funds",
    "status": "<string>",
    "source": "keeper",
    "executionChainId": 123,
    "statusDescription": "<string>",
    "deadline": "<string>",
    "executionTxHash": "<string>",
    "executionExplorerUrl": "<string>",
    "executedAt": "<string>",
    "refundTxHash": "<string>",
    "refundExplorerUrl": "<string>",
    "refundedAt": "<string>",
    "error": "<string>"
  },
  "destinationExecutionTxHash": "<string>",
  "error": "Transaction receipt not found for 0x..."
}

GET

api

ccip

bridge

check

Check CCIP bridge transaction status

curl --request GET \
  --url https://api.enso.build/api/v1/ccip/bridge/check

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enso.build/api/v1/ccip/bridge/check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.enso.build/api/v1/ccip/bridge/check"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.enso.build/api/v1/ccip/bridge/check")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "sourceChainId": 56,
  "sourceTxHash": "0x80f1faf0652a5618ea1de0fc5142418e380676b3c6c74d482cfac1237638d6d4",
  "sourceChainIdFinality": 5,
  "status": "pending",
  "sourceChainEstimatedTimeForFinalitySeconds": 0,
  "ccipSendParams": {
    "destinationChainSelector": "15971525489660198786",
    "message": {
      "receiver": "<string>",
      "tokenAmounts": [
        {
          "token": "<string>",
          "amount": "<string>"
        }
      ],
      "feeToken": "<string>"
    }
  },
  "ccipSendParamsDecoded": {
    "destinationChainId": 8453,
    "data": {
      "receiver": "0x1234567890123456789012345678901234567890",
      "error": "Could not decode message.data as (address,bytes)"
    },
    "tokenAmounts": [
      {
        "token": {
          "address": "0x55d398326f99059fF775485246999027B3197955",
          "symbol": "USDT",
          "name": "Tether USD",
          "decimals": 18
        },
        "amount": "1000000000000000000"
      }
    ],
    "fee": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "5000000000000000"
    },
    "extraArgs": {
      "gasLimit": "2000000",
      "allowOutOfOrderExecution": false
    }
  },
  "destinationChainId": 8453,
  "destinationTxHash": "0x9a3e6a8a52b82a1f4b523b0d50be133df0ad9407814b32e42d67119e1ae1947d",
  "readyForManualExecution": true,
  "ensoSourceEvent": {
    "blockNumber": 123,
    "transactionHash": "<string>",
    "chainId": 123,
    "success": true,
    "accountId": "<string>",
    "requestId": "<string>",
    "error": "<string>",
    "refundDetails": {
      "token": "<string>",
      "amount": "<string>",
      "recipient": "<string>",
      "isNative": true
    }
  },
  "ensoDestinationEvent": {
    "blockNumber": 123,
    "transactionHash": "<string>",
    "chainId": 123,
    "success": true,
    "accountId": "<string>",
    "requestId": "<string>",
    "error": "<string>",
    "refundDetails": {
      "token": "<string>",
      "amount": "<string>",
      "recipient": "<string>",
      "isNative": true
    }
  },
  "intent": {
    "requestId": "<string>",
    "executor": "<string>",
    "phase": "awaiting_funds",
    "status": "<string>",
    "source": "keeper",
    "executionChainId": 123,
    "statusDescription": "<string>",
    "deadline": "<string>",
    "executionTxHash": "<string>",
    "executionExplorerUrl": "<string>",
    "executedAt": "<string>",
    "refundTxHash": "<string>",
    "refundExplorerUrl": "<string>",
    "refundedAt": "<string>",
    "error": "<string>"
  },
  "destinationExecutionTxHash": "<string>",
  "error": "Transaction receipt not found for 0x..."
}

Query Parameters

chainId

number

required

Chain ID of the source transaction

Example:

56

txHash

string

required

Transaction hash of the CCIP bridge transaction on source chain

Example:

"0x80f1faf0652a5618ea1de0fc5142418e380676b3c6c74d482cfac1237638d6d4"

Response

Bridge transaction status and details

sourceChainId

number

required

Source chain ID where the CCIP message was sent from

Example:

56

sourceTxHash

string

required

Source chain transaction hash

Example:

"0x80f1faf0652a5618ea1de0fc5142418e380676b3c6c74d482cfac1237638d6d4"

sourceChainIdFinality

number

required

CCIP finality time in seconds for the source chain (time required for CCIP to achieve finality)

Example:

5

status

enum<string>

required

Overall bridge status. ready_for_manual_execution means destination execution failed/stalled but is recoverable — anyone can (re)trigger manual execution once the underlying cause is resolved.

Available options:

pending,

inflight,

delivered,

failed,

ready_for_manual_execution,

unknown

sourceChainEstimatedTimeForFinalitySeconds

number

Estimated seconds remaining until source chain finality is achieved

Example:

0

ccipSendParams

object

Raw CCIP send parameters extracted from Chainlink API (destinationChainSelector and message)

Show child attributes

ccipSendParamsDecoded

object

Decoded and enriched CCIP send parameters with full token metadata and human-readable data

Show child attributes

destinationChainId

number

Destination chain ID where the CCIP message was delivered

Example:

8453

destinationTxHash

string

Destination chain transaction hash (if message was delivered)

Example:

"0x9a3e6a8a52b82a1f4b523b0d50be133df0ad9407814b32e42d67119e1ae1947d"

readyForManualExecution

boolean

True if the CCIP message is awaiting (or can be retried via) manual execution on the destination chain. A failed message that is ready for manual execution can be re-triggered by anyone once the underlying cause (e.g. token pool liquidity) is resolved.

Example:

true

ensoSourceEvent

object | null

Enso shortcut event from source chain (ShortcutExecuted + execution result). Null if not found.

Show child attributes

ensoDestinationEvent

object | null

Enso shortcut event from destination chain (ShortcutExecuted + execution result). Null if not found. On an intent route this is read from the keeper's execution transaction (destinationExecutionTxHash), not from the bridge delivery.

Show child attributes

intent

object

Present when the source transaction published a cross-chain intent: this bridge only delivers funds to the intent's ephemeral executor, and a keeper then executes the intent (or refunds it past its deadline) in a separate destination transaction. status: delivered means the bridge delivered the funds to the executor; the execution itself is reported here (phase, keeper status, execution / repayment transactions).

Show child attributes

destinationExecutionTxHash

string

The keeper's intent execution transaction on the destination chain, once executed - the transaction that performed the Enso swap. destinationTxHash is only the bridge delivery that funded the executor.

error

string

Error message if the API request failed (e.g., transaction not found, invalid chain selector, API errors)

Example:

"Transaction receipt not found for 0x..."

Api Reference

Reference

Quoter Reference

Check CCIP bridge transaction status

Query Parameters

Response