Submit Securities Transfer Request

Endpoint Parameters

• Request parameters

  Name	Type	Origin	Description
  AccountKey	AccountKey	Body	The account identifier in key format from which securities transfer is executed
  AssetType	TransferableAssetType	Body	The asset type to be transferred
  Broker	Broker	Body	The client's broker details
  ClientAccountAtBroker	String	Body	Identifier of the client's account at the broker
  ClientKey	ClientKey	Body	The client identifier in key format for which system will execute securities transfer
  Securities	Security []	Body	The securities details
  SettlementDate	Date	Body	The settlement date
  SettlementInstruction	SettlementInstruction	Body	Settlement Instruction
  TradeDate	Date	Body	The agreed trade date
  TransferDirection	TransferDirection	Body	Transfer type, in or out of Bank

• Response Parameters

  View Response Codes

  Name	Type	Description
  TransferId	String	Unique transaction id for the transfer

  HTTP Code	Description
  201	Created	Resource was created.
  400	Bad Request	Error Code Description AccountValidationFail Account Validation Failed AssetTypeNotSupported Requested Asset Type is not supported BadRequest Bad Request UicNotValidAssetType The UIC does not match a transferable asset type 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/transfers

  Request Body

  {
    "AccountKey": "dIm75edbgnW6aBK3CIc-sw==",
    "AssetType": "Stock",
    "Broker": {
      "Contact": "Broker Contact 1",
      "CountryCode": "DK",
      "Email": "BrokerEmail1@email.com",
      "Name": "ABC Investment Bank",
      "Phone": "+45 12345678"
    },
    "ClientAccountAtBroker": "0539633313",
    "ClientKey": "zpSlGZ4F0cPIx59wR3HP1g==",
    "Securities": [
      {
        "Currency": "EUR",
        "Description": "Apple Inc.",
        "Exchange": "NASDAQ",
        "InstrumentSymbolCode": "AAPL:xnas",
        "IsinCode": "US0378331005",
        "Price": 194.82,
        "PurchaseDate": "2020-06-20T00:00:00Z",
        "Quantity": 24,
        "Uic": 211
      },
      {
        "Currency": "GBP",
        "Description": "ABB Ltd",
        "Exchange": "SSE",
        "InstrumentSymbolCode": "ABB:xome",
        "IsinCode": "CH0012221716",
        "Price": 32.82,
        "PurchaseDate": "2020-09-10T00:00:00Z",
        "Quantity": 7,
        "Uic": 101
      }
    ],
    "SettlementInstruction": {
      "AccountAtClearingAgent": "0539633313",
      "AgentLocalAccount": "6300772196",
      "BuyerSellerCode": "B",
      "BuyerSellerCodeType": "Bic",
      "ClearingAgentCode": "9200",
      "ClearingAgentCodeType": "Bic",
      "FreeText": "NOTLXNO",
      "SettlementAgentAccount": "1011248400G"
    },
    "TradeDate": "2024-04-29T00:00:00Z",
    "TransferDirection": "TransferIn"
  }
  

• Response Example

  Response body

  {
    "TransferId": "63HGCDS3E89DS"
  }