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