Overview
Architecture
Integration Guide
Product Information
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"
}Get a transaction
Retrieves a single processed transaction by its unique transaction hash.
Note transactions must be submitted via the Faraday API to be available on this endpoint.
Response
Includes:
- Transaction hash
- Network (e.g., Solana, Ethereum)
- Amount (in base units)
- Travel Rule compliance status
- Timestamp of creation or observation
- Full IVMS101 sender and recipient records, if available
Notes
- If IVMS101 records are missing,
senderorrecipientwill benull. - Use this endpoint to audit a transaction or verify compliance.
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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
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.
The transaction amount in the smallest base unit.
For example, 1 USDC = 1000000 when using 6-decimal precision.
1000000
Timestamp when the transaction was created or first observed.
Uses UTC and ISO 8601 format.
"2025-11-06T19:45:32Z"
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".
"solana"
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.
true
The on-chain transaction hash.
Used to uniquely identify the transaction on the given network.
"0x9a9b6f5a123c4def5678901234567890abcdef1234567890abcdef1234567890"
Full IVMS101 record of the transaction recipient, if available.
Will be null if the recipient record has not been attached or processed.
Show child attributes
Show child attributes
Account numbers (bank or wallet identifiers).
Show child attributes
Show child attributes
Represents a bank or virtual asset account number.
1 - 50"HOLMESACC12345"
[
{
"account_number": "GB29NWBK60161331926819"
}
]Registered or physical addresses.
Show child attributes
Show child attributes
Free format address lines. See IVMS101 Section 5.2.6.3.15 and constraint C8.
1 - 140"[\"Company HQ\", \"Main Street\"]"
Identifies the nature of the address (geographic/home/business). See IVMS101 Section 5.2.6.3.1.
GEOG, HOME, BIZZ "GEOG"
Name of the building or house. See IVMS101 Section 5.2.6.3.6.
1 - 35"Holmes Residence"
Number that identifies the position of a building on a street. See IVMS101 Section 5.2.6.3.5.
1 - 16"221B"
ISO 3166-1 alpha-2 country code. See IVMS101 constraint C3 and Section 5.2.6.3.16.
"GB"
Identifies a subdivision of a country (state/region/province). See IVMS101 Section 5.2.6.3.14.
1 - 35"England"
Identification of a division of a large organisation or building. See IVMS101 Section 5.2.6.3.2.
1 - 35"Compliance Department"
Subdivision within a country subdivision. See IVMS101 Section 5.2.6.3.13.
1 - 35"Greater London"
Floor or storey within a building. See IVMS101 Section 5.2.6.3.7.
1 - 70"2nd Floor"
Numbered box in a post office. See IVMS101 Section 5.2.6.3.8.
1 - 16"PO123"
Postal code. See IVMS101 Section 5.2.6.3.10.
1 - 16"NW1 6XE"
Building room number. See IVMS101 Section 5.2.6.3.9.
1 - 35"Room 221"
Name of a street or thoroughfare. See IVMS101 Section 5.2.6.3.4.
1 - 70"Main Street"
Identification of a sub-division. See IVMS101 Section 5.2.6.3.3.
1 - 35"Risk Team"
Specific location name within the town. See IVMS101 Section 5.2.6.3.12.
1 - 35"Westminster"
Name of built-up area. See IVMS101 Section 5.2.6.3.11.
1 - 35"London"
[
{
"address_type": "GEOG",
"country": "GB",
"town_name": "London"
}
]Timestamp when the person was created (UTC).
"2025-07-29T14:45:00"
Unique identifier of the person record.
"d2fd3b17-1fcd-4c4f-bc0e-3b6f858a5e5d"
List of name identifiers (e.g., legal name, aliases).
Show child attributes
Show child attributes
Indicates if this is the legal name. See IVMS101 constraints C6/C5.
true
The nature of the name specified (legal, alias, birth, etc.). See IVMS101 Section 5.2.4.3.3.
LEGL, ALIA, BIRT, MAID, MISC "LEGL"
Primary identifier (surname or full name). See IVMS101 Section 5.2.4.3.1.
1 - 100"Sherlock Holmes"
Secondary identifier (forenames, initials). See IVMS101 Section 5.2.4.3.2.
100"S. Holmes"
[
{
"is_legal": true,
"kind": "LEGL",
"primary_identifier": "Acme Corp"
}
]National identifiers (e.g., passport, tax ID).
Show child attributes
Show child attributes
ISO 3166-1 alpha-2 country code of the issuing authority. See IVMS101 constraint C3.
"GB"
Specifies the type of the national identifier. See IVMS101 Section 5.2.8.3.2.
1 - 35"LEIX"
An identifier issued by an appropriate issuing authority. See IVMS101 Section 5.2.8.3.1.
1 - 35"GB123456789"
Registration authority code; 8-character. See IVMS101 Sections C9/C10.
8"RA000001"
[
{
"country_of_issue": "GB",
"identifier_type": "tax_id",
"national_identifier": "123456789"
}
]The core person object (either natural or legal).
- Option 1
- Option 2
Show child attributes
Show child attributes
natural Represents a uniquely distinguishable individual; one single person with KYC-related attributes. See IVMS101 Section 5.2.2.3.
Show child attributes
Show child attributes
ISO 3166-1 alpha-2 country code of residence. See IVMS101 constraint C3 and Section 5.2.2.3.6. ISO 3166-1 alpha-2 country code
"GB"
A distinct identifier that uniquely identifies the person to the institution in context. See IVMS101 Section 5.2.2.3.4.
50"HOLMES001"
Date of birth; must be a historic date per constraint C2. See IVMS101 Section 5.2.7.
"1854-01-06"
Place of birth (town/city/subdivision/country). See IVMS101 Section 5.2.7.3.2.
1 - 100"Baker Street, London"
Full IVMS101 record of the transaction sender, if available.
Will be null if the sender record has not been attached or processed.
Show child attributes
Show child attributes
Account numbers (bank or wallet identifiers).
Show child attributes
Show child attributes
Represents a bank or virtual asset account number.
1 - 50"HOLMESACC12345"
[
{
"account_number": "GB29NWBK60161331926819"
}
]Registered or physical addresses.
Show child attributes
Show child attributes
Free format address lines. See IVMS101 Section 5.2.6.3.15 and constraint C8.
1 - 140"[\"Company HQ\", \"Main Street\"]"
Identifies the nature of the address (geographic/home/business). See IVMS101 Section 5.2.6.3.1.
GEOG, HOME, BIZZ "GEOG"
Name of the building or house. See IVMS101 Section 5.2.6.3.6.
1 - 35"Holmes Residence"
Number that identifies the position of a building on a street. See IVMS101 Section 5.2.6.3.5.
1 - 16"221B"
ISO 3166-1 alpha-2 country code. See IVMS101 constraint C3 and Section 5.2.6.3.16.
"GB"
Identifies a subdivision of a country (state/region/province). See IVMS101 Section 5.2.6.3.14.
1 - 35"England"
Identification of a division of a large organisation or building. See IVMS101 Section 5.2.6.3.2.
1 - 35"Compliance Department"
Subdivision within a country subdivision. See IVMS101 Section 5.2.6.3.13.
1 - 35"Greater London"
Floor or storey within a building. See IVMS101 Section 5.2.6.3.7.
1 - 70"2nd Floor"
Numbered box in a post office. See IVMS101 Section 5.2.6.3.8.
1 - 16"PO123"
Postal code. See IVMS101 Section 5.2.6.3.10.
1 - 16"NW1 6XE"
Building room number. See IVMS101 Section 5.2.6.3.9.
1 - 35"Room 221"
Name of a street or thoroughfare. See IVMS101 Section 5.2.6.3.4.
1 - 70"Main Street"
Identification of a sub-division. See IVMS101 Section 5.2.6.3.3.
1 - 35"Risk Team"
Specific location name within the town. See IVMS101 Section 5.2.6.3.12.
1 - 35"Westminster"
Name of built-up area. See IVMS101 Section 5.2.6.3.11.
1 - 35"London"
[
{
"address_type": "GEOG",
"country": "GB",
"town_name": "London"
}
]Timestamp when the person was created (UTC).
"2025-07-29T14:45:00"
Unique identifier of the person record.
"d2fd3b17-1fcd-4c4f-bc0e-3b6f858a5e5d"
List of name identifiers (e.g., legal name, aliases).
Show child attributes
Show child attributes
Indicates if this is the legal name. See IVMS101 constraints C6/C5.
true
The nature of the name specified (legal, alias, birth, etc.). See IVMS101 Section 5.2.4.3.3.
LEGL, ALIA, BIRT, MAID, MISC "LEGL"
Primary identifier (surname or full name). See IVMS101 Section 5.2.4.3.1.
1 - 100"Sherlock Holmes"
Secondary identifier (forenames, initials). See IVMS101 Section 5.2.4.3.2.
100"S. Holmes"
[
{
"is_legal": true,
"kind": "LEGL",
"primary_identifier": "Acme Corp"
}
]National identifiers (e.g., passport, tax ID).
Show child attributes
Show child attributes
ISO 3166-1 alpha-2 country code of the issuing authority. See IVMS101 constraint C3.
"GB"
Specifies the type of the national identifier. See IVMS101 Section 5.2.8.3.2.
1 - 35"LEIX"
An identifier issued by an appropriate issuing authority. See IVMS101 Section 5.2.8.3.1.
1 - 35"GB123456789"
Registration authority code; 8-character. See IVMS101 Sections C9/C10.
8"RA000001"
[
{
"country_of_issue": "GB",
"identifier_type": "tax_id",
"national_identifier": "123456789"
}
]The core person object (either natural or legal).
- Option 1
- Option 2
Show child attributes
Show child attributes
natural Represents a uniquely distinguishable individual; one single person with KYC-related attributes. See IVMS101 Section 5.2.2.3.
Show child attributes
Show child attributes
ISO 3166-1 alpha-2 country code of residence. See IVMS101 constraint C3 and Section 5.2.2.3.6. ISO 3166-1 alpha-2 country code
"GB"
A distinct identifier that uniquely identifies the person to the institution in context. See IVMS101 Section 5.2.2.3.4.
50"HOLMES001"
Date of birth; must be a historic date per constraint C2. See IVMS101 Section 5.2.7.
"1854-01-06"
Place of birth (town/city/subdivision/country). See IVMS101 Section 5.2.7.3.2.
1 - 100"Baker Street, London"