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

Get a Private Placement Offer

This request returns the information for a specific offer. Your firm must be either the creator firm or a participating firm in order to access an offer.

Request URL

Syntax GET /restapi/privateplacementoffers/{privateplacementofferoid}
Example URL https://api.uat.foliofn.com/restapi/privateplacementoffers/6629298651489370598

Response Data Fields

Field Description
blueSkyedStates

The list of states this offer is available for purchase within, as indicated by the issuer. Dependent upon the exemption, Folio allows those investors not residing in one of the indicated states to submit a subscription as the issuer may be able to accept the investor under a de minimus allowance.

Note: If exemption is “C” – Rule 147(Intrastate Offering), only investors residing in the same state (based upon Primary Address state) as the issuer are able to submit subscriptions.

clientsHaveAccess A Boolean indicator of whether the issuer and/or investment firm has indicated the offer is available to be displayed to clients (“true”) or only to investment professionals (“false”).
closingDate The expiration date of the offer. No new subscriptions may be submitted once the offer expiration date is passed.
corporateAccreditationSetting

The accreditation criteria for Corporate investors to be eligible to invest to the offer.

Please refer to Corporate Accreditation Setting Code for available codes.

creatingFirmOid The unique identifier for the firm that created the offer.
creatingFirmRepresentativeOid The unique identifier of the member who represents the offer creating firm.
creatingMemberOid The unique identifier for the member who created the offer.
creationTimestamp The time when the offer was created. Follows ISO-8601 formatting.
daysFromClosingCashIsRequired

The days before the offer expiration date until which cash is required. After the date that cash is required (cash lock date), the locked amount of cash cannot be used for other trading. For example, if the expiration date is 12/01/2013 and daysFromClosingCashIsRequired is 0, the account for which the private placement order was placed should have enough balance to buy the requested private placement shares until the beginning of the expiration date. If the value is 999, cash is required at the time of subscription.

The offer may not be executed prior to this date.

deliveryMethod The method by which the issuer will deliver shares to its clearing broker dealer. Please refer to Delivery Method Code for available codes.
documentationExternal

A Boolean indicator whether the offer documentation is available through the Folio platform, or is being provided separately to the investors by the issuer: “true” or “false”.

If “true”, a list of the available documents may be retrieved using the Get a Document List request.

executionType

The condition when the offer can be executed. If execution type is “ALL_OR_NONE”, offer can be executed only when the total approved subscription amount is equal to offer size. If execution type is “PART_OR_NONE”, offer can be executed only after the total approved subscription amount is equal to or greater than offerMinimum. If execution type is “BEST_EFFORTS”, offer can be executed any time.

Please refer to Offer Execution Type Code for available codes.

exemption

The exemption or exclusion claimed that the offer relies on to raise funds without SEC registration. The exemption selected will impact the availability of the offer to investors.

Please refer to Private Placement Exemption Rules for available codes.

industry

Industry of the issuer.

Please refer to Industry Sector Code for available codes.

iraApproved A Boolean indicator whether the offer was approved to allow IRA accounts. This value currently cannot be set via REST API and is “false” by default.
issuerSize

Size of the issuer in terms of revenue or aggregate net asset value.

Please refer to Issuer Size Code for available codes.

issuingFirmOid A unique identifier for the issuing firm.
issuingRepresentativeOid A unique identifier for the selected representative of the issuing firm.
maximumInvestmentAmount The maximum investment amount per investor.
minimumAnnualIncomeRange

The minimum annual income range of investors to be eligible to the offer.

Please refer to Annual Income Range Code for available codes.

minimumInvestmentAmount The minimum investment amount per investor. The minimum investment amount cannot be less than $0.01.
minimumLiquidNetWorthRange

The minimum liquid net worth range of investors to be eligible to the offer.

Please refer to Liquid Net Worth Range Code for available codes.

minimumNetWorthRange

The minimum net worth range of investors to be eligible to the offer.

Please refer to Net Worth Range Code for available codes.

modificationTimestamp The time when the offer was updated. Follows ISO-8601 formatting.
naturalPersonAccreditationSetting

The accreditation criteria for individual investors to be eligible to invest to the offer.

Please refer to Accreditation Setting Code for available codes.

offerMinimum The minimum value of accepted subscriptions that must be met in order for the offer to be executed by the issuer.
offerName The name of the private placement offer as it will be displayed to investors in their holdings and monthly statements.
offerSize The offer size. Total amount of approved subscriptions must be less than or equal to offerSize; oversubscriptions are not supported currently.
offerStatus

Offer status.

Please refer to Private Placement Offer Status for available codes.

participatingFirms.participatingFirmId The firm ID of a participating firm. The ID must be provided by the participating firm to the offer creating firm.
participatingFirms.participatingFirmStatus

