Track a transaction by hash

curl --request GET \
  --url https://api.faraday.range.org/v1/transactions/track/{tx_hash} \
  --header 'Authorization: Bearer <token>'

{
  "provider": "skipgo",
  "raw": {
    "error": null,
    "next_blocking_transfer": null,
    "state": "STATE_COMPLETED_SUCCESS",
    "status": "STATE_COMPLETED",
    "transfer_asset_release": {
      "amount": "4536971",
      "chain_id": "solana-devnet",
      "denom": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
      "released": true
    },
    "transfer_sequence": [
      {
        "cctp_transfer": {
          "from_chain_id": "11155111",
          "state": "CCTP_TRANSFER_RECEIVED",
          "to_chain_id": "solana-devnet",
          "txs": {
            "receive_tx": {
              "chain_id": "solana-devnet",
              "explorer_link": "https://solscan.io/tx/2iWuf6wS4wAbuV6R1ZoCh2x1g9U2g3d2EwJ2jUBR6BRteak7fpsEtxCwDSkpDKgFriicBKjeUGJtnBMba256J5Ao?cluster=devnet",
              "on_chain_at": "2025-10-27T18:28:49.766120570Z",
              "tx_hash": "2iWuf6wS4wAbuV6R1ZoCh2x1g9U2g3d2EwJ2jUBR6BRteak7fpsEtxCwDSkpDKgFriicBKjeUGJtnBMba256J5Ao"
            },
            "send_tx": {
              "chain_id": "11155111",
              "explorer_link": "https://sepolia.etherscan.io/tx/0x66682E126367F63E9714F78CE4417E8B0096D5DE77F17DF6A179315E7D325BB3",
              "on_chain_at": "2025-10-27T18:23:48Z",
              "tx_hash": "0x66682E126367F63E9714F78CE4417E8B0096D5DE77F17DF6A179315E7D325BB3"
            }
          }
        }
      }
    ],
    "transfers": [
      {
        "next_blocking_transfer": null,
        "state": "STATE_COMPLETED_SUCCESS",
        "transfer_asset_release": {
          "amount": "4536971",
          "chain_id": "solana-devnet",
          "denom": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
          "released": true
        },
        "transfer_sequence": [
          {
            "cctp_transfer": {
              "from_chain_id": "11155111",
              "state": "CCTP_TRANSFER_RECEIVED",
              "to_chain_id": "solana-devnet",
              "txs": {
                "receive_tx": {
                  "chain_id": "solana-devnet",
                  "explorer_link": "https://solscan.io/tx/2iWuf6wS4wAbuV6R1ZoCh2x1g9U2g3d2EwJ2jUBR6BRteak7fpsEtxCwDSkpDKgFriicBKjeUGJtnBMba256J5Ao?cluster=devnet",
                  "on_chain_at": "2025-10-27T18:28:49.766120570Z",
                  "tx_hash": "2iWuf6wS4wAbuV6R1ZoCh2x1g9U2g3d2EwJ2jUBR6BRteak7fpsEtxCwDSkpDKgFriicBKjeUGJtnBMba256J5Ao"
                },
                "send_tx": {
                  "chain_id": "11155111",
                  "explorer_link": "https://sepolia.etherscan.io/tx/0x66682E126367F63E9714F78CE4417E8B0096D5DE77F17DF6A179315E7D325BB3",
                  "on_chain_at": "2025-10-27T18:23:48Z",
                  "tx_hash": "0x66682E126367F63E9714F78CE4417E8B0096D5DE77F17DF6A179315E7D325BB3"
                }
              }
            }
          }
        ]
      }
    ]
  },
  "status": "completed"
}

Transactions

Track a transaction by hash

Returns the status of a transaction by hash.

The status key of the response provides a status of the transaction which is one of

submitted
pending
completed
failed
abandoned
unknown

The raw key provides the full response from the provider, which may provide additional information including links to block explorers and intermediary transactions. As each provider response is different it is up to clients to parse raw provider responses to use them.

Query Parameters

Clients that did not submit their transaction via the Faraday API can still use this endpoint by providing:

tx_hash (required, path) — The transaction hash on the source chain.
quote_id (optional, query string) — If the transaction originated from a Faraday quote, include the quote UUID to link to the original quote record.

GET

transactions

track

{tx_hash}

Track a transaction by hash

