openapi: 3.0.1
info:
title: Envestnet Aggregation APIs Account Token Verify Account API
description: 'This file describes the Yodlee Aggregation product APIs using the swagger notation that you can use to build your financial application. You can generate the client SDK in Python, JavaScript, PHP, or any other languages according to your development needs. For more details about the APIs, refer to Yodlee API v1.1 - Overview.
You will have to set the header before making the API call. The following headers apply to all the APIs:
- Authorization: This header holds the access token
- Api-Version: 1.1
Note: If there are any API-specific headers, they are mentioned explicitly in the respective API''s description.'
termsOfService: https://developer.yodlee.com/terms/condition
contact:
email: developer@yodlee.com
license:
name: Yodlee Developer License
url: https://developer.yodlee.com/terms/condition#_Services_1
version: 1.1.0
servers:
- url: /
tags:
- name: Verify Account
description: Verify Account API
paths:
/verifyAccount/{providerAccountId}:
post:
tags:
- Verify Account
summary: Envestnet Verify Accounts Using Transactions
description: The verify account service is used to verify the account's ownership by matching the transaction details with the accounts aggregated for the user.
- If a match is identified, the service returns details of all the accounts along with the matched transaction's details.
- If no transaction match is found, an empty response will be returned.
- A maximum of 5 transactionCriteria can be passed in a request.
- The baseType, date, and amount parameters should mandatorily be passed.
- The optional dateVariance parameter cannot be more than 7 days. For example, +7, -4, or +/-2.
- Pass the container or accountId parameters for better performance.
- This service supports the localization feature and accepts locale as a header parameter.
operationId: initiateAccountVerification
parameters:
- name: providerAccountId
in: path
description: providerAccountId
required: true
schema:
type: string
requestBody:
description: verificationParam
content:
application/json:
schema:
$ref: '#/components/schemas/VerifyAccountRequest'
required: true
responses:
200:
description: OK
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/VerifyAccountResponse'
400:
description: 'Y800 : Invalid value for container
Y800 : Invalid value for accountId
Y800 : Invalid value for amount
Y800 : Invalid value for dateVariance
Y801 : Invalid length for keyword
Y804 : Permitted values of dateVariance between 1 - 7
Y806 : Invalid input
Y807 : Resource not found
Y809 : Invalid date range
Y812 : Required field/value - transactionCriteria missing in the input
Y812 : Required field/value - amount missing in the transactionCriteria
Y812 : Required field/value - amount date in the transactionCriteria
Y812 : Required field/value - baseType missing in the transactionCriteria
Y823 : Transaction not applicable for container
Y824 : The maximum number of transactionCriteria permitted is 5
Y857 : Transactions are not refreshed in the past 24 hours
Y858 : Only active accounts can be verified
Y901 : Service not supported
'
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/YodleeError'
401:
description: Unauthorized
content: {}
404:
description: Not Found
content: {}
deprecated: false
components:
schemas:
Name:
title: Name
type: object
properties:
middle:
type: string
description: Middle name.
last:
type: string
description: Last name.
fullName:
type: string
description: Full name.
first:
type: string
description: First name.
Coordinates:
title: Coordinates
type: object
properties:
latitude:
type: number
description: 'Latitude of the merchant
Applicable containers: bank,creditCard,loan
'
format: double
longitude:
type: number
description: 'Longitude of the merchant
Applicable containers: bank,creditCard,loan
'
format: double
Transaction:
title: Transaction
type: object
properties:
date:
type: string
description: 'The value provided will be either postDate or transactionDate. postDate takes higher priority than transactionDate, except for the investment container as only transactionDate is available. The availability of postDate or transactionDate depends on the provider site.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
sourceId:
type: string
description: A unique ID that the provider site has assigned to the transaction. The source ID is only available for the pre-populated accounts.
Pre-populated accounts are the accounts that the FI customers shares with Yodlee, so that the user does not have to add or aggregate those accounts.
readOnly: true
symbol:
type: string
description: 'The symbol of the security being traded.
Note: The settle date field applies only to trade-related transactions.
Applicable containers: investment
'
readOnly: true
cusipNumber:
type: string
description: 'The CUSIP (Committee on Uniform Securities Identification Procedures) identifies the financial instruments in the United States and Canada.
Note: The CUSIP number field applies only to trade related transactions.
Applicable containers: investment
'
readOnly: true
highLevelCategoryId:
type: integer
description: 'The high level category assigned to the transaction. The supported values are provided by the GET transactions/categories.
Applicable containers: bank,creditCard,investment,insurance,loan
'
format: int64
readOnly: true
detailCategoryId:
type: integer
description: 'The id of the detail category that is assigned to the transaction. The supported values are provided by GET transactions/categories.
Applicable containers: bank,creditCard
'
format: int64
readOnly: true
description:
$ref: '#/components/schemas/Description'
memo:
type: string
description: 'Additional notes provided by the user for a particular transaction through application or API services.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
settleDate:
type: string
description: 'It is the date on which the transaction is finalized, that is, the date the ownership of the security is transferred to the buyer. The settlement date is usually few days after the transaction date.
Applicable containers: investment
'
readOnly: true
type:
type: string
description: 'The nature of the transaction, i.e., deposit, refund, payment, etc.
Note: The transaction type field is available only for the United States, Canada, United Kingdom, New Zealand and India based provider sites.
Applicable containers: bank,creditCard,investment
'
readOnly: true
intermediary:
type: array
description: 'The intermediary of the transaction.
Applicable containers: bank,creditCard,investment,loan
'
readOnly: true
items:
type: string
baseType:
type: string
description: 'Indicates if the transaction appears as a debit or a credit transaction in the account.
Applicable containers: bank,creditCard,investment,insurance,loan
Applicable Values
'
readOnly: true
enum:
- CREDIT
- DEBIT
categorySource:
type: string
description: 'Indicates the source of the category, i.e., categories derived by the system or assigned/provided by the consumer. This is the source field of the transaction category resource. The supported values are provided by the GET transactions/categories.
Applicable containers: bank,creditCard,investment,insurance,loan
Applicable Values
'
readOnly: true
enum:
- SYSTEM
- USER
principal:
$ref: '#/components/schemas/Money'
lastUpdated:
type: string
readOnly: true
interest:
$ref: '#/components/schemas/Money'
price:
$ref: '#/components/schemas/Money'
commission:
$ref: '#/components/schemas/Money'
id:
type: integer
description: 'An unique identifier for the transaction. The combination of the id and account container are unique in the system.
Applicable containers: bank,creditCard,investment,insurance,loan
'
format: int64
readOnly: true
merchantType:
type: string
description: 'Indicates the merchantType of the transaction.e.g:-BILLERS,SUBSCRIPTION,OTHERS
Applicable containers: bank,creditCard,investment,loan
'
readOnly: true
amount:
$ref: '#/components/schemas/Money'
checkNumber:
type: string
description: 'The checkNumber of the transaction.
Applicable containers: bank
'
readOnly: true
isPhysical:
type: boolean
description: 'Indicates if the transaction is happened online or in-store.
Applicable containers: bank,creditCard,investment,loan
'
readOnly: true
quantity:
type: number
description: 'The quantity associated with the transaction.
Note: The quantity field applies only to trade-related transactions.
Applicable containers: investment
'
format: double
readOnly: true
valoren:
type: string
description: 'It is an identification number that is assigned to financial instruments such as stocks and bonds trading in Switzerland.
Applicable containers: investment
'
readOnly: true
isManual:
type: boolean
description: 'Indicates if the transaction is aggregated from the FI site or the consumer has manually created the transaction using the application or an API.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
merchant:
$ref: '#/components/schemas/Merchant'
sedol:
type: string
description: 'SEDOL stands for Stock Exchange Daily Official List, a list of security identifiers used in the United Kingdom and Ireland for clearing purposes.
Applicable containers: investment
'
readOnly: true
transactionDate:
type: string
description: 'The date the transaction happens in the account.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
categoryType:
type: string
description: 'The categoryType of the category assigned to the transaction. This is the type field of the transaction category resource. The supported values are provided by the GET transactions/categories.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
enum:
- TRANSFER
- DEFERRED_COMPENSATION
- UNCATEGORIZE
- INCOME
- EXPENSE
accountId:
type: integer
description: 'The account from which the transaction was made. This is basically the primary key of the account resource.
Applicable containers: bank,creditCard,investment,insurance,loan
'
format: int64
readOnly: true
createdDate:
type: string
readOnly: true
sourceType:
type: string
description: 'The source through which the transaction is added to the Yodlee system.
Applicable containers: bank,creditCard,investment,insurance,loann
Applicable Values:
'
readOnly: true
enum:
- AGGREGATED
- MANUAL
CONTAINER:
type: string
description: 'The account''s container.
Applicable containers: bank,creditCard,investment,insurance,loan
Applicable Values
'
readOnly: true
enum:
- bank
- creditCard
- investment
- insurance
- loan
- reward
- bill
- realEstate
- otherAssets
- otherLiabilities
postDate:
type: string
description: 'The date on which the transaction is posted to the account.
Applicable containers: bank,creditCard,insurance,loan
'
readOnly: true
parentCategoryId:
type: integer
description: 'The parentCategoryId of the category assigned to the transaction.
Note: This field will be provided in the response if the transaction is assigned to a user-created category.
Applicable containers: bank,creditCard,investment,insurance,loan
'
format: int64
readOnly: true
subType:
type: string
description: 'The transaction subtype field provides a detailed transaction type. For example, purchase is a transaction type and the transaction subtype field indicates if the purchase was made using a debit or credit card.
Note: The transaction subtype field is available only in the United States, Canada, United Kingdom, New Zealand and India.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
enum:
- OVERDRAFT_CHARGE
- ONLINE_PURCHASE
- TAX_PAYMENT
- PAYMENT_BY_CHECK
- ATM_CASH_WITHDRAWAL
- SERVICE_CHARGE
- RETURNED_CHECK_CHARGE
- STOP_PAYMENT_CHARGE
- CONVENIENCE_FEE
- AUTO_LOAN
- HOME_LOAN_MORTGAGE
- RECURRING_SUBSCRIPTION_PAYMENT
- INTEREST
- PAYMENT
- PURCHASE
- REFUND
- TRANSFER
- FINANCE_CHARGE
- OTHER_CHARGES_FEES
- ANNUAL_FEE
- DEPOSIT
- DIRECT_DEPOSIT_SALARY
- INVESTMENT_INCOME_CASH
- SSA
- REWARDS
- TAX_REFUND
- CREDIT_CARD_PAYMENT
- INSURANCE_PAYMENT
- UTILITIES_PAYMENT
- CHILD_SUPPORT
- LOAN
- PERSONAL_LOAN
- STUDENT_LOAN
- REIMBURSEMENT
- BALANCE_TRANSFER
- OVERDRAFT_PROTECTION
- CREDIT
- NSF_FEES
category:
type: string
description: 'The name of the category assigned to the transaction. This is the category field of the transaction category resource. The supported values are provided by the GET transactions/categories.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
runningBalance:
$ref: '#/components/schemas/Money'
categoryId:
type: integer
description: 'The id of the category assigned to the transaction. This is the id field of the transaction category resource. The supported values are provided by the GET transactions/categories.
Applicable containers: bank,creditCard,investment,insurance,loan
'
format: int64
readOnly: true
holdingDescription:
type: string
description: 'For transactions involving securities, this captures the securities description.
Applicable containers: investment
'
readOnly: true
isin:
type: string
description: 'International Securities Identification Number (ISIN) standard is used worldwide to identify specific securities.
Applicable containers: investment
'
readOnly: true
status:
type: string
description: 'The status of the transaction: pending or posted.
Note: Most FI sites only display posted transactions. If the FI site displays transaction status, same will be aggregated.
Applicable containers: bank,creditCard,investment,insurance,loan
Applicable Values
'
readOnly: true
enum:
- POSTED
- PENDING
- SCHEDULED
- FAILED
- CLEARED
VerifyAccountRequest:
title: VerifyAccountRequest
required:
- transactionCriteria
type: object
properties:
container:
type: string
enum:
- bank
- creditCard
- investment
- insurance
- loan
- reward
- bill
- realEstate
- otherAssets
- otherLiabilities
accountId:
type: integer
format: int64
transactionCriteria:
type: array
items:
$ref: '#/components/schemas/VerifyTransactionCriteria'
Identifier:
title: Identifier
type: object
properties:
type:
type: string
description: Type of Identifier
readOnly: true
enum:
- NIE
- DNI
- EIN
- BN
- AADHAR
- NIN
- NRIC
value:
type: string
description: Value of the identifier
readOnly: true
VerifyTransactionCriteria:
title: VerifyTransactionCriteria
required:
- amount
- date
type: object
properties:
date:
type: string
amount:
type: number
format: double
verifiedTransaction:
type: array
readOnly: true
items:
$ref: '#/components/schemas/Transaction'
matched:
type: string
description: Indicates if the criteria is matched or not.
Applicable Values
readOnly: true
enum:
- COMPLETE
- NONE
keyword:
type: string
dateVariance:
type: string
baseType:
type: string
description: 'Indicates if the transaction appears as a debit or a credit transaction in the account.
Applicable containers: bank,creditCard,investment,insurance,loan
Applicable Values
'
enum:
- CREDIT
- DEBIT
VerifyAccount:
title: VerifyAccount
type: object
properties:
transactionCriteria:
type: array
items:
$ref: '#/components/schemas/VerifyTransactionCriteria'
account:
type: array
items:
$ref: '#/components/schemas/VerifiedAccount'
AccountAddress:
title: AccountAddress
type: object
properties:
zip:
type: string
description: Zip.
country:
type: string
description: Country.
address3:
type: string
description: Address Line 3.
address2:
type: string
description: Address Line 2.
city:
type: string
description: City.
sourceType:
type: string
address1:
type: string
description: Address Line 1.
street:
type: string
state:
type: string
description: State.
type:
type: string
enum:
- HOME
- BUSINESS
- POBOX
- RETAIL
- OFFICE
- SMALL_BUSINESS
- COMMUNICATION
- PERMANENT
- STATEMENT_ADDRESS
- PAYMENT
- PAYOFF
- UNKNOWN
AccountHolder:
title: AccountHolder
type: object
properties:
identifier:
type: array
description: 'Identifiers of the account holder.
Aggregated / Manual: Aggregated
Applicable containers: bank
Endpoints:- GET accounts
- GET accounts/{accountId}
'
readOnly: true
items:
$ref: '#/components/schemas/Identifier'
gender:
type: string
description: 'Identifiers of the account holder.
Aggregated / Manual: Aggregated
Applicable containers: bank
Endpoints:- GET accounts
- GET accounts/{accountId}
'
readOnly: true
ownership:
type: string
description: 'Indicates the ownership of the account.
Aggregated / Manual: Aggregated
Applicable containers: bank
Endpoints:- GET accounts
- GET accounts/{accountId}
Applicable Values
'
readOnly: true
enum:
- PRIMARY
- SECONDARY
- CUSTODIAN
- OTHERS
- POWER_OF_ATTORNEY
- TRUSTEE
- JOINT_OWNER
- BENEFICIARY
- AAS
- BUSINESS
- DBA
- TRUST
name:
$ref: '#/components/schemas/Name'
VerifiedAccount:
title: VerifiedAccount
type: object
properties:
fullAccountNumber:
type: string
accountType:
type: string
description: 'The type of account that is aggregated, i.e., savings, checking, credit card, charge, HELOC, etc. The account type is derived based on the attributes of the account.
Valid Values:
Aggregated Account Type
bank- CHECKING
- SAVINGS
- CD
- PPF
- RECURRING_DEPOSIT
- FSA
- MONEY_MARKET
- IRA
- PREPAID
creditCard- OTHER
- CREDIT
- STORE
- CHARGE
- OTHER
investment (SN 1.0)- BROKERAGE_MARGIN
- HSA
- IRA
- BROKERAGE_CASH
- 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
- MONEY_MARKET
- 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
- TAX_FREE_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
- DIGITAL_WALLET
- OTHER
investment (SN 2.0)- 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
- DIGITAL_WALLET
- OTHER
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
realEstaterewardManual Account Type
bankcreditloaninsuranceinvestment
Aggregated / Manual: Both
Applicable containers: All containers
'
readOnly: true
providerAccountId:
type: integer
description: 'The primary key of the provider account resource.
Aggregated / Manual: Both
Applicable containers: All containers
'
format: int64
readOnly: true
holder:
type: array
items:
$ref: '#/components/schemas/AccountHolder'
id:
type: integer
format: int64
accountNumber:
type: string
description: 'The account number as it appears on the site. (The POST accounts service response return this field as number)
Additional Details: Bank/ Loan/ Insurance/ Investment:
The account number for the bank account as it appears at the site.
Credit Card: The account number of the card account as it appears at the site,
i.e., the card number.The account number can be full or partial based on how it is displayed in the account summary page of the site.In most cases, the site does not display the full account number in the account summary page and additional navigation is required to aggregate it.
Applicable containers: All Containers
Aggregated / Manual: Both
Endpoints:
- GET accounts
- GET accounts/{accountId}
- POST accounts
'
readOnly: true
bankTransferCode:
type: array
description: 'Bank and branch identification information.
Aggregated / Manual: Aggregated
Applicable containers: bank, investment, loan
Endpoints:
'
readOnly: true
items:
$ref: '#/components/schemas/BankTransferCode'
providerName:
type: string
description: 'Applicable containers: reward, bank, creditCard, investment, loan, insurance, realEstate, otherLiabilities
'
readOnly: true
Contact:
title: Contact
type: object
properties:
phone:
type: string
description: 'Phone number of the merchant
Applicable containers: bank,creditCard,investment,loan
'
email:
type: string
description: 'Email Id of the merchant
Applicable containers: bank,creditCard,investment,loan
'
VerifyAccountResponse:
title: VerifyAccountResponse
type: object
properties:
verifyAccount:
$ref: '#/components/schemas/VerifyAccount'
YodleeError:
title: YodleeError
type: object
properties:
errorMessage:
type: string
description: The descriptive message that explains the error scenario.
readOnly: true
errorCode:
type: string
description: The error code follows the format YNNN. The error codes do not change. New error codes may be added as we introduce new features and enhance functionalities.
readOnly: true
referenceCode:
type: string
description: Unique Yodlee identifier used to troubleshoot issues at Yodlee's end.
readOnly: true
Merchant:
title: Merchant
type: object
properties:
website:
type: string
description: 'The website of the merchant.
Applicable containers: bank,creditCard,investment,loan
'
readOnly: true
address:
$ref: '#/components/schemas/AccountAddress'
contact:
$ref: '#/components/schemas/Contact'
categoryLabel:
type: array
description: 'The business categories of the merchant.
Applicable containers: bank,creditCard
Applicable Values
'
readOnly: true
items:
type: string
coordinates:
$ref: '#/components/schemas/Coordinates'
name:
type: string
description: 'The name of the merchant.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
id:
type: string
description: 'Identifier of the merchant.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
source:
type: string
description: 'The source through which merchant information is retrieved.
Applicable containers: bank,creditCard,investment,insurance,loan
Applicable Values
'
readOnly: true
enum:
- YODLEE
- FACTUAL
logoURL:
type: string
description: 'The logoURL of the merchant.
Applicable containers: bank,creditCard,investment,loan
'
readOnly: true
BankTransferCode:
title: BankTransferCode
type: object
properties:
id:
type: string
description: 'The FI''s branch identification number.Additional Details: The routing number of the bank account in the United States. For non-United States accounts, it is the IFSC code (India), BSB number (Australia), and sort code (United Kingdom).
Account Type: Aggregated
Applicable containers: bank, investment
Endpoints:
- GET accounts
- GET accounts/{accountId}
- POST verification
'
type:
type: string
description: 'The bank transfer code type varies depending on the region of the account origination.
Account Type: Aggregated
Applicable containers: bank, investment
Endpoints:
- GET accounts
- GET accounts/{accountId}
- POST verification
Applicable Values
'
enum:
- BSB
- IFSC
- ROUTING_NUMBER
- SORT_CODE
Money:
title: Money
type: object
properties:
amount:
type: number
description: Value of amount.
format: double
convertedAmount:
type: number
description: Value of the converted amount.
format: double
currency:
type: string
description: Currency should be a valid three-letter ISO Code.
enum:
- USD
- AUD
- BRL
- CAD
- EUR
- GBP
- HKD
- IDR
- INR
- JPY
- NZD
- SGD
- ZAR
- CNY
- VND
- MYR
- CHF
- AED
- AFA
- ALL
- AMD
- ANG
- AOA
- ARS
- AWG
- AZM
- BAM
- BBD
- BDT
- BGL
- BHD
- BIF
- BMD
- BND
- BOB
- BSD
- BTN
- BWP
- BYR
- BZD
- CDF
- CLP
- COP
- CRC
- CUP
- CVE
- CYP
- CZK
- DJF
- DKK
- DOP
- DZD
- EEK
- EGP
- ERN
- ETB
- FJD
- FKP
- GEL
- GGP
- GHC
- GIP
- GMD
- GNF
- GTQ
- GYD
- HNL
- HRK
- HTG
- HUF
- ILS
- IMP
- IQD
- IRR
- ISK
- JEP
- JMD
- JOD
- KES
- KGS
- KHR
- KMF
- KPW
- KRW
- KWD
- KYD
- KZT
- LAK
- LBP
- LKR
- LRD
- LSL
- LTL
- LVL
- LYD
- MAD
- MDL
- MGF
- MKD
- MMK
- MNT
- MOP
- MRO
- MTL
- MUR
- MVR
- MWK
- MXN
- MZM
- NAD
- NGN
- NIO
- NOK
- NPR
- OMR
- PAB
- PEN
- PGK
- PHP
- PKR
- PLN
- PYG
- QAR
- ROL
- RUR
- RWF
- SAR
- SBD
- SCR
- SDD
- SEK
- SHP
- SIT
- SKK
- SLL
- SOS
- SPL
- SRG
- STD
- SVC
- SYP
- SZL
- THB
- TJR
- TMM
- TND
- TOP
- TRL
- TTD
- TVD
- TWD
- TZS
- UAH
- UGX
- UYU
- UZS
- VEB
- VUV
- WST
- XAF
- XAG
- XAU
- XCD
- XDR
- XOF
- XPD
- XPF
- XPT
- YER
- YUM
- ZMK
- ZWD
- ADP
- ATS
- BEF
- BUK
- CSD
- CSK
- DDM
- DEM
- ECS
- ESP
- FIM
- GRD
- GWP
- IEP
- ITL
- LUF
- MLF
- NLG
- PTE
- SUR
- TPE
- UAK
- XBA
- XBB
- XBC
- XBD
- XEU
- XFO
- XFU
- XGF
- XMK
- XRM
- XTS
- YDD
- YUD
- ZRN
- TJS
- RON
- BGN
- BTC
- XBT
- CNH
- RUB
- TRY
- GHS
- TMT
- ZMW
- VEF
- SSP
- ALK
convertedCurrency:
type: string
description: Currency should be a valid three-letter ISO Code.
enum:
- USD
- AUD
- BRL
- CAD
- EUR
- GBP
- HKD
- IDR
- INR
- JPY
- NZD
- SGD
- ZAR
- CNY
- VND
- MYR
- CHF
- AED
- AFA
- ALL
- AMD
- ANG
- AOA
- ARS
- AWG
- AZM
- BAM
- BBD
- BDT
- BGL
- BHD
- BIF
- BMD
- BND
- BOB
- BSD
- BTN
- BWP
- BYR
- BZD
- CDF
- CLP
- COP
- CRC
- CUP
- CVE
- CYP
- CZK
- DJF
- DKK
- DOP
- DZD
- EEK
- EGP
- ERN
- ETB
- FJD
- FKP
- GEL
- GGP
- GHC
- GIP
- GMD
- GNF
- GTQ
- GYD
- HNL
- HRK
- HTG
- HUF
- ILS
- IMP
- IQD
- IRR
- ISK
- JEP
- JMD
- JOD
- KES
- KGS
- KHR
- KMF
- KPW
- KRW
- KWD
- KYD
- KZT
- LAK
- LBP
- LKR
- LRD
- LSL
- LTL
- LVL
- LYD
- MAD
- MDL
- MGF
- MKD
- MMK
- MNT
- MOP
- MRO
- MTL
- MUR
- MVR
- MWK
- MXN
- MZM
- NAD
- NGN
- NIO
- NOK
- NPR
- OMR
- PAB
- PEN
- PGK
- PHP
- PKR
- PLN
- PYG
- QAR
- ROL
- RUR
- RWF
- SAR
- SBD
- SCR
- SDD
- SEK
- SHP
- SIT
- SKK
- SLL
- SOS
- SPL
- SRG
- STD
- SVC
- SYP
- SZL
- THB
- TJR
- TMM
- TND
- TOP
- TRL
- TTD
- TVD
- TWD
- TZS
- UAH
- UGX
- UYU
- UZS
- VEB
- VUV
- WST
- XAF
- XAG
- XAU
- XCD
- XDR
- XOF
- XPD
- XPF
- XPT
- YER
- YUM
- ZMK
- ZWD
- ADP
- ATS
- BEF
- BUK
- CSD
- CSK
- DDM
- DEM
- ECS
- ESP
- FIM
- GRD
- GWP
- IEP
- ITL
- LUF
- MLF
- NLG
- PTE
- SUR
- TPE
- UAK
- XBA
- XBB
- XBC
- XBD
- XEU
- XFO
- XFU
- XGF
- XMK
- XRM
- XTS
- YDD
- YUD
- ZRN
- TJS
- RON
- BGN
- BTC
- XBT
- CNH
- RUB
- TRY
- GHS
- TMT
- ZMW
- VEF
- SSP
- ALK
Description:
title: Description
type: object
properties:
security:
type: string
description: 'The description will provide the actual name of the security.
Applicable containers: investment
'
readOnly: true
original:
type: string
description: 'Original transaction description as it appears at the FI site.
Applicable containers: creditCard, insurance, loan
'
readOnly: true
simple:
type: string
description: 'The transaction description that appears at the FI site may not be self-explanatory, i.e., the source, purpose of the transaction may not be evident. Yodlee attempts to simplify and make the transaction meaningful to the consumer, and this simplified transaction description is provided in the simple description field.Note: The simple description field is available only in the United States, Canada, United Kingdom, and India.
Applicable containers: creditCard, insurance, loan
'
readOnly: true
consumer:
type: string
description: The description of the transaction as defined by the consumer. The consumer can define or provide more details of the transaction in this field.