The status of a participating firm after it has been added to an offer. The value of participatingFirmStatus must be always “A” during offer creation. Once the offer is created, the status changes to “P”.

Please refer to Participating Firm Status Code for available codes.

physicalSignatureRequired A Boolean indicator whether a physical signature is required instead of e-signature to sign the required documents: “true” or “false”.
previousExperienceSetting

Requirement for previous experience of private placement of investors.

Please refer to Previous Experience Setting for available codes.

priceDiscountAmount

The amount of price reduction applied to orders from customers of RIA’s.

privatePlacementOfferOid The unique identifier of the private placement offer.
published A Boolean indicator of whether the offer was published or not. “true” or “false”.
publishedDate The publishing date of the offer. Follows ISO-8601 formatting.
security Security information. See Security.
securityType

The type of security.

Please refer to Security Type Code for available codes.

Security

Field Description
security.ticker The ticker of the private placement offer.
security.cusip The CUSIP placeholder of the private placement offer.
security.companyName The same as the offerName for the private placement offer.
security.windowBuyable A Boolean indicator whether this security is window tradable. For private placement, the value is always “false”. windowBuyable is for the intent of preventing a private placement security from being purchased through the folio order process.
security.directBuyable A binary indicator whether this security is direct tradable. For private placement, the value is always “false”. directBuyable is for the intent of preventing a private placement security from being purchased through the folio order process.
security.settlementPeriod The number of days in which cash settles for buys. Currently it is one day for private placement.
security.previousClosingPrice The price on the previous day. Currently price for private security does not change.
instrumentType The security type within our processing engine. All private placement securities are set to “COMSTOCK”.

Response Example


Status Code: 200 OK
Content-Type: application/json
Date: Tue, 17 Dec 2013 13:29:40 GMT
Server: Sun GlassFish Enterprise Server v2.1.1
Transfer-Encoding: chunked
X-Powered-By: Servlet/2.5

{
  "blueSkyedStates" : [ "VA", "CA" ],
  "clientsHaveAccess" : true,
  "closingDate" : "2014-03-09T00:00:00.000-05:00",
  "corporateAccreditationSetting" : “C”,
  "creatingFirmOid" : "4467570830362141032",
  "creatingFirmRepresentativeOid" : "1729382258151666074",
  "creatingMemberOid" : "1729382258151666074",
  "creationTimestamp" : "2014-03-07T14:22:55.563-05:00",
  "daysFromClosingCashIsRequired" : "0",
  "deliveryMethod" : "DVPRVP",
  "documentationExternal" : true,
  "executionType" : “A”,
  "exemption" : "D",
  "industry" : "AGR",
  "iraApproved" : false,
  "issuerSize" : "B",
  "issuingFirmOid" : "2882303762409640972",
  "issuingFirmRepresentativeOid" : "3098476544523424777",
  "maximumInvestmentAmount" : "100000",
  "minimumAnnualIncomeRange" : "1",
  "minimumInvestmentAmount" : "1",
  "minimumLiquidNetWorthRange" : "1",
  "minimumNetWorthRange" : "1",
  "modificationTimestamp" : "2014-03-07T17:09:44.845-05:00",
  "naturalPersonaAccreditationSetting" : "C",
  "offerMinimum" : "1000000.00",
  "offerName" : "PRIV.Z7827 Private REST Endpoint Test",
  "offerSize" : "1000000.0",
  "offerStatus" : "I",
   "participatingFirms" : [ {
        "participatingFirmId" : "POWERINVESTING",
        "participatingFirmStatus" : “A”
   }, {
        "participatingFirmId" : "SMARTINVESTING",
        "participatingFirmStatus" : "D"
   } ],
  "physicalSignatureRequired" : false,
  "previousExperienceSetting" : "N",
  "priceDiscountAmount" : "0.2",
  "privatePlacementOfferOid" : "6629298651489370598",
  "published" : true,
  "publishedDate" : "2014-03-07T00:00:00.000-05:00",
  "security" : {
    "companyName" : "PRIV.Z7827 Private REST Endpoint Test",
    "cusip" : "FPPPPP127",
    "directBuyable" : false,
    "instrumentType" : "COMSTOCK",
    "previousClosingPrice" : "1",
    "settlementPeriod" : "1",
    "ticker" : "PRIV.Z7827",
    "windowBuyable" : false
  },
  "securityType" : "E"
}


Change Log

10/11/2018

  1. Added new field priceDiscountAmount and deliveryMethod

09/21/2018

  1. Updated Response Data Fields

07/22/2016

  1. Updated Example URL

04/29/2016

  1. Added Change Log

Getting Started

REST APIs

Resources