February 28, 2017

February 2017 Release Notes

Envestnet | Yodlee

Enhancements Summary

  1. What follow are the enhancements to existing services as part of this release:
    1. Get Holdings service will provide the securityType field in the response for customers who have opted for Security Normalization 2.0 (SN 2.0).
    2. As a part of enhanced security the Add Provider Account service has been restricted to allow users to link only 100 accounts over 24 hours for the same provider. The number of accounts that can be allowed is configurable at the cobrand level.
    3. The Update Provider Account service has been restricted to allow users to update a maximum of 10 accounts in the 402 error state over 24 hours. There is no restriction on updating accounts that are not in a 402 error state.
    4. Get Accounts and Get Account Details services have been enhanced:
      1. To provide an overDraftLimit parameter in the response for bank containers for the AUS, INDIA, UK & NZ.
      2. To provide reconInfo in the response for the reconciled and unreconciled investment accounts. This is relevant only for the customers for whom the reconciliation feature is turned on.
    5. accountReconType has been added as an input filter for Get Accounts, Get Transactions, Get Transactions Count, Get Investment Options, Get Historical Balances, Get Holdings, Get Holding Summary, and Get Networth. The default value of accountReconType is “UNRECONCILED.” Accepted values are UNRECONCILED and RECONCILED. (Note: This is relevant for investment accounts only and will be provided only if the reconciliation feature is turned on.)
    6. The Get Transactions service has been enhanced to provide an adjustedTransaction parameter in the response for reconciled accounts.
    7. Account type provided in the get accounts and get account details are revamped to provide better and cleaner account type values for manual and aggregated accounts. (refer to the Appendix)
    8. classificationValue has been introduced as a filter in the get holdings service.
    9. A new parameter has been introduced to exclude transactions in the Add Provider Account and Update Provider Account services. This functionality is available only for customers who requests the full account number, bank transfer code, or holder during add or update provider accounts.

Existing APIs Enhancement Details

Endpoint

Enhancement Details

GET /{cobrandName}/v1/user/accessTokens

The service has been enhanced to provide the url parameter in the response.

GET /{cobrandName}/v1/holdings

The service has been enhanced to provide the following fields in the response:

  1. securityType (available only when SN 2.0 key is turned on)
  2. accruedInterest
  3.  accuruedIncome 
  4. isShort

accountReconType has been provided as an input filter for retrieving holdings of reconciled or unreconciled accounts.

GET  /{cobrandName}/v1/accounts

GET  /{cobrandName}/v1/accounts/{accountId}

The services have been enhanced to provide account information for real estate accounts.

The following fields are provided for manual valuation based real estate accounts:

  1. CONTAINER
  2. providerAccountId
  3. accountName
  4. accountStatus
  5. isAsset
  6. id
  7. lastUpdated
  8. nickname
  9. includeInNetWorth
  10. providerId
  11. providerName
  12. accountType
  13. createdDate
  14. homeValue
  15. estimatedDate
  16. valuationType 

The following fields are provided for SmartZip powered real estate accounts:

  1. CONTAINER
  2. providerAccountId
  3. accountName
  4. accountStatus
  5. isAsset
  6. id
  7. lastUpdated
  8. address
  9. nickname
  10. includeInNetWorth
  11. providerId
  12. providerName
  13. accountType
  14. createdDate
  15. homeValue
  16. estimatedDate
  17. valuationType

The services have been enhanced to provide the following field in the response

  1. overDraftLimit
  2. reconType
  3. reconInfo
accountReconType has been provided as an input filter for retrieving reconciled or unreconciled accounts.

GET /{cobrandName}/v1/derived/holdingSummary

 

The service has been enhanced to provide the links parameter in the response:
This parameter will provide a link to retrieve holdings for the summary request.

The service has been enhanced to provide the following fields in the response:

  1. accruedInterest
  2. accuruedIncome 
  3. securityType 
accountReconType has been provided as an input filter for retrieving the holdings summary with reconciled or unreconciled accounts.

GET  /{cobrandName}/v1/transactions

The service has been enhanced to provide the following parameters in the response:
  1. adjustedTransaction
  2. checkNumber
