February 2017 Release Notes | Yodlee Developer Portal

Enhancements Summary

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: securityType (available only when SN 2.0 key is turned on) accruedInterest accuruedIncome 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: CONTAINER providerAccountId accountName accountStatus isAsset id lastUpdated nickname includeInNetWorth providerId providerName accountType createdDate homeValue estimatedDate valuationType The following fields are provided for SmartZip powered real estate accounts: CONTAINER providerAccountId accountName accountStatus isAsset id lastUpdated address nickname includeInNetWorth providerId providerName accountType createdDate homeValue estimatedDate valuationType The services have been enhanced to provide the following field in the response overDraftLimit reconType 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: accruedInterest accuruedIncome 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: adjustedTransaction 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:

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