---
updatedAt: 2026-09-04T00:58:11.000Z
agentTools:
  projectIndex: https://developer.drivewealth.com/apis/llms.txt
---

# Asset Transfer Updated

An asset transfer was updated — status change, comment update, or settlement/clearing status change.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Events",
    "version": "2026-11-07",
    "contact": {
      "email": "producteng@drivewealth.tech"
    }
  },
  "servers": [
    {
      "url": "https://bo-api.drivewealth.io/back-office",
      "description": "Sandbox (No Real World Financial/Trading Impact)"
    },
    {
      "url": "https://bo-api.drivewealth.net/back-office",
      "description": "Production"
    }
  ],
  "security": [],
  "x-readme": {
    "explorer-enabled": false,
    "headers": [
      {
        "key": "dw-client-app-key",
        "value": "{{yourAppKey}}"
      }
    ]
  },
  "tags": [
    {
      "name": "Asset Transfer"
    }
  ],
  "components": {
    "schemas": {
      "created": {
        "type": "string",
        "example": "2022-12-11T22:28:21.810Z",
        "description": ""
      },
      "updated": {
        "type": "string",
        "example": "2022-12-11T22:28:21.810Z",
        "description": ""
      },
      "EventClearingNo": {
        "type": "string",
        "example": "0001",
        "description": "The DTCC clearing number of the broker.",
        "minLength": 1,
        "maxLength": 4
      },
      "AssetTransferStatusSnapshot": {
        "type": "object",
        "description": "A code/enum value paired with a human-readable description.",
        "properties": {
          "name": {
            "type": "string",
            "example": "ACAT"
          },
          "description": {
            "type": "string",
            "example": "ACAT transfer"
          }
        }
      },
      "AssetTransferRejectionInfo": {
        "type": "object",
        "description": "Webhook events send rejectionCode as the numeric DTCC code (e.g. \"05\"), not the name form used by AssetTransferAPI.json's AcatRejectionCode enum (e.g. \"BROKER_NOT_MATCH\") — defined as a free string here rather than forcing a too-narrow $ref. See AcatRejectionCode's enum descriptions in AssetTransferAPI.json for the code↔name mapping.",
        "properties": {
          "rejectionCode": {
            "type": "string",
            "example": "05",
            "description": "The numeric DTCC rejection code. Equivalent to the name-form AcatRejectionCode enum used in REST responses — see its enum descriptions in AssetTransferAPI.json for the code↔name mapping."
          },
          "rejectionReason": {
            "type": "string",
            "example": "Invalid Broker Account Number"
          },
          "positions": {
            "type": "object",
            "description": "Map of symbol/CUSIP to a per-security rejection message — present when specific positions (not the whole transfer) were rejected.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "cash": {
            "type": "number",
            "example": -12.25,
            "description": "Present when the rejection is due to a cash/debit-balance issue."
          }
        }
      },
      "AssetTransferUpdateSnapshot": {
        "type": "object",
        "description": "Includes the transfer's near-complete current state, not just the changed fields.",
        "properties": {
          "acatType": {
            "$ref": "#/components/schemas/AssetTransferStatusSnapshot"
          },
          "cash": {
            "type": "number",
            "example": 0.03
          },
          "clearingNo": {
            "$ref": "#/components/schemas/EventClearingNo"
          },
          "comment": {
            "type": "string",
            "example": "comment example"
          },
          "controlNo": {
            "type": "string",
            "example": "99999999999999",
            "description": "DTCC control number — assigned once the transfer enters review."
          },
          "created": {
            "$ref": "#/components/schemas/created"
          },
          "createdBy": {
            "type": "string",
            "example": "123e4567-e89b-12d3-a456-00000000011e"
          },
          "destination": {
            "type": "string",
            "example": "GGGG000032"
          },
          "metadata": {
            "type": "object"
          },
          "positions": {
            "type": "object",
            "description": "Map of instrumentID to share quantity involved in the transfer.",
            "additionalProperties": {
              "type": "number"
            }
          },
          "settlementCode": {
            "type": "string",
            "example": "230",
            "description": "The raw DTCC settlement code. Several codes can map to the same settlementStatus name — see the AcatSettlementStatus schema for the known code list — non-exhaustive."
          },
          "settlementStatus": {
            "type": "string",
            "example": "ACAT_REVIEW_ACCEPTED",
            "description": "The DTCC ACATS settlement status. Kept as an open string, not a closed enum, because DTCC (not DriveWealth) controls this vocabulary and may introduce new values. See the AcatSettlementStatus schema for the known values and their settlementCode mapping — non-exhaustive."
          },
          "source": {
            "type": "string",
            "example": "FOLIO123"
          },
          "sourceAccountType": {
            "$ref": "#/components/schemas/AssetTransferStatusSnapshot"
          },
          "status": {
            "$ref": "#/components/schemas/AssetTransferStatusSnapshot"
          },
          "transferID": {
            "type": "string",
            "example": "acats_123e4567-e89b-12d3-a456-00000000011d"
          },
          "transitType": {
            "type": "integer",
            "example": 1
          },
          "type": {
            "$ref": "#/components/schemas/AssetTransferStatusSnapshot"
          },
          "updated": {
            "$ref": "#/components/schemas/updated"
          },
          "updatedBy": {
            "type": "string",
            "example": "123e4567-e89b-12d3-a456-00000000011e"
          },
          "rejectionInfo": {
            "$ref": "#/components/schemas/AssetTransferRejectionInfo"
          }
        }
      },
      "AssetTransferUpdatedEventPayload": {
        "type": "object",
        "properties": {
          "current": {
            "$ref": "#/components/schemas/AssetTransferUpdateSnapshot"
          },
          "previous": {
            "$ref": "#/components/schemas/AssetTransferUpdateSnapshot"
          },
          "transferID": {
            "type": "string",
            "example": "acats_123e4567-e89b-12d3-a456-00000000011d"
          }
        }
      },
      "AssetTransferUpdatedEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "event_123e4567-e89b-12d3-a456-000000000120"
          },
          "type": {
            "type": "string",
            "enum": [
              "assets.transfer.updated"
            ],
            "x-enumDescriptions": {
              "assets.transfer.updated": "Identifies this as an asset-transfer-updated event."
            }
          },
          "object": {
            "type": "string",
            "example": "ACAT",
            "enum": [
              "ACAT",
              "TEEN"
            ],
            "x-enumDescriptions": {
              "ACAT": "An ACATS transfer.",
              "TEEN": "A minor-to-adult (teen graduation) internal transfer."
            }
          },
          "timestamp": {
            "type": "string",
            "format": "date-time",
            "example": "2026-07-23T07:08:14.121518146Z"
          },
          "payload": {
            "$ref": "#/components/schemas/AssetTransferUpdatedEventPayload"
          }
        }
      }
    }
  },
  "webhooks": {
    "assets.transfer.updated": {
      "post": {
        "summary": "Asset Transfer Updated",
        "operationId": "assetsTransferUpdatedEvent",
        "tags": [
          "Asset Transfer"
        ],
        "description": "An asset transfer was updated — status change, comment update, or settlement/clearing status change.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetTransferUpdatedEvent"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Event received"
          }
        }
      }
    }
  }
}
```

# Sibling pages

* [Asset Transfer Created](https://developer.drivewealth.com/apis/reference/assetstransfercreatedevent.md)
* [Asset Transfer Completed](https://developer.drivewealth.com/apis/reference/assetstransfercompletedevent.md)