Depending on applicable regulations or business limitations, specific API requests may not be available for your use.

Update a Private Placement Subscription

This request updates a private placement order. You may cancel an order by changing its status to cancelled. Certain information is not updateable by API (i.e., Side and Requested Dollar Amount), so the table below contains only those fields that are updateable.

If you wish to change the Side and/or Requested Dollar Amount, you must cancel the existing order and place a new order with the new values.

Request URL

Syntax PUT /restapi/accounts/{accountnumber}/privateplacementorders/{privateplacementorderoid}
Example URL https://api.uat.foliofn.com/restapi/accounts/RA1234ABCD/privateplacementorders/7710162562058289253

Error Code

Please refer to Error Code for the error codes that can be returned from this API.

Request Data Fields

Field Description
discretionary “true” or “false”. An order giving the investment representative the ability to determine execution parameters for a trade. This discretion can be exercised through control over the side (buy/sell), timing (time of placement of a market order, for instance), price (through use of a limit or stop price), or life (Day versus Good ’Til Canceled/GTC) of the order. If such ability was granted to the investment representative, the order should be marked as having discretion exercised. If the investment professional is entering the order on behalf of the client according to the client’s explicit instruction, or the client is entering the order directly, no discretion has been exercised.
fillDollarAmount The approved amount of an order approved by the security issuer.
privatePlacementOfferOid The private placement offer ID.
privatePlacementOrderOid The private placement order ID. If privatePlacementOrderOid is given, it must be the same as orderoid in the request URL.
reasonForTrade

The reason for this trade.

Please refer to Reasons for Trade for available codes.

solicited “true” or “false”. An order should be marked as solicited if the investment representative has initiated contact with the client to recommend and affect a security transaction within their account. An order should be marked as unsolicited if the security transaction has been initiated by the client directly. This could be the order being placed by the client, or contact made by the client to the investment professional to affect an order on their behalf within their account.
status

Approve, reject, and cancel the order.

Please refer to Private Placement Subscription Status for available codes.

Request Example


PUT /restapi/accounts/RA1234ABCD/privateplacementorders/771771771771771771771 HTTP/1.1
Content-Type: application/json

{
	"discretionary": true,
	"fillDollarAmount": "1000.00000",
	"privatePlacementOfferOid": "706706706706706706706"
	"privatePlacementOrderOid": "771771771771771771771",
	"reasonForTrade": "NS",
	"solicited": false,
	"status": "A",
}

Response Example


HTTP/1.1 200 OK
X-Powered-By: Servlet/2.5
Server: Sun GlassFish Enterprise Server v2.1.1
Location: https://api.uat.foliofn.com/restapi/accounts/RA1234ABCD/privateplacementorders/771771771771771771771
Content-Type: text/html; charset=iso-8859-1
Content-Length: 0
Date: Wed, 19 Feb 2014 19:18:58 GMT


Change Log

12/01/2017

  1. Fix syntax error on Request URL

07/22/2016

  1. Updated Example URL

04/29/2016

  1. Added Change Log

Getting Started

REST APIs

Resources

Developer Home