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

Get Private Placement Subscriptions For an Offer

This request returns the list of private placement subscriptions for a specific offer.

Request URL

Syntax GET /restapi/privateplacementoffers/{privateplacementofferoid}/privateplacementorders?orderstatus={value}
Example URL https://api.uat.foliofn.com/restapi/privateplacementoffers/9007199254740992156/privateplacementorders/orderstatus=initial

Query Parameters

Name Value Description
orderstatus all Returns all orders. This is the default option.
initial The orders in the “INITIAL” status.
ordercreated The orders in the “ORDER_CREATED” status.
accepted The orders in the “ACCEPTED” status.
rejected The orders in the “REJECTED” status.
cancelled The orders in the “CANCELLED” status.
processing The orders in the “PROCESSING” status.
complete The orders in the “COMPLETE” status.

Please refer to Order Status Code for more details on order status.

Response Data Fields

Field Description
accountNumber The account number for which this private placement subscription was submitted.
creationTimestamp The time when the private placement subscription was submitted. Follows ISO-8601 formatting.
discretionary Boolean indicator of the discretionary status of the subscription.
“true” indicates that the investment representative is exercising discretion on the subscription,
“false” indicates that the investment representative is entering the order according to the instructions provided by the client.
fillDollarAmount The dollar amount that has been approved to be filled by the issuer. This value will be equal to the requestedDollarAmount unless otherwise reduced by the issuer. After execution, the fillDollarAmount corresponds to the amount received by the investor.
folioNumber The folio number that is associated with this order. For private placement subscriptions, it will be accountNumber + “02”.
originatingMemberOid A unique ID for the member who placed the order.
privatePlacementOfferOid The unique ID of the offer for which the order was placed.
privatePlacementOrderOid The unique ID of the order.
reasonForTrade The reason for this subscription. Please refer to Reasons For Trade for more information.
requestedDollarAmount The dollar amount of the subscription.
side “1” indicates a buy-order and “2” indicates a sell-order.
solicited Boolean indicator of the solicited status of the subscription.
“true” indicates that the investment representative has initiated contact with the client to recommend and affect an offer subscription within their account,
“false” indicates that subscription request has been initiated by the client, either by being placed by the client, directly, or contact made by the client to the investment professional to affect the subscription in their account.
status The private placement subscription status. Please refer to Private Placement Subscription Status for more information.

Response Example


HTTP/1.1 200 OK
X-Powered-By: Servlet/2.5
Server: Sun GlassFish Enterprise Server v2.1.1
Content-Type: application/json
Transfer-Encoding: chunked
Date: Tue, 18 Feb 2014 23:22:13 GMT

[{
   "accountNumber":"RD47652005",
   "creationTimestamp":"2014-02-18T23:17:34.970+0000",
   "discretionary":true,
   "fillDollarAmount":"1000.00000",
   "folioNumber":"RD4765200502",
   "originatingMemberOid":"1513209476052329017",
   "privatePlacementOfferOid":"9007199254740992156",
   "privatePlacementOrderOid":"117",
   "reasonForTrade":"NS",
   "requestedDollarAmount":"1000.00000",
   "side":"1",
   "solicited":true,
   "status":"I"
},
{
   "accountNumber":"RD47652005",
   "creationTimestamp":"2014-02-18T23:18:30.576+0000",
   "discretionary":true,
   "fillDollarAmount":"50000.00000",
   "folioNumber":"RD4765200502",
   "originatingMemberOid":"1513209476052329017",
   "privatePlacementOfferOid":"9007199254740992156",
   "privatePlacementOrderOid":"7349874591868649590",
   "reasonForTrade":"NS",
   "requestedDollarAmount":"50000.00000",
   "side":"1",
   "solicited":true,
   "status":"I"
}]



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