curl --request GET \
  --url https://api.faraday.range.org/v1/transactions/track/{tx_hash} \
  --header 'Authorization: Bearer <token>'

{
  "provider": "skipgo",
  "raw": {
    "error": null,
    "next_blocking_transfer": null,
    "state": "STATE_COMPLETED_SUCCESS",
    "status": "STATE_COMPLETED",
    "transfer_asset_release": {
      "amount": "4536971",
      "chain_id": "solana-devnet",
      "denom": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
      "released": true
    },
    "transfer_sequence": [
      {
        "cctp_transfer": {
          "from_chain_id": "11155111",
          "state": "CCTP_TRANSFER_RECEIVED",
          "to_chain_id": "solana-devnet",
          "txs": {
            "receive_tx": {
              "chain_id": "solana-devnet",
              "explorer_link": "https://solscan.io/tx/2iWuf6wS4wAbuV6R1ZoCh2x1g9U2g3d2EwJ2jUBR6BRteak7fpsEtxCwDSkpDKgFriicBKjeUGJtnBMba256J5Ao?cluster=devnet",
              "on_chain_at": "2025-10-27T18:28:49.766120570Z",
              "tx_hash": "2iWuf6wS4wAbuV6R1ZoCh2x1g9U2g3d2EwJ2jUBR6BRteak7fpsEtxCwDSkpDKgFriicBKjeUGJtnBMba256J5Ao"
            },
            "send_tx": {
              "chain_id": "11155111",
              "explorer_link": "https://sepolia.etherscan.io/tx/0x66682E126367F63E9714F78CE4417E8B0096D5DE77F17DF6A179315E7D325BB3",
              "on_chain_at": "2025-10-27T18:23:48Z",
              "tx_hash": "0x66682E126367F63E9714F78CE4417E8B0096D5DE77F17DF6A179315E7D325BB3"
            }
          }
        }
      }
    ],
    "transfers": [
      {
        "next_blocking_transfer": null,
        "state": "STATE_COMPLETED_SUCCESS",
        "transfer_asset_release": {
          "amount": "4536971",
          "chain_id": "solana-devnet",
          "denom": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
          "released": true
        },
        "transfer_sequence": [
          {
            "cctp_transfer": {
              "from_chain_id": "11155111",
              "state": "CCTP_TRANSFER_RECEIVED",
              "to_chain_id": "solana-devnet",
              "txs": {
                "receive_tx": {
                  "chain_id": "solana-devnet",
                  "explorer_link": "https://solscan.io/tx/2iWuf6wS4wAbuV6R1ZoCh2x1g9U2g3d2EwJ2jUBR6BRteak7fpsEtxCwDSkpDKgFriicBKjeUGJtnBMba256J5Ao?cluster=devnet",
                  "on_chain_at": "2025-10-27T18:28:49.766120570Z",
                  "tx_hash": "2iWuf6wS4wAbuV6R1ZoCh2x1g9U2g3d2EwJ2jUBR6BRteak7fpsEtxCwDSkpDKgFriicBKjeUGJtnBMba256J5Ao"
                },
                "send_tx": {
                  "chain_id": "11155111",
                  "explorer_link": "https://sepolia.etherscan.io/tx/0x66682E126367F63E9714F78CE4417E8B0096D5DE77F17DF6A179315E7D325BB3",
                  "on_chain_at": "2025-10-27T18:23:48Z",
                  "tx_hash": "0x66682E126367F63E9714F78CE4417E8B0096D5DE77F17DF6A179315E7D325BB3"
                }
              }
            }
          }
        ]
      }
    ]
  },
  "status": "completed"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

tx_hash

string

required

Transaction hash to track

Query Parameters

quote_id

string

Optional quote ID if the transaction was not submitted via the Faraday API

Response

Transaction status successfully retrieved.

provider

string

required

Provider name (e.g., "Skip Go", "Squid", "Axelar").

Example:

"Skip Go"

raw

object

required

Raw provider payload for debugging or analytics.

status

enum<string>

required

Normalized transaction status (Pending, Completed, etc.)

Available options:

submitted,

pending,

completed,

failed,

abandoned,

unknown

Example:

"pending"

Get all available quotes for a stablecoin transfer Get a transaction by hash

⌘I

Overview

Architecture

Integration Guide

Product Information

API Reference

Track a transaction by hash

Query Parameters

Authorizations

Path Parameters

Query Parameters

Response