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

Upload Member Documents

This request allows uploading a document form into Folio repository for various document types linked to a Member. For uploading forms linked to an account see Submit Account Documents. The document must be in PDF format with an exception for Customer Identification Program verification document which accepts documents in JPG, PNG, and PDF formats.

Request URL

Syntax POST /restapi/members/{loginid}/uploads
Example URL https://api.uat.foliofn.com/restapi/members/bunny010/uploads

Request Data Fields

Field Type Description Required Value
documentData String Document data encoded in Base64. Yes
documentType String The type of document to upload. Yes
  • ACCREDITATION_DOCS
  • CIP_VERIFICATION
  • FINRA_MEMBER_FORM
reference String The reference ID uses to upload the document. No If not specified, use the loginid specified on the URL.
referenceType String The type of reference. No If not specified, use MEMBER.
comments String Notes or handling instructions for the document. No Limit of 300 characters, requests with greater than 300 characters will be truncated.

Request Example


POST http://api.uat.foliofn.com/restapi/members/bunny010/uploads HTTP/1.1
Content-Type: application/json
{
    "documentData": "...document content encoded in Base64...",
    "documentType": "CIP_VERIFICATION"
}

Document Type

  • ACCREDITATION_DOCS
    • Documents submitted to support accreditation status for private placement eligibility.
  • CIP_VERIFICATION
    • Documents submitted to support CIP (Customer Identification Program) verification, note that these are only needed if member fails automated check.
  • FINRA_MEMBER_FORM
    • FINRA Member Approval Form, used by account owners if you are employed by a FINRA member firm.

Response Example


HTTP/1.1 200 OK
Date: XXX
Location: http://api.uat.foliofn.com/restapi/members/bunny010/uploads
Content-Length: 0

Error Codes

HTTP Code Status Field Code Message Description
403 The specified user is not allowed to use this request.
400 reference invalid.value The reference specified on the URL is different from the one specified on the body request.
400 referenceType invalid.value The referenceType is invalid.
400 documentType cannot.be.null The documentType is null.
400 documentType cannot.be.empty The documentType is empty.
400 documentType invalid.value The documentType is invalid.
400 documentData cannot.be.null The documentData is null.
400 documentData cannot.be.empty The documentData is empty.
400 documentData invalid.value The documentData is not correctly encoded.
400 documentUploadService.uploadDocument java.lang.IllegalArgumentException Incompatible category MEMBER_DOCUMENT with document {documentType}: expected ACCOUNT_DOCUMENT Incompatible document type for referenceType MEMBER.
400 documentUploadService.uploadDocument java.lang.IllegalArgumentException Document type is not supported: {documentType} The specified documentType is not supported.
400 documentType   invalid.content.type The document is not in a valid format.

Change Log

03/12/2020

  1. Remove extra spaces, especially at the bottom

05/11/2018

  1. Added new error code
  2. Updated valid documentTypes
  3. Updates on acceptable formats for documents

11/23/2017

  1. Added new field (comments) in Request Data Fields section

07/08/2016

  1. Reordered Page Sections

12/11/2015

  1. New documentation.

Getting Started

REST APIs

Resources