accountReconType has been provided as an input filter for retrieving transactions of reconciled or unreconciled accounts.
POST  /{cobrandName}/v1/providerAccounts The service has been enhanced to accept a new parameter to exclude transactions
PUT /{cobrandName}/v1/providerAccounts The service has been enhanced to accept a new parameter to exclude transactions
GET /{cobrandName}/v1/transactions/count

GET /{cobrandName}/v1/accounts/investmentPlan/investmentOptions

GET /{cobrandName}/v1/accounts/historicalBalances

GET /{cobrandName}/v1/derived/networth
accountReconType has been provided as an input filter for retrieving providerAccounts of reconciled or unreconciled accounts.

Note:

  1. Real estate accounts can be added only through Yodlee FastLink and there is no provision to add a real estate account through Yodlee API services.

Appendix

The following are the new account type values for SN 2.0 customers.

SNO

Account Types ( if SN 2.0 key is on)

1 BROKERAGE_CASH
2 BROKERAGE_MARGIN
3 INDIVIDUAL_RETIREMENT_ACCOUNT_IRA
4 EMPLOYEE_RETIREMENT_ACCOUNT_401K
5 EMPLOYEE_RETIREMENT_SAVINGS_PLAN_403B
6 TRUST
7 ANNUITY
8 SIMPLE_IRA
9 CUSTODIAL_ACCOUNT
10 BROKERAGE_CASH_OPTION
11 BROKERAGE_MARGIN_OPTION
12 INDIVIDUAL
13 CORPORATE_INVESTMENT_ACCOUNT
14 JOINT_TENANTS_TENANCY_IN_COMMON_JTIC
15 JOINT_TENANTS_WITH_RIGHTS_OF_SURVIVORSHIP_JTWROS
16 JOINT_TENANTS_COMMUNITY_PROPERTY
17 JOINT_TENANTS_TENANTS_BY_ENTIRETY
18 CONSERVATOR
19 ROTH_IRA
20 ROTH_CONVERSION
21 ROLLOVER_IRA
22 EDUCATIONAL
23 EDUCATIONAL_SAVINGS_PLAN_529
24 DEFERRED_COMPENSATION_PLAN_457
25 MONEY_PURCHASE_RETIREMENT_PLAN_401A
26 PROFIT_SHARING_PLAN
27 MONEY_PURCHASE_PLAN
28 STOCK_BASKET_ACCOUNT
29 LIVING_TRUST
30 REVOCABLE_TRUST
31 IRREVOCABLE_TRUST
32 CHARITABLE_REMAINDER_TRUST
33 CHARITABLE_LEAD_TRUST
34 CHARITABLE_GIFT_ACCOUNT
35 SEP_IRA
36 UNIFORM_TRANSFER_TO_MINORS_ACT_UTMA
37 UNIFORM_GIFT_TO_MINORS_ACT_UGMA
38 EMPLOYEE_STOCK_OWNERSHIP_PLAN_ESOP
39 ADMINISTRATOR 
40 EXECUTOR
41 PARTNERSHIP
42 PROPRIETORSHIP
43 CHURCH_ACCOUNT
44 INVESTMENT_CLUB
45 RESTRICTED_STOCK_AWARD
46 CASH_MANAGEMENT_ACCOUNT
47 EMPLOYEE_STOCK_PURCHASE_PLAN_ESPP
48 PERFORMANCE_PLAN
49 BROKERAGE_LINK_ACCOUNT
50 MONEY_MARKET_ACCOUNT
51 SUPERANNUATION
52 REGISTERED_RETIREMENT_SAVINGS_PLAN_RRSP
53 SPOUSAL_RETIREMENT_SAVINGS_PLAN_SRSP
54 DEFERRED_PROFIT_SHARING_PLAN_DPSP
55 NON_REGISTERED_SAVINGS_PLAN_NRSP
56 REGISTERED_EDUCATION_SAVINGS_PLAN_RESP
57 GROUP_RETIREMENT_SAVINGS_PLAN_GRSP
58 LOCKED_IN_RETIREMENT_SAVINGS_PLAN_LRSP
59 RESTRICTED_LOCKED_IN_SAVINGS_PLAN_RLSP
60 LOCKED_IN_RETIREMENT_ACCOUNT_LIRA
61 REGISTERED_PENSION_PLAN_RPP
62 TAX_FREE_SAVINGS_ACCOUNT_TFSA
63 LIFE_INCOME_FUND_LIF
64 REGISTERED_RETIREMENT_INCOME_FUND_RIF
65 SPOUSAL_RETIREMENT_INCOME_FUND_SRIF
66 LOCKED_IN_REGISTERED_INVESTMENT_FUND_LRIF
67 PRESCRIBED_REGISTERED_RETIREMENT_INCOME_FUND_PRIF
68 GUARANTEED_INVESTMENT_CERTIFICATES_GIC
69 REGISTERED_DISABILITY_SAVINGS_PLAN_RDSP
70 DEFINED_CONTRIBUTION_PLAN 
71 DEFINED_BENEFIT_PLAN
72 EMPLOYEE_STOCK_OPTION_PLAN 
73 NONQUALIFIED_DEFERRED_COMPENSATION_PLAN_409A
74 KEOGH_PLAN
75 EMPLOYEE_RETIREMENT_ACCOUNT_ROTH_401K
76 DEFERRED_CONTINGENT_CAPITAL_PLAN_DCCP
77 EMPLOYEE_BENEFIT PLAN
78 EMPLOYEE_SAVINGS_PLAN
79 HEALTH_SAVINGS_ACCOUNT_HSA
80 COVERDELL_EDUCATION_SAVINGS_ACCOUNT_ESA
81 TESTAMENTARY_TRUST
82 ESTATE 
83 GRANTOR_RETAINED_ANNUITY_TRUST_GRAT
84

