Create Transfer

POST /api/v2/travelrule/transfers

This endpoint initiates the transfer of Travel Rule data between entities. It activates the essential data collection and verification procedures. Request Body

Name	Type	Description	Required
amount	number	The amount of the DTI asset.	True
dti	string	Unique identifier for the assets based on DTIF standards. Example: 4H95J0R2X (see https://dtif.org)	True
protocol	string	Travel Rule protocol. Examples: trp, gtr, flow, trisa	True
beneficiary_vasp_id	string	6 character ID of the receiving Virtual Asset Service Provider (VASP). Example: ABCXYZ	True
originator_address	string	Blockchain address of the sender. If an account is already linked to the originator_address, it will be used as the originator account. Otherwise, an account can be linked either through the "Assign an Address to Account" endpoint or by providing a originator_account_reference_id. Example: 12higDjoCCNXSA95xZMWUdPvXNmkAduhWv	True
beneficiary_address	string	Blockchain address of the recipient. If an account is already linked to the beneficiary_address, it will be used as the beneficiary account. Otherwise, an account can be linked either through the "Assign an Address to Account" endpoint or by providing a beneficiary_account_reference_id. Example: bc1qas2rvpejpvncd6z5hcscvw52n4wxw5th2de67v	True
originator_account_reference_id	string	Sender's account ID within the originator VASP. If provided, the originator_account_reference_id must match the linked account in the originator_address. If no linked account exists, the provided account will be linked instead. Example: account5678
beneficiary_account_reference_id	string	Recipient's account ID within the originator VASP. If provided, the beneficiary_account_reference_id must match the linked account in the beneficiary_address. If no linked account exists, the provided account will be linked instead. Example: account1234
transaction_hash	string	Unique ID of the blockchain transaction. Example: 80003fee6bcbb2726b4d6466d690fce6caaa03771aada747eb0651637514b893
reference_id	string	Unique identifier for the transfer. Example: transfer7890

Response

200

{
  "status": "success",
  "data": {
    "transfer_id": "018f7212-18be-7713-ad7c-89704e18bd5c",
    "amount": 1,
    "amount_usd": 101234.00,
    "dti": "4H95J0R2X",
    "dti_name_short": [
      "BTC",
      "XBT"
    ],
    "dti_name_long": "Bitcoin",
    "protocol": "trp",
    "beneficiary_vasp_id": "ABCXYZ",
    "originator_address": "12higDjoCCNXSA95xZMWUdPvXNmkAduhWv",
    "beneficiary_address": "bc1qas2rvpejpvncd6z5hcscvw52n4wxw5th2de67v",
    "originator_account_reference_id": "account5678",
    "beneficiary_account_reference_id": "account1234",
    "transaction_hash": "80003fee6bcbb2726b4d6466d690fce6caaa03771aada747eb0651637514b893",
    "transfer_status": "REVIEW"
  }
}