Skip to main content
GET
/
v1
/
transactions
/
{tx_hash}
Get a transaction by hash
curl --request GET \
  --url https://api.faraday.range.org/v1/transactions/{tx_hash} \
  --header 'Authorization: Bearer <token>'
{
  "amount": 1000000,
  "created_at": "2025-11-06T19:45:32Z",
  "network": "eth",
  "recipient": {
    "account_numbers": [
      {
        "account_number": "0x10ADD26fb2D17dA265e0567B8F56cb4687979fbE"
      }
    ],
    "addresses": [
      {
        "address_type": "HOME",
        "country": "CH",
        "street_name": "Reichenbach Falls",
        "town_name": "Meiringen"
      }
    ],
    "kind": "natural",
    "name_identifiers": [
      {
        "primary_identifier": "James Moriarty",
        "type": "LEGL"
      }
    ],
    "national_identifiers": [
      {
        "country": "CH",
        "identifier_type": "RAID",
        "national_identifier": "987654321"
      }
    ],
    "person": {
      "country_of_residence": "CH",
      "customer_identification": "MORIARTY-001",
      "date_of_birth": "1985-02-10",
      "place_of_birth": "Bern"
    }
  },
  "sender": {
    "account_numbers": [
      {
        "account_number": "GvFbpZcqXNoZbAH8ETAA4DYBzaEHY4v2Vt7r71ZqJCTc"
      }
    ],
    "addresses": [
      {
        "address_type": "HOME",
        "building_number": "221B",
        "country": "GB",
        "street_name": "Baker Street",
        "town_name": "London"
      }
    ],
    "kind": "natural",
    "name_identifiers": [
      {
        "primary_identifier": "Sherlock Holmes",
        "type": "LEGL"
      }
    ],
    "national_identifiers": [
      {
        "country": "GB",
        "identifier_type": "RAID",
        "national_identifier": "123456789"
      }
    ],
    "person": {
      "country_of_residence": "GB",
      "customer_identification": "CUST-123",
      "date_of_birth": "1990-05-14",
      "place_of_birth": "London"
    }
  },
  "travel_rule_compliant": true,
  "tx_hash": "0x9a9b6f5a123c4def5678901234567890abcdef1234567890abcdef1234567890"
}

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

Unique transaction hash to retrieve

Response

OK

Transaction successfully retrieved.

Summary of a processed on-chain transaction.

A TransactionReport captures the lifecycle and compliance details of a submitted transfer, including its hash, network, amount, and any associated IVMS101 sender and recipient records.

​
amount
integer
required

The transaction amount in the smallest base unit.

For example, 1 USDC = 1000000 when using 6-decimal precision.

Example:

1000000

​
created_at
string<date-time>
required

Timestamp when the transaction was created or first observed.

Uses UTC and ISO 8601 format.

Example:

"2025-11-06T19:45:32Z"

​
network
string
required

The blockchain network on which the transaction was broadcast.

Typically matches one of the supported Faraday networks such as "osmosis-1", "neutron-1", "ethereum", or "solana-mainnet".

Example:

"solana"

​
travel_rule_compliant
boolean
required

Whether this transaction was compliant with the Travel Rule (FATF R.16).

If true, sender and recipient identity information were successfully attached and transmitted according to IVMS101 standards.

Example:

true

​
tx_hash
string
required

The on-chain transaction hash.

Used to uniquely identify the transaction on the given network.

Example:

"0x9a9b6f5a123c4def5678901234567890abcdef1234567890abcdef1234567890"

​
recipient
object | null

Full IVMS101 record of the transaction recipient, if available.

Will be null if the recipient record has not been attached or processed.

​
sender
object | null

Full IVMS101 record of the transaction sender, if available.

Will be null if the sender record has not been attached or processed.