--- title: "Verify Accounts Using Transactions" method: POST path: "/verifyAccount/{providerAccountId}" tags: ["Verify Account"] --- # Verify Accounts Using Transactions `POST /verifyAccount/{providerAccountId}` The verify account service is used to verify the account's ownership by matching the transaction details with the accounts aggregated for the user.
## Path parameters - `providerAccountId` string, required ## Request body - VerifyAccountRequest - `container` 'bank' | 'creditCard' | 'investment' | 'insurance' | 'loan' | 'reward' | 'realEstate' | 'otherAssets' | 'otherLiabilities' - `accountId` integer - `transactionCriteria` VerifyTransactionCriteria[], required - `date` string, required - `amount` number, double, required - `verifiedTransaction` Transaction[] - `date` string — 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
- `sourceId` string — 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. - `symbol` string — The symbol of the security being traded.
Note: The settle date field applies only to trade-related transactions.

Applicable containers: investment
- `cusipNumber` string — 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
- `highLevelCategoryId` integer — 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
- `detailCategoryId` integer — 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
- `description` Description - `security` string — The description will provide the actual name of the security.

Applicable containers: investment
- `original` string — Original transaction description as it appears at the FI site.

Applicable containers: creditCard, insurance, loan
- `simple` string — 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
- `consumer` string — The description of the transaction as defined by the consumer. The consumer can define or provide more details of the transaction in this field.

Applicable containers: creditCard, insurance, loan
- `memo` string — Additional notes provided by the user for a particular transaction through application or API services.

Applicable containers: bank,creditCard,investment,insurance,loan
- `settleDate` string — 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
- `type` string — 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, and India based provider sites.

Applicable containers: bank,creditCard,investment
- `baseType` 'CREDIT' | 'DEBIT' — Indicates if the transaction appears as a debit or a credit transaction in the account.

Applicable containers: bank,creditCard,investment,insurance,loan
Applicable Values
- `categorySource` 'SYSTEM' | 'USER' — 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
- `principal` Money - `amount` number, double, required - `currency` 'AUD' | 'BRL' | 'CAD' | 'EUR' | 'GBP' | 'HKD' | 'IDR' | 'INR' | 'JPY' | 'NZD' | 'SGD' | 'USD' | 'ZAR' | 'CNY' | 'VND' | 'MYR' | 'CHF', required - `lastUpdated` string - `interest` Money - `amount` number, double, required - `currency` 'AUD' | 'BRL' | 'CAD' | 'EUR' | 'GBP' | 'HKD' | 'IDR' | 'INR' | 'JPY' | 'NZD' | 'SGD' | 'USD' | 'ZAR' | 'CNY' | 'VND' | 'MYR' | 'CHF', required - `price` Money - `amount` number, double, required - `currency` 'AUD' | 'BRL' | 'CAD' | 'EUR' | 'GBP' | 'HKD' | 'IDR' | 'INR' | 'JPY' | 'NZD' | 'SGD' | 'USD' | 'ZAR' | 'CNY' | 'VND' | 'MYR' | 'CHF', required - `commission` Money - `amount` number, double, required - `currency` 'AUD' | 'BRL' | 'CAD' | 'EUR' | 'GBP' | 'HKD' | 'IDR' | 'INR' | 'JPY' | 'NZD' | 'SGD' | 'USD' | 'ZAR' | 'CNY' | 'VND' | 'MYR' | 'CHF', required - `id` integer — 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
- `amount` Money - `amount` number, double, required - `currency` 'AUD' | 'BRL' | 'CAD' | 'EUR' | 'GBP' | 'HKD' | 'IDR' | 'INR' | 'JPY' | 'NZD' | 'SGD' | 'USD' | 'ZAR' | 'CNY' | 'VND' | 'MYR' | 'CHF', required - `checkNumber` string — The checkNumber of the transaction.

Applicable containers: bank
- `quantity` number, double — The quantity associated with the transaction.
Note: The quantity field applies only to trade-related transactions.

Applicable containers: investment
- `valoren` string — It is an identification number that is assigned to financial instruments such as stocks and bonds trading in Switzerland.

Applicable containers: investment
- `isManual` boolean — 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
- `merchant` Merchant - `website` string — The website of the merchant.

