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
- Fix syntax error on Request URL
07/22/2016
- Updated Example URL
04/29/2016
- Added Change Log