Skip to main content
GET
/
v1
/
transactions
List transactions for the authenticated user
curl --request GET \
  --url https://api.faraday.range.org/v1/transactions \
  --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.

Response

OK

Transactions successfully retrieved.

​
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.