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: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.
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:' readOnly: true items: $ref: '#/components/schemas/Identifier' gender: type: string description: 'Identifiers of the account holder.

Aggregated / Manual: Aggregated
Applicable containers: bank
Endpoints:' readOnly: true ownership: type: string description: 'Indicates the ownership of the account.

Aggregated / Manual: Aggregated
Applicable containers: bank
Endpoints: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
bankcreditCardinvestment (SN 1.0)investment (SN 2.0)loaninsurancerealEstaterewardManual 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:
' 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:
' 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:
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.