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

Get All Documents For a Private Placement Offer

This request returns the list of required and non-required documents that are provided by the issuer to investors interested in making a subscription. Those documents marked as required must be presented to investors prior to any submission of subscription.

Request URL

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

Request Header Fields

Field	Required?	Description
X-Associated-Member-Id	Yes	When an advisor downloads a document list on behalf of a client, the client’s username must be sent in the X-Associated-Member-Id header.

Response Data Fields

Field	Description
id	The unique identifier of a document associated with the offer.
loginIdViewing	The username of the end user for whom the currently logged-in member (advisor) retrieves the document.
name	The name of the document. (e.g. “Offering Memorandum”, “Private Placement Memorandum”, “Subscription Agreement”, etc.
required	A Boolean indicator of whether the document is required or not. “true” or “false”. If the document is required, subscription can be made only after the document is viewed.
signable	A Boolean indicator of whether the document is signable or not. “true” or “false”. If documentationExternal is false and a signable document has been viewed by the investor who subscribes to the offer, the document is recorded as being signed in our database when the subscription is submitted.
version	The version of the document. The format is majorVersion.minorVerion.
viewed	A Boolean indicator of whether the latest version of the document has been viewed for the member loginIdViewing before: “true” or “false”. This field is a placeholder for future usage and returns always ‘false’. API clients should not use this information until further notice.

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 22:21:48 GMT

[{
   "id":"410f0f6c-b485-440f-9840-b0e8125692a3",
   "loginIdViewing":"testclient1",
   "name":"memorandum.pdf",
   "required" : true,
   "signable":false,
   "title":"Private Placement Memorandum",
   "version":"0.1",
   "viewed":false
},
{
   "id":"48589fe3-9992-4549-9206-c2ba93fc1523",
   "loginIdViewing":"testclient1",
   "name":"subscription_agreement.pdf",
   "required" : true,
   "signable":false,
   "title":"Subscription Agreement",
   "version":"0.1",
   "viewed":false
},
{
   "id":"f9a088e8-43ca-4eb7-8850-949b4362d1f0",
   "loginIdViewing":"testclient1",
   "name":"PP Order Agreement Placeholder.pdf",
   "required" : true,
   "signable":true,
   "title":"PP Order Agreement",
   "version":"2.0",
   "viewed":false
}]