ADVISORY_ACCOUNT

85 NON_PROFIT_ORGANIZATION_501C
86 HEALTH_REIMBURSEMENT_ARRANGEMENT_HRA
87 INDIVIDUAL_SAVINGS_ACCOUNT_ISA
88 CASH_ISA
89.                    STOCKS_AND_SHARES_ISA
90 INNOVATIVE_FINANCE_ISA
91 JUNIOR_ISA
92 EMPLOYEES_PROVIDENT_FUND_ORGANIZATION_EPFO
93 PUBLIC_PROVIDENT_FUND_PPF
94 EMPLOYEES_PENSION_SCHEME_EPS
95 NATIONAL_PENSION_SYSTEM_NPS
96 INDEXED_ANNUITY
97 ANNUITIZED_ANNUITY
98 VARIABLE_ANNUITY
99 ROTH_403B
100 SPOUSAL_IRA
101 SPOUSAL_ROTH_IRA
102 SARSEP_IRA
103 SUBSTANTIALLY_EQUAL_PERIODIC_PAYMENTS_SEPP
104 OFFSHORE_TRUST
105 IRREVOCABLE_LIFE_INSURANCE_TRUST
106 INTERNATIONAL_TRUST
107 LIFE_INTEREST_TRUST
108 EMPLOYEE_BENEFIT_TRUST
109 PRECIOUS_METAL_ACCOUNT
110 INVESTMENT_LOAN_ACCOUNT
111 GRANTOR_RETAINED_INCOME_TRUST
112 PENSION_PLAN

The following are the account types supported for manual accounts :

Container

Manual Account Type

Bank CHECKING
SAVINGS
CD
PREPAID
creditCard CREDIT
Insurance INSURANCE
Bills BILLS
Investment BROKERAGE_CASH
ANNUITY
Loan PERSONAL_LOAN
HOME_LOAN
Real Estate REAL_ESTATE
Rewards REWARD_POINTS

 

Container

Aggregated Account Type

Bank CHECKING
SAVINGS
CD
PREPAID
PPF
RECURRING_DEPOSIT

creditCard

CREDIT
CHARGE

Investment ( Non Wealth )

