Submit Inter Account Security Transfer Request

Endpoint Parameters

• Request parameters

  Name	Type	Origin	Description
  AssetType	TransferableAssetType	Body	AssetType of the security
  BeneficialOwnershipChange	BeneficialOwnershipChange	Body	Change in Beneficial Ownership.
  FromAccountKey	AccountKey	Body	The from account identifier in key format from which securities transfer is executed
  Price	Number	Body	The price per security
  Quantity	Number	Body	Quantity of security to transfer
  ReversalReference	String	Body	Oriningal reference Reference Number for the reversal request.
  ToAccountKey	AccountKey	Body	The to account identifier in key format to which securities transfer is executed
  TransferType	TransferType	Body	Position Transfer Action New/Reversal.
  Uic	Integer	Body	Uic of the security
  UniqueReference	String	Body	Unique reference Reference Number for the request.

• Response Parameters

  View Response Codes

  Name	Type	Description
  UniqueReference	String	Unique Reference Number for the request.

  HTTP Code	Description
  201	Created	Resource was created.
  400	Bad Request	Error Code Description BadRequest Bad Request ValidationFail General Validation Failed
  401	Unauthorized	Indicates that the request was rejected because the 'Authorization' header was missing in the request or contained an invalid security token.
  404	Not Found	Error Code Description SecurityValidationFail Security Validation Failed
  429	Too Many Requests	The request was rejected due to rate limit being exceeded.
  503	Service Unavailable	Service Unavailable

  Close

• Request Example

  Request URL

  POST /atr/v1/securitiestransfers/interaccounttransfer

  Request Body

  {
    "AssetType": "Stock",
    "BeneficialOwnershipChange": "NCBO",
    "FromAccountKey": "dIm75edbgnW6aBK3CIc-sw==",
    "Price": 12,
    "Quantity": 100,
    "ReversalReference": "78eca8e7-c0e6-4ba0-a9a6-3e23d70f957e",
    "ToAccountKey": "dIm75edbgnW6aBK3CIc-sw==",
    "TransferType": "Reversal",
    "Uic": 43246,
    "UniqueReference": "b1cbce88-8bee-42a0-b67c-d8cc09acd8f5"
  }
  

• Response Example

  Response body

  {
    "UniqueReference": "b1cbce88-8bee-42a0-b67c-d8cc09acd8f5"
  }