Get Status - Relay

Documentation Index

Fetch the complete documentation index at: /llms.txt

Use this file to discover all available pages before exploring further.

cURL

curl --request GET \
  --url https://api.relay.link/intents/status/v3

JavaScript Fetch

const options = {method: 'GET'};

fetch('https://api.relay.link/intents/status/v3', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Python Requests

import requests

url = "https://api.relay.link/intents/status/v3"

response = requests.get(url)

print(response.text)

Response Example

200

{
  "status": "success",
  "inTxHashes": [
    "0xe53021eaa63d100b08338197d26953e2219bcbad828267dd936c549ff643aad7"
  ],
  "txHashes": [
    "0x9da7bc54dfe6229d6980fd62250d472f23dfe0f41a1cdc870c81a08b3445f254"
  ],
  "updatedAt": 1713290386145,
  "originChainId": 7777777,
  "destinationChainId": 8453
}

Relay Statuses

Relay statuses take one of the following options:

Status Description
waiting Waiting for deposit confirmation
depositing Origin deposit confirmed via /execute API, pending fill
pending Deposit confirmed, pending destination chain submission
submitted Destination transaction submitted
success Successful fill on destination
delayed Destination fill delayed, still processing
refund Successfully refunded
failure Unsuccessful fill

Headers

x-api-key

Type: string
Description: Optional API key for authentication and higher rate limits.

Query Parameters

requestId

Type: string
Description: A unique id representing the execution in the Relay system. You can obtain this id from the requests API or the check object within the step items.

Response

200 - application/json