BROKERAGE_MARGIN
MONEY_MARKET
IRA
401K
403B
TRUST
ANNUITY
SIMPLE
CUSTODIAL
BROKERAGE_CASH_OPTION
BROKERAGE_MARGIN_OPTION
INDIVIDUAL
CORPORATE
JTTIC
JTWROS
COMMUNITY_PROPERTY
JOINT_BY_ENTIRETY
CONSERVATORSHIP
ROTH
ROTH_CONVERSION
ROLLOVER
EDUCATIONAL
529_PLAN
457_DEFERRED_COMPENSATION
401A
PSP
MPP
STOCK_BASKET
LIVING_TRUST
REVOCABLE_TRUST
IRREVOCABLE_TRUST
CHARITABLE_REMAINDER
CHARITABLE_LEAD
CHARITABLE_GIFT_ACCOUNT
SEP
UTMA
UGMA
ESOPP
ADMINISTRATOR
EXECUTOR
PARTNERSHIP
SOLE_PROPRIETORSHIP
CHURCH
INVESTMENT_CLUB
RESTRICTED_STOCK_AWARD
CMA
EMPLOYEE_STOCK_PURCHASE_PLAN
PERFORMANCE_PLAN
BROKERAGE_LINK_ACCOUNT
BROKERAGE_CASH
SUPER_ANNUATION
REGISTERED_RETIREMENT_SAVINGS_PLAN
SPOUSAL_RETIREMENT_SAVINGS_PLAN
DEFERRED_PROFIT_SHARING_PLAN
NON_REGISTERED_SAVINGS_PLAN
REGISTERED_EDUCATION_SAVINGS_PLAN
GROUP_RETIREMENT_SAVINGS_PLAN
LOCKED_IN_RETIREMENT_SAVINGS_PLAN
RESTRICTED_LOCKED_IN_SAVINGS_PLAN
LOCKED_IN_RETIREMENT_ACCOUNT
REGISTERED_PENSION_PLAN
TAXFREE_SAVINGS_ACCOUNT
LIFE_INCOME_FUND
REGISTERED_RETIREMENT_INCOME_FUND
SPOUSAL_RETIREMENT_INCOME_FUND
LOCKED_IN_REGISTERED_INVESTMENT_FUND
PRESCRIBED_REGISTERED_RETIREMENT_INCOME_FUND
GUARANTEED_INVESTMENT_CERTIFICATES
REGISTERED_DISABILITY_SAVINGS_PLAN

Investment (Wealth)

