Retrieve Transfer
GET /api/v2/travelrule/transfers/{transfer_id OR reference_id}
This endpoint allows users to retrieve detailed information about a specific Travel Rule transfer within the system. It provides comprehensive insights into the transfer, including originator and beneficiary details, transaction amount, timestamps, and status.
Path Parameters
transfer_id
string
The ID of the transfer.
Example: 0663cc41-ef29-7995-8000-2d9b414b3174
True
reference_id
string
Unique identifier for the transfer, generated by the sender.
Example: transfer20250312040414
True
NOTE: reference_id can only be used for transfer requests initiated by the user (outgoing transfers). It cannot be used to query incoming transfer requests received from other parties.
Transfers can be queried using either the transfer_id or the reference_id.
reference_id: A unique identifier provided by the originator when initiating the transfer. It serves as a reference to track and retrieve transfer details and is only applicable for outgoing transfers. For incoming transfers, reference_id is not supported.
transfer_id: A system-generated identifier unique to each transaction. It can be used to track and retrieve details for both outgoing and incoming transfers.
Response
The sample response below shows the transfer details of an individual originator and an entity beneficiary.
{
"status": "success",
"data": {
"transfer_data": {
"transfer_id": "018f85d7-0650-7205-a1d5-011e9587c07c",
"reference_id": "reference-transfer-01",
"amount": 1,
"amount_usd": 101234.00,
"dti": "4H95J0R2X",
"chain": "bitcoin",
"symbol": "BTC",
"protocol": "flow",
"originator_address": "14qViLJfdGaP4EeHnDyJbEGQysnCpwk3gd",
"beneficiary_address": "1F1tAaz5x1HUXrCNLbtMDqcw6o5GNn4xqX",
"routing_number": "1234XYZ",
"transaction_hash": "80003fee6bcbb2726b4d6466d690fce6caaa03771aada747eb0651637514b893",
"transfer_status": "REVIEW",
"created": "2024-12-31T12:40:01.138096+00:00",
"created_by_desc": "John Robert Maxwells"
},
"originator_record": {
"display_name": "John Sean Smith",
"reference_id": "234234",
"customer_id": "customer-1234",
"account_no": 234234,
"name_first": "John ",
"name_middle": "Sean",
"name_last": "Smith",
"name_local_first": null,
"name_local_middle": null,
"name_local_last": null,
"date_of_birth": "1988-06-27",
"place_of_birth": "Singapore",
"nationality_code": "SG",
"residence_country_code": "SG",
"name_legal": null,
"name_business": null,
"name_local_legal": null,
"name_local_business": null,
"registration_country_code": null,
"address_line": "75 High Street",
"address_street_no": "75",
"address_street_name": "High Street ",
"address_building_name": null,
"address_floor": null,
"address_room": null,
"address_department": null,
"address_subdepartment": null,
"address_postbox": null,
"address_city": "Singapore ",
"address_city_location": "Singapore",
"address_region": "Singapore",
"address_district": null,
"address_postcode": "179435 ",
"address_country_code": null,
"email": "[email protected]",
"national_id": "AAE4123",
"national_id_issue_country": "SG"
},
"beneficiary_record": {
"display_name": "Crypto Legal",
"reference_id": "1234123",
"customer_id": "non-customer-4321",
"account_no": null,
"name_first": null,
"name_middle": null,
"name_last": null,
"name_local_first": null,
"name_local_middle": null,
"name_local_last": null,
"date_of_birth": null,
"place_of_birth": null,
"nationality_code": "SG",
"residence_country_code": "SG",
"name_legal": "Crypto Legal",
"name_business": "Crypto Legal",
"name_local_legal": null,
"name_local_business": null,
"registration_country_code": "SG",
"address_line": "111 North Bridge Road, #08-18 Peninsula Plaza",
"address_street_no": "3124123",
"address_street_name": "Peninsula Plaza ",
"address_building_name": null,
"address_floor": null,
"address_room": null,
"address_department": null,
"address_subdepartment": null,
"address_postbox": null,
"address_city": null,
"address_city_location": null,
"address_region": null,
"address_district": null,
"address_postcode": "179098 ",
"address_country_code": "SG",
"email": "[email protected]",
"national_id": "ABXYAZ,
"national_id_issue_country": "SG
},
"originator_vasp": {
"vasp_id": "ABCXYZ",
"name_legal": "Kraken",
"name_business": "Kraken",
"name_local_legal": null,
"name_local_business": null,
"registration_country_code": "US",
"address_type_code": null,
"address_line": "1009 N 1300th W",
"address_street_no": null,
"address_street_name": "1009 N 1300th W",
"address_building_name": null,
"address_floor": null,
"address_room": null,
"address_department": null,
"address_subdepartment": null,
"address_postbox": null,
"address_city": "Pleasant Grove",
"address_city_location": null,
"address_region": "Utah",
"address_district": null,
"address_postcode": "84062",
"address_country_code": "US",
"address_country_desc": "United States",
"email": "[email protected]",
"website": "https://www.kraken.com/",
"national_id": "ABCXYZXX",
"national_id_issue_country": "US"
},
"beneficiary_vasp": {
"vasp_id": "XYZABC",
"name_legal": "Amber Group",
"name_business": "Amber Group",
"name_local_legal": null,
"name_local_business": null,
"registration_country_code": null,
"address_type_code": null,
"address_line": null,
"address_street_no": null,
"address_street_name": null,
"address_building_name": null,
"address_floor": null,
"address_room": null,
"address_department": null,
"address_subdepartment": null,
"address_postbox": null,
"address_city": null,
"address_city_location": null,
"address_region": null,
"address_district": null,
"address_postcode": null,
"address_country_code": "HK",
"address_country_desc": "Hong Kong",
"email": "[email protected]",
"website": "www.ambergroup.io",
"national_id": "XXABZXYE",
"national_id_issue_country": "HK"
}
}
}Last updated