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
}]



Change Log

10/11/2018

  1. Updated the description of loginIdViewing

09/27/2018

  1. Updated Response Data Fields
  2. Updated Response Example

07/22/2016

  1. Updated Example URL

04/29/2016

  1. Added Change Log

Getting Started

REST APIs

Resources