BROKERAGE_CASH
BROKERAGE_MARGIN
INDIVIDUAL_RETIREMENT_ACCOUNT_IRA
EMPLOYEE_RETIREMENT_ACCOUNT_401K
EMPLOYEE_RETIREMENT_SAVINGS_PLAN_403B
TRUST
ANNUITY
SIMPLE_IRA
CUSTODIAL_ACCOUNT
BROKERAGE_CASH_OPTION
BROKERAGE_MARGIN_OPTION
INDIVIDUAL
CORPORATE_INVESTMENT_ACCOUNT
JOINT_TENANTS_TENANCY_IN_COMMON_JTIC
JOINT_TENANTS_WITH_RIGHTS_OF_SURVIVORSHIP_JTWROS
JOINT_TENANTS_COMMUNITY_PROPERTY
JOINT_TENANTS_TENANTS_BY_ENTIRETY
CONSERVATOR
ROTH_IRA
ROTH_CONVERSION
ROLLOVER_IRA
EDUCATIONAL
EDUCATIONAL_SAVINGS_PLAN_529
DEFERRED_COMPENSATION_PLAN_457
MONEY_PURCHASE_RETIREMENT_PLAN_401A
PROFIT_SHARING_PLAN
MONEY_PURCHASE_PLAN
STOCK_BASKET_ACCOUNT
LIVING_TRUST
REVOCABLE_TRUST
IRREVOCABLE_TRUST
CHARITABLE_REMAINDER_TRUST
CHARITABLE_LEAD_TRUST
CHARITABLE_GIFT_ACCOUNT
SEP_IRA
UNIFORM_TRANSFER_TO_MINORS_ACT_UTMA
UNIFORM_GIFT_TO_MINORS_ACT_UGMA
EMPLOYEE_STOCK_OWNERSHIP_PLAN_ESOP
ADMINISTRATOR
EXECUTOR
PARTNERSHIP
PROPRIETORSHIP
CHURCH_ACCOUNT
INVESTMENT_CLUB
RESTRICTED_STOCK_AWARD
CASH_MANAGEMENT_ACCOUNT
EMPLOYEE_STOCK_PURCHASE_PLAN_ESPP
PERFORMANCE_PLAN
BROKERAGE_LINK_ACCOUNT
MONEY_MARKET_ACCOUNT
SUPERANNUATION
REGISTERED_RETIREMENT_SAVINGS_PLAN_RRSP
SPOUSAL_RETIREMENT_SAVINGS_PLAN_SRSP
DEFERRED_PROFIT_SHARING_PLAN_DPSP
NON_REGISTERED_SAVINGS_PLAN_NRSP
REGISTERED_EDUCATION_SAVINGS_PLAN_RESP
GROUP_RETIREMENT_SAVINGS_PLAN_GRSP
LOCKED_IN_RETIREMENT_SAVINGS_PLAN_LRSP
RESTRICTED_LOCKED_IN_SAVINGS_PLAN_RLSP
LOCKED_IN_RETIREMENT_ACCOUNT_LIRA
REGISTERED_PENSION_PLAN_RPP
TAX_FREE_SAVINGS_ACCOUNT_TFSA
LIFE_INCOME_FUND_LIF
REGISTERED_RETIREMENT_INCOME_FUND_RIF
SPOUSAL_RETIREMENT_INCOME_FUND_SRIF
LOCKED_IN_REGISTERED_INVESTMENT_FUND_LRIF
PRESCRIBED_REGISTERED_RETIREMENT_INCOME_FUND_PRIF
GUARANTEED_INVESTMENT_CERTIFICATES_GIC
REGISTERED_DISABILITY_SAVINGS_PLAN_RDSP
DEFINED_CONTRIBUTION_PLAN
DEFINED_BENEFIT_PLAN
EMPLOYEE_STOCK_OPTION_PLAN
NONQUALIFIED_DEFERRED_COMPENSATION_PLAN_409A
KEOGH_PLAN
EMPLOYEE_RETIREMENT_ACCOUNT_ROTH_401K
DEFERRED_CONTINGENT_CAPITAL_PLAN_DCCP
EMPLOYEE_BENEFIT PLAN
EMPLOYEE_SAVINGS_PLAN
HEALTH_SAVINGS_ACCOUNT_HSA
COVERDELL_EDUCATION_SAVINGS_ACCOUNT_ESA
TESTAMENTARY_TRUST
ESTATE
GRANTOR_RETAINED_ANNUITY_TRUST_GRAT
ADVISORY_ACCOUNT
NON_PROFIT_ORGANIZATION_501C
HEALTH_REIMBURSEMENT_ARRANGEMENT_HRA
INDIVIDUAL_SAVINGS_ACCOUNT_ISA
CASH_ISA
STOCKS_AND_SHARES_ISA
INNOVATIVE_FINANCE_ISA
JUNIOR_ISA
EMPLOYEES_PROVIDENT_FUND_ORGANIZATION_EPFO
PUBLIC_PROVIDENT_FUND_PPF
EMPLOYEES_PENSION_SCHEME_EPS
NATIONAL_PENSION_SYSTEM_NPS
INDEXED_ANNUITY
ANNUITIZED_ANNUITY
VARIABLE_ANNUITY
ROTH_403B
SPOUSAL_IRA
SPOUSAL_ROTH_IRA
SARSEP_IRA
SUBSTANTIALLY_EQUAL_PERIODIC_PAYMENTS_SEPP
OFFSHORE_TRUST
IRREVOCABLE_LIFE_INSURANCE_TRUST
INTERNATIONAL_TRUST
LIFE_INTEREST_TRUST
EMPLOYEE_BENEFIT_TRUST
PRECIOUS_METAL_ACCOUNT
INVESTMENT_LOAN_ACCOUNT
GRANTOR_RETAINED_INCOME_TRUST
PENSION_PLAN

Bill

TELEPHONE
UTILITY
CABLE
WIRELESS
BILLS

Loan

MORTGAGE
INSTALLMENT_LOAN
PERSONAL_LOAN
HOME_EQUITY_LINE_OF_CREDIT
LINE_OF_CREDIT
AUTO_LOAN
STUDENT_LOAN
HOME_LOAN

Insurance

AUTO_INSURANCE
HEALTH_INSURANCE
HOME_INSURANCE
LIFE_INSURANCE
ANNUITY
TRAVEL_INSURANCE
INSURANCE

Real Estate

REAL_ESTATE

Rewards

REWARD_POINTS