Track Transfer Status

Check transfer status

curl --request GET \
  --url https://transfer.layerzero-api.com/v1/status/{quoteId} \
  --header 'x-api-key: <api-key>'

import requests

url = "https://transfer.layerzero-api.com/v1/status/{quoteId}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://transfer.layerzero-api.com/v1/status/{quoteId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://transfer.layerzero-api.com/v1/status/{quoteId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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://transfer.layerzero-api.com/v1/status/{quoteId}"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://transfer.layerzero-api.com/v1/status/{quoteId}")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://transfer.layerzero-api.com/v1/status/{quoteId}")

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

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

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

{
  "status": "SUCCEEDED",
  "explorerUrl": "https://layerzeroscan.com/tx/...",
  "executionHistory": [
    {
      "event": "SENT",
      "transaction": {
        "chainKey": "base",
        "hash": "0x..."
      }
    },
    {
      "event": "DELIVERED",
      "transaction": {
        "chainKey": "optimism",
        "hash": "0x..."
      }
    }
  ]
}

GET

status

{quoteId}

Check transfer status

curl --request GET \
  --url https://transfer.layerzero-api.com/v1/status/{quoteId} \
  --header 'x-api-key: <api-key>'

import requests

url = "https://transfer.layerzero-api.com/v1/status/{quoteId}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://transfer.layerzero-api.com/v1/status/{quoteId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://transfer.layerzero-api.com/v1/status/{quoteId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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://transfer.layerzero-api.com/v1/status/{quoteId}"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://transfer.layerzero-api.com/v1/status/{quoteId}")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://transfer.layerzero-api.com/v1/status/{quoteId}")

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

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

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

{
  "status": "SUCCEEDED",
  "explorerUrl": "https://layerzeroscan.com/tx/...",
  "executionHistory": [
    {
      "event": "SENT",
      "transaction": {
        "chainKey": "base",
        "hash": "0x..."
      }
    },
    {
      "event": "DELIVERED",
      "transaction": {
        "chainKey": "optimism",
        "hash": "0x..."
      }
    }
  ]
}

Returns the current status of a cross-chain transfer. Poll this endpoint after executing user steps to monitor progress until completion.

Reference

Parameters

Parameter	Type	Location	Required	Description
`quoteId`	string	Path	Yes	Quote ID from the `/quotes` response
`txHash`	string	Query	No	Transaction hash from execution (recommended for faster updates)

Response

Returns transfer status information with optional execution history.

Attributes

Attribute	Type	Description
`status`	enum	Current transfer state: `PENDING`, `PROCESSING`, `SUCCEEDED`, `FAILED`, `UNKNOWN`
`explorerUrl`	string	Optional LayerZero Scan URL for tracking
`executionHistory`	array	Optional array of execution events

Status values

Status	Description	Terminal
`UNKNOWN`	Transfer not found or not started	Yes
`PENDING`	Transfer initiated but not yet processing	No
`PROCESSING`	Cross-chain message in transit	No
`SUCCEEDED`	Transfer completed successfully	Yes
`FAILED`	Transfer failed (reverted or timeout)	Yes

Execution history events

Event	Description	Chain
`SENT`	Transaction submitted	Source chain
`BUS_RODE`	Batch executed (Stargate V2 only)	Source chain
`DELIVERED`	Message delivered	Destination chain

Each event includes:

Attribute	Type	Description
`event`	enum	Event type
`transaction`	object	Transaction details
`transaction.chainKey`	string	Chain where event occurred
`transaction.hash`	string	Transaction hash
`transaction.timestamp`	number	Unix timestamp in milliseconds

Code examples

cURL
TypeScript
Python

curl -X GET "https://transfer.layerzero-api.com/v1/status/QUOTE_ID?txHash=0x..." \
  -H "x-api-key: YOUR_API_KEY"

const params = new URLSearchParams({txHash: '0x...'});
const response = await fetch(
  `https://transfer.layerzero-api.com/v1/status/QUOTE_ID?${params}`,
  {
    headers: {
      'x-api-key': 'YOUR_API_KEY',
    },
  },
);

const {status, explorerUrl} = await response.json();
console.log('Status:', status);
console.log('Explorer:', explorerUrl);

import requests

response = requests.get(
  "https://transfer.layerzero-api.com/v1/status/QUOTE_ID",
  headers={"x-api-key": "YOUR_API_KEY"},
  params={"txHash": "0x..."},
)

data = response.json()
print(f"Status: {data['status']}")
print(f"Explorer: {data.get('explorerUrl')}")

Response

{
  "status": "SUCCEEDED",
  "explorerUrl": "https://layerzeroscan.com/tx/0x...",
  "executionHistory": [
    {
      "event": "SENT",
      "transaction": {
        "chainKey": "base",
        "hash": "0x123...",
        "timestamp": 1704067200000
      }
    },
    {
      "event": "DELIVERED",
      "transaction": {
        "chainKey": "arbitrum",
        "hash": "0x456...",
        "timestamp": 1704067260000
      }
    }
  ]
}

Error handling

HTTP Status	Description	Action
`404`	Quote not found	Return `UNKNOWN` status
`429`	Rate limit exceeded	Wait 5 seconds, retry
`500`	Server error	Retry with exponential backoff

async function checkStatusSafe(quoteId: string, txHash: string): Promise<string> {
  try {
    const params = new URLSearchParams({txHash});
    const response = await fetch(
      `https://transfer.layerzero-api.com/v1/status/${quoteId}?${params}`,
      {headers: {'x-api-key': 'YOUR_API_KEY'}},
    );

    if (response.status === 404) return 'UNKNOWN';
    if (response.status === 429) {
      await new Promise((r) => setTimeout(r, 5000));
      return checkStatusSafe(quoteId, txHash);
    }

    const {status} = await response.json();
    return status;
  } catch (error) {
    console.error('Status check failed:', error);
    return 'UNKNOWN';
  }
}

Quotes — Request transfer quotes (provides the quoteId)
Build user steps — Generate fresh transactions for Solana
Submit signature — Submit signatures for Aori routes

Examples

EVM Example — Complete transfer with status tracking
Solana Example — Solana transfer with polling

Authorizations

x-api-key

string

header

required

API key for authenticating requests. Required for /quotes, /build-user-steps, /submit-signature, and /status endpoints.

Path Parameters

quoteId

string

required

The quote ID from the /quotes response

Example:

"quote_abc123"

Query Parameters

txHash

string

Optional transaction hash for faster status lookup

Example:

"0x..."

Response

200 - application/json

Successfully retrieved status

status

enum<string>

Available options:

PENDING,

PROCESSING,

SUCCEEDED,

FAILED,

UNKNOWN

explorerUrl

string

executionHistory

object[]

Show child attributes

Submit Signature EVM

​Reference

​Parameters

​Response

​Attributes

​Status values

​Execution history events

​Code examples

​Response

​Error handling

​Related endpoints

​Examples

Authorizations

Path Parameters

Query Parameters

Response

Reference

Parameters

Response

Attributes

Status values

Execution history events

Code examples

Response

Error handling

Related endpoints

Examples