> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paxos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Field Reference

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

All Travel Rule fields live on the `travelrule_metadata` object on [`PUT /v2/transfer/crypto-destination-address`](/api-reference/endpoints/crypto-destination-addresses/put-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`](/api-reference/endpoints/vasps/list-vasps).                  |
| `vasp.custom_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.custom_vasp_website`                                 | string  | When `vasp.custom_vasp_name` is specified               | Website URL of the receiving institution. Required alongside `vasp.custom_vasp_name` to identify off-directory VASPs.                                 |
| `transfer_purpose`                                         | string  | 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                            | ISO 3166-1 alpha-3 country code (e.g. `USA`).                                                                                                         |
| `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                      | ISO 3166-1 alpha-3 country code (e.g. `USA`).                                                                                                         |
| `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.custom_vasp_name` + `vasp.custom_vasp_website`, 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`](/api-reference/endpoints/crypto-destination-addresses/put-crypto-destination-address) request body.

### Transfer to a person beneficiary at another VASP

```json theme={null}
{
  "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": "USA"
        }
      }
    },
    "vasp": {
      "id": "0b3d9f1e-7c2a-4e8b-9f1a-2c3d4e5f6a7b"
    },
    "transfer_purpose": "Investment"
  }
}
```

### Self-transfer to an unhosted wallet

```json theme={null}
{
  "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

```json theme={null}
{
  "crypto_network": "ETHEREUM",
  "address": "0xdef...",
  "travelrule_metadata": {
    "custodian_type": "VASP",
    "beneficiary": {
      "person_details": {
        "first_name": "Bob",
        "last_name": "Jones",
        "physical_address": {
          "country": "DEU"
        }
      }
    },
    "vasp": {
      "custom_vasp_name": "Some Regional Exchange GmbH",
      "custom_vasp_website": "https://some-regional-exchange.de"
    },
    "transfer_purpose": "Goods and services"
  }
}
```

### Transfer to an institution beneficiary

```json theme={null}
{
  "crypto_network": "ETHEREUM",
  "address": "0xghi...",
  "travelrule_metadata": {
    "custodian_type": "VASP",
    "beneficiary": {
      "institution_details": {
        "name": "Acme Corp",
        "physical_address": {
          "country": "USA"
        }
      }
    },
    "vasp": {
      "id": "1c4e0a2f-8d3b-4f9c-8a2b-3d4e5f6a7b8c"
    },
    "transfer_purpose": "Investment"
  }
}
```