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

Get an Item for Attention

This request returns a specific item for attention with a member

Request URL

Syntax GET /restapi/members/{loginid}/ifas/{id}
Example URL https://api.uat.foliofn.com/restapi/members/Mbr1234ABCD/ifas/473997

Response Data Fields

Field Description
id The item for attention unique identifier.
ifaType The item for attention type, "NO" -- Notice, "AN" -- Affirmative Notice, "BV" -- Banklink Verification, "MD" -- Banklink Micro Deposit, "AA" -- New Account Certification, "SA" -- Sign Agreement Document, "DU" -- Document Upload, "IA" -- Investment Policy Statement Agreement, "CA" -- Confirm Address.
ifaStatus The item for attention status, "I" -- Initial, "V" -- Viewed, "A" -- Agreed, "R" -- Rejected, "Y" -- Agreed by Advisor, "N" -- Rejected by Advisor, "O" -- Agreed by Other Delivery, "X" -- Rejected by Other Delivery.
targetOid The entity identifier the item for attention is targeted.
targetOidType The entity type the item for attention is targeted, "A" -- Account, "B" -- Banklink.
forceResponse Action is required for the item.
forceView View is required for the item document.
viewsRemaining Number of view times remaining, -100 indicates no limit.
numberOfViews Number of views allowed, -100 indicates no limit.
actorOid Identity of the actor who handles the item.
actionDateTime Date time when item is handled.
readDocumentKey The read document identifier. readDocumentKey contains two fields, documentKey and documentPartnerCode
readDocumentPath The read document path
writeDocumentKey The write document identifier. writeDocumentKey contains two fields, documentKey and documentPartnerCode
writeDocumentPartnerCode The write document path.
startDate The item for attention in effect start date.
expirationDate The date the item for attention will be expired.
viewDateTime Date time the item is viewed.
priority The priorty for the item.

Error Codes

HTTP Code Status Field Code Description
403 The specified user is not allowed to use this request.
404 item for attention with id not found

Response Example


HTTP/1.1 200 OK
Date: Tue, 07 Jun 2016 17:48:30 GMT
Transfer-Encoding: chunked
Location: https://api.uat.foliofn.com/restapi/members/Mbr1234ABCD/ifas/473997
Content-Type: application/json
Content-Language: en
{
  "forceResponse" : true,
  "forceView" : true,
  "itemForAttentionId" : "480376",
  "itemForAttentionStatus" : "I",
  "itemForAttentionType" : "AA",
  "memberOid" : "2666130981338318535",
  "numberOfViews" : "-100",
  "priority" : "8999",
  "readDocumentKey" :
  {
    "documentKey" : "pc.acct.agreement.r",
    "documentPartnerCode" : "WHITE-LABEL"
  },
  "readDocumentPath" : "/WHITE-LABEL/sections/Public Content/pdf/CustomerAgreementRetail",
  "targetOid" : "2522015793262462671",
  "targetOidType" : "A",
  "viewsRemaining" : "-100",
  "writeDocumentKey" :
  {
    "documentKey" : "MD62448000.ACA",
    "documentPartnerCode" : "DEFAULT"
  },
  "writeDocumentPath" : "/DEFAULT/sections/Account Documents/MD62448000/Folio Account Agreement"
}

Change Log

03/12/2020

  1. Remove the “Description” title

12/02/2016

  1. New documentation

Getting Started

REST APIs

Resources