Applicable containers: bank,creditCard,investment,loan
- `address` AccountAddress - `zip` string - `country` string - `address3` string - `address2` string - `city` string - `sourceType` string - `address1` string - `street` string - `state` string - `type` 'HOME' | 'BUSINESS' | 'POBOX' | 'RETAIL' | 'OFFICE' | 'SMALL_BUSINESS' | 'COMMUNICATION' | 'PERMANENT' | 'STATEMENT_ADDRESS' | 'PAYMENT' | 'PAYOFF' | 'UNKNOWN' - `contact` Contact - `phone` string — Phone number of the merchant

Applicable containers: bank,creditCard,investment,loan
- `email` string — Email Id of the merchant

Applicable containers: bank,creditCard,investment,loan
- `categoryLabel` string[] — The business categories of the merchant.

Applicable containers: bank,creditCard
Applicable Values
- `coordinates` Coordinates - `latitude` number, double — Latitude of the merchant

Applicable containers: bank,creditCard,loan
- `longitude` number, double — Longitude of the merchant

Applicable containers: bank,creditCard,loan
- `name` string — The name of the merchant.

Applicable containers: bank,creditCard,investment,insurance,loan
- `id` string — Identifier of the merchant.

Applicable containers: bank,creditCard,investment,insurance,loan
- `source` 'YODLEE' | 'FACTUAL' — The source through which merchant information is retrieved.

Applicable containers: bank,creditCard,investment,insurance,loan
Applicable Values
- `sedol` string — 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
- `transactionDate` string — The date the transaction happens in the account.

Applicable containers: bank,creditCard,investment,insurance,loan
- `categoryType` 'TRANSFER' | 'DEFERRED_COMPENSATION' | 'UNCATEGORIZE' | 'INCOME' | 'EXPENSE' — 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
- `accountId` integer — 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
- `createdDate` string - `sourceType` 'AGGREGATED' | 'MANUAL' — The source through which the transaction is added to the Yodlee system.

Applicable containers: bank,creditCard,investment,insurance,loann
Applicable Values:
- `CONTAINER` 'bank' | 'creditCard' | 'investment' | 'insurance' | 'loan' | 'reward' | 'realEstate' | 'otherAssets' | 'otherLiabilities' — The account's container.

Applicable containers: bank,creditCard,investment,insurance,loan
Applicable Values
- `postDate` string — The date on which the transaction is posted to the account.

