Field Reference

Travel Rule fields on PUT /transfer/crypto-destination-address.

All Travel Rule fields live on the travelrule_metadata object on PUT /v2/transfer/crypto-destination-address.

Fields

Field	Type	Required (US)	Description
custodian_type	enum	Always	Type of wallet at the destination: VASP (held at another regulated institution) or PRIVATE (unhosted/self-custody). Drives downstream validation.
vasp.id	string	When custodian_type = VASP (preferred)	Paxos identifier for the receiving institution. Resolve via GET /v2/travelrule/vasps.
vasp.name	string	When custodian_type = VASP and no vasp.id available	Name of the receiving institution. Fallback for institutions not in the Paxos directory.
vasp.website_url	string	When vasp.name is specified	Website URL of the receiving institution. Required alongside vasp.name to identify off-directory VASPs.
transfer_purpose	enum	Optional (US); required in SG/EU	Purpose of the transfer. Recommended for partners with cross-jurisdictional flows.
beneficiary	object	Always	Beneficiary details. Provide either person_details or institution_details, or set self = true for me-to-me transfers.
beneficiary.self	boolean	Optional	Set true when the destination wallet belongs to the same end user as the originator. When set, omit person_details and institution_details.
beneficiary.person_details.first_name	string	When beneficiary is a person	Legal first name.
beneficiary.person_details.last_name	string	When beneficiary is a person	Legal last name.
beneficiary.person_details.physical_address.country	string	When beneficiary is a person	Country of the beneficiary.
beneficiary.institution_details.name	string	When beneficiary is an institution	Legal name of the institution.
beneficiary.institution_details.physical_address.country	string	When beneficiary is an institution	Country of the institution.
beneficiary.person_details.physical_address.address1	string	Optional	Street address line 1.
beneficiary.person_details.physical_address.address2	string	Optional	Street address line 2.
beneficiary.person_details.physical_address.city	string	Optional
beneficiary.person_details.physical_address.province	string	Optional	State or province.
beneficiary.person_details.physical_address.zip_code	string	Optional

Provide either vasp.id or vasp.name + vasp.website_url, not both. Prefer vasp.id — Travel Rule messages can only be transmitted automatically when a directory ID is provided.

Examples

Each example below is a PUT /v2/transfer/crypto-destination-address request body.

Transfer to a person beneficiary at another VASP

{
  "crypto_network": "ETHEREUM",
  "address": "0xe4B0aCA9FB669817775274775b20e52118595515",
  "nickname": "alice_coinbase",
  "identity_id": "b8d9f2a1-3c4e-4f5a-9b6d-7e8f0a1b2c3d",
  "travelrule_metadata": {
    "custodian_type": "VASP",
    "beneficiary": {
      "person_details": {
        "first_name": "Alice",
        "last_name": "Smith",
        "physical_address": {
          "country": "US"
        }
      }
    },
    "vasp": {
      "id": "vasp_01HXYZABC123"
    },
    "transfer_purpose": "TRANSFER_PURPOSE_SAVINGS"
  }
}

Self-transfer to an unhosted wallet

{
  "crypto_network": "ETHEREUM",
  "address": "0xabc...",
  "nickname": "alice_metamask",
  "identity_id": "b8d9f2a1-3c4e-4f5a-9b6d-7e8f0a1b2c3d",
  "travelrule_metadata": {
    "custodian_type": "PRIVATE",
    "beneficiary": {
      "self": true
    }
  }
}

Transfer to a VASP not in the Paxos directory

{
  "crypto_network": "ETHEREUM",
  "address": "0xdef...",
  "travelrule_metadata": {
    "custodian_type": "VASP",
    "beneficiary": {
      "person_details": {
        "first_name": "Bob",
        "last_name": "Jones",
        "physical_address": {
          "country": "DE"
        }
      }
    },
    "vasp": {
      "name": "Some Regional Exchange GmbH",
      "website_url": "https://some-regional-exchange.de"
    },
    "transfer_purpose": "TRANSFER_PURPOSE_GOODS_SERVICES"
  }
}

Transfer to an institution beneficiary

{
  "crypto_network": "ETHEREUM",
  "address": "0xghi...",
  "travelrule_metadata": {
    "custodian_type": "VASP",
    "beneficiary": {
      "institution_details": {
        "name": "Acme Corp",
        "physical_address": {
          "country": "US"
        }
      }
    },
    "vasp": {
      "id": "vasp_01HXYZDEF456"
    },
    "transfer_purpose": "TRANSFER_PURPOSE_INVESTMENT"
  }
}