# ActivityAccountTransfer

Used to record the movement of funds or shares during the bookkeeping phase of an account transfer and details related to the account transfer

## Example Usage

```typescript
import { ActivityAccountTransfer } from "@apexfintechsolutions/ascend-sdk/models/components";

let value: ActivityAccountTransfer = {};
```

## Fields

| Field                                                                                                                                                                             | Type                                                                                                                                                                              | Required                                                                                                                                                                          | Description                                                                                                                                                                       | Example                                                                                                                                                                           |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `acatsAssetSequenceNumber`                                                                                                                                                        | *string*                                                                                                                                                                          | :heavy_minus_sign:                                                                                                                                                                | Sequence number assigned by the DTCC ACATS transfer system for each asset transferred                                                                                             | 20240424178509                                                                                                                                                                    |
| `acatsControlNumber`                                                                                                                                                              | *string*                                                                                                                                                                          | :heavy_minus_sign:                                                                                                                                                                | Unique Identifier generated by the NSCC ACATS when a transfer is initiated or submitted                                                                                           | 20240360002172                                                                                                                                                                    |
| `accountTransferType`                                                                                                                                                             | [components.ActivityAccountTransferType](../../models/components/activityaccounttransfertype.md)                                                                                  | :heavy_minus_sign:                                                                                                                                                                | The type of asset movement being performed within the lifecycle of an account transfer process                                                                                    | FULL_ACCOUNT_TRANSFER                                                                                                                                                             |
| `action`                                                                                                                                                                          | [components.ActivityAction](../../models/components/activityaction.md)                                                                                                            | :heavy_minus_sign:                                                                                                                                                                | Denotes whether the shares are incoming or outgoing                                                                                                                               | INCOMING                                                                                                                                                                          |
| `additionalInstructions`                                                                                                                                                          | *string*                                                                                                                                                                          | :heavy_minus_sign:                                                                                                                                                                | Free form text field containing additional information about a transaction                                                                                                        | Account Transfer instruction                                                                                                                                                      |
| `contraPartyAccountNumber`                                                                                                                                                        | *string*                                                                                                                                                                          | :heavy_minus_sign:                                                                                                                                                                | Account number at the contra firm                                                                                                                                                 | DBtvTOGIqBu5Pmz9Y14laM6G5jWTACMvwCV22nLYteo                                                                                                                                       |
| `contraPartyId`                                                                                                                                                                   | *string*                                                                                                                                                                          | :heavy_minus_sign:                                                                                                                                                                | Contra party identifier                                                                                                                                                           | 9999                                                                                                                                                                              |
| `fairMarketValue`                                                                                                                                                                 | [components.ActivityFairMarketValue](../../models/components/activityfairmarketvalue.md)                                                                                          | :heavy_minus_sign:                                                                                                                                                                | Total value of the securities being transferred. Used for sponsored transfers activity to ensure cost basis is accurately moved with the assets to the new account                | {<br/>"value": "0.25"<br/>}                                                                                                                                                       |
| `fairMarketValueDate`                                                                                                                                                             | [components.ActivityFairMarketValueDate](../../models/components/activityfairmarketvaluedate.md)                                                                                  | :heavy_minus_sign:                                                                                                                                                                | Date from which the asset was valued and used in the fair market value calculation                                                                                                | {<br/>"day": 28,<br/>"month": 7,<br/>"year": 2025<br/>}                                                                                                                           |
| `giftTransfer`                                                                                                                                                                    | *boolean*                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                | Indicates whether the account transfer constitutes a gift for tax reporting purposes. Used by cost basis and tax systems to ensure proper tax treatment and reporting compliance. | false                                                                                                                                                                             |
| `institution`                                                                                                                                                                     | *string*                                                                                                                                                                          | :heavy_minus_sign:                                                                                                                                                                | Contra party institution for the account transfer                                                                                                                                 | Schwab                                                                                                                                                                            |
| `method`                                                                                                                                                                          | [components.ActivityMethod](../../models/components/activitymethod.md)                                                                                                            | :heavy_minus_sign:                                                                                                                                                                | The method used for the account transfer                                                                                                                                          | ACATS                                                                                                                                                                             |