Applicable containers: bank,creditCard,insurance,loan
- `parentCategoryId` integer — 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
- `subType` 'AUTH_HOLD' | 'AUTH_REQUEST' | 'OVERDRAFT_CHARGE' | 'CREDIT_ADJUSTMENT' | 'PIN_DEBIT' | 'BANK_DIRECT_DEPOSIT' | 'DIVIDEND_DEPOSIT' | 'INTEREST_SAVINGS' | 'INTEREST_ADJUSTMENT' | 'ONLINE_PURCHASE' | 'PURCHASED_WITH_CHECK' | 'RECURRING_BILLING' | 'TAX_PAYMENT' | 'PAYMENT_BY_CHECK' | 'PAYMENT_PLAN' | 'FEE_REFUND' | 'WIRE_TRANSFER_CHARGE' | 'ACCOUNT_TO_ACCOUNT_TRANSFER' | 'BANK_TO_BANK_TRANSACTION' | 'BANK_TO_NON_BANK_ACCOUNT_TRANSFER' | 'CASH_WITHDRAWAL_AT_FI' | 'ATM_CASH_WITHDRAWAL' | 'AUTH_PROCESSING' | 'AUTH_RELEASE' | 'PRE_AUTH' | 'AUTH_COMPLETE' | 'AUTH_VOID' | 'BALANCE_ENQUIRY' | 'ACCOUNT_VERIFICATION' | 'PRE_AUTH_COMPLETION' | 'SERVICE_CHARGE' | 'SERVICE_CHARGE_FEE_REFUND' | 'RETURNED_CHECK_CHARGE' | 'RETURNED_CHECK_REIMBURSEMENT' | 'CASH_ADVANCE' | 'BILL_PAY_CHARGE' | 'CHECK_IMAGE_SERVICE_CHARGE' | 'OVERDRAFT_PROTECTION_CHARGE' | 'STOP_PAYMENT_CHARGE' | 'CHECKS_ORDERING_CHARGE' | 'MONTHLY_MAINTENANCE_CHARGE' | 'DEBIT_CARD_FEE' | 'CONVENIENCE_FEE' | 'PERSONAL_LOAN_CREDIT' | 'CREDIT_CARD_CREDIT' | 'AUTO_LOAN' | 'HOME_LOAN_MORTGAGE' | 'SHORT_TERM_CREDIT' | 'SIGNATURE_DEBIT' | 'CONTACT_LESS_DEBIT' | 'DEFERRED_DEPOSIT' | 'DEFERRED_BILL_PAY' | 'INSTALLMENT_PAYMENT' | 'RECURRING_SUBSCRIPTION_PAYMENT' | 'HOLD_CHECK_PAYMENT' | 'CAPITAL_GAINS_DISTIBUTION' | 'CG_LONG_TERM_DEPOSIT' | 'OPEN_SALE_DEPOSIT' | 'INTEREST__CHECK' | 'PURCHASE_VOID' | 'PURCHASE_WITH_CREDIT_CARD' | 'PURCHASE_WITH_DEBIT_CARD' | 'CHARGE_A_REPEAT_CUSTOMER' | 'DOWN_PAYMENT_OR_ANNUITY_PAYMENT_OR_DIRECT_PAYMENT' | 'FEE_PAYMENT' | 'FINANCE_CHARGE_REFUND' | 'TRANSACTION_VOID' | 'FEE_VOID' | 'DEBIT_CARD_WITHDRAWAL_AT_STORE' | 'ELECTRONIC_PAYMENT' | 'ACH_DEBIT' | 'ATM_TELLER_DEPOSIT' | 'POS_DEBIT' | 'BANK_ADJUSTMENT' | 'CHARGES_FEES' | 'INTEREST' | 'DEPOSITS_CREDITS' | 'PAYMENT' | 'PURCHASE' | 'REFUND' | 'TRANSFER' | 'WITHDRAWAL' | 'OTHER_DEPOSITS' | 'OTHER_WITHDRAWALS' | 'ADJUSTMENT' | 'FINANCE_CHARGE' | 'OTHER_CHARGES_FEES' | 'ANNUAL_FEE' | 'DEPOSIT' | 'DIRECT_DEPOSIT_SALARY' | 'INVESTMENT_INCOME_CASH' | 'SSA' | 'REWARDS' | 'CHECK_DEPOSIT' | 'MOBILE_REMOTE_DEPOSIT' | 'TELLER_DEPOSIT' | 'TAX_REFUND' | 'CREDIT_CARD_PAYMENT' | 'INSURANCE_PAYMENT' | 'UTILITIES_PAYMENT' | 'CHILD_SUPPORT' | 'LOAN' | 'PERSONAL_LOAN' | 'STUDENT_LOAN' | 'SALES_TAX' | 'REIMBURSEMENT' | 'BALANCE_TRANSFER' | 'WIRE_TRANSFER' | 'OVERDRAFT_PROTECTION' | 'DEBIT' | 'CREDIT' | 'NSF_FEES' — 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, and India.

Applicable containers: bank,creditCard,investment,insurance,loan
- `category` string — 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
- `runningBalance` Money - `amount` number, double, required - `currency` 'AUD' | 'BRL' | 'CAD' | 'EUR' | 'GBP' | 'HKD' | 'IDR' | 'INR' | 'JPY' | 'NZD' | 'SGD' | 'USD' | 'ZAR' | 'CNY' | 'VND' | 'MYR' | 'CHF', required - `categoryId` integer — 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
- `holdingDescription` string — For transactions involving securities, this captures the securities description.

Applicable containers: investment
- `isin` string — International Securities Identification Number (ISIN) standard is used worldwide to identify specific securities.

Applicable containers: investment
- `status` 'POSTED' | 'PENDING' | 'SCHEDULED' | 'FAILED' | 'CLEARED' — 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
- `matched` 'COMPLETE' | 'NONE' — Indicates if the criteria is matched or not.
Applicable Values
- `keyword` string - `dateVariance` string - `baseType` 'CREDIT' | 'DEBIT' — Indicates if the transaction appears as a debit or a credit transaction in the account.

Applicable containers: bank,creditCard,investment,insurance,loan
Applicable Values
## Response `200` OK ## Other responses - `400` — 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
- `401` — Unauthorized - `404` — Not Found --- [API](https://skmtc.net/yodlee/apis/yodlee-core-apis.md) · [All operations](https://skmtc.net/yodlee/apis/yodlee-core-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yodlee/yodlee-core-apis/revisions/3bc0042deba8/schema)