swagger: '2.0'
info:
license:
name: Yodlee Developer License
url: https://developer.yodlee.com/terms/condition#_Services_1
contact:
email: developer@yodlee.com
description: 'This file describes the Yodlee Platform APIs using the swagger notation. You can use this swagger file to generate client side SDKs to the Yodlee Platform APIs for many different programming languages. 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
title: Yodlee Core APIs Account Token Verify Account API
version: 1.1.0
basePath: /
tags:
- name: Verify Account
description: Verify Account API
paths:
/verifyAccount/{providerAccountId}:
post:
summary: Verify Accounts Using Transactions
deprecated: false
produces:
- application/json;charset=UTF-8
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
responses:
200:
schema:
$ref: '#/definitions/VerifyAccountResponse'
description: OK
400:
schema:
$ref: '#/definitions/YodleeError'
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
'
401:
description: Unauthorized
404:
description: Not Found
parameters:
- in: path
name: providerAccountId
description: providerAccountId
type: string
required: true
- schema:
$ref: '#/definitions/VerifyAccountRequest'
in: body
name: verificationParam
description: verificationParam
required: true
tags:
- Verify Account
consumes:
- application/json
definitions:
BusinessCategory:
type: object
title: BusinessCategory
properties:
categoryName:
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
type: string
categoryId:
format: int64
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
'
readOnly: true
type: integer
VerifyAccount:
type: object
title: VerifyAccount
properties:
transactionCriteria:
type: array
items:
$ref: '#/definitions/VerifyTransactionCriteria'
account:
type: array
items:
$ref: '#/definitions/VerifiedAccount'
VerifyAccountResponse:
type: object
title: VerifyAccountResponse
properties:
verifyAccount:
$ref: '#/definitions/VerifyAccount'
LogoURLs:
type: object
title: LogoURLs
properties:
type:
description: 'The merchant type of the logo url (SVG/PNG)
Applicable containers: bank,creditCard,investment,loan
'
readOnly: true
type: string
url:
description: 'The logo url of the merchant
Applicable containers: bank,creditCard,investment,loan
'
readOnly: true
type: string
Merchant:
type: object
title: Merchant
properties:
website:
description: 'The website of the merchant.
Applicable containers: bank,creditCard,investment,loan
'
readOnly: true
type: string
address:
description: 'The address of the merchant associated with the transaction is populated in the merchant address field.
Note: The merchant address field is not available by default and customers will have to specifically request the merchant''s address (that includes city, state, and ZIP of the merchant). The merchant address field is available only for merchants in the United States.
Applicable containers: bank,creditCard
'
readOnly: true
$ref: '#/definitions/AccountAddress'
logoURLs:
description: 'The logoURL of the merchant.
Applicable containers: bank,creditCard,investment,loan
'
readOnly: true
type: array
items:
$ref: '#/definitions/LogoURLs'
contact:
description: 'The merchant contact information like phone and email.
Applicable containers: bank,creditCard,investment,loan
'
$ref: '#/definitions/Contact'
categoryLabel:
description: 'The business categories of the merchant.
Applicable containers: bank,creditCard
Applicable Values
'
readOnly: true
type: array
items:
type: string
coordinates:
description: 'The merchant geolocation coordinates like latitude and longitude.
Applicable containers: bank,creditCard,loan
'
$ref: '#/definitions/Coordinates'
name:
description: 'The name of the merchant.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
type: string
id:
description: 'Identifier of the merchant.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
type: string
source:
description: 'The source through which merchant information is retrieved.
Applicable containers: bank,creditCard,investment,insurance,loan
Applicable Values
'
readOnly: true
type: string
enum:
- YODLEE
- FACTUAL
- FOURSQUARE
logoURL:
description: 'The logoURL of the merchant.
Applicable containers: bank,creditCard,investment,loan
'
readOnly: true
type: string
AccountAddress:
type: object
title: AccountAddress
properties:
zip:
description: Zip.
type: string
country:
description: Country.
type: string
address3:
description: Address Line 3.
type: string
address2:
description: Address Line 2.
type: string
city:
description: City.
type: string
sourceType:
type: string
address1:
description: Address Line 1.
type: string
street:
type: string
state:
description: State.
type: string
type:
type: string
enum:
- HOME
- BUSINESS
- POBOX
- RETAIL
- OFFICE
- SMALL_BUSINESS
- COMMUNICATION
- PERMANENT
- STATEMENT_ADDRESS
- PAYMENT
- PAYOFF
- UNKNOWN
Name:
type: object
title: Name
properties:
middle:
description: Middle name.
type: string
last:
description: Last name.
type: string
fullName:
description: Full name.
type: string
first:
description: First name.
type: string
Contact:
type: object
title: Contact
properties:
phone:
description: 'Phone number of the merchant
Applicable containers: bank,creditCard,investment,loan
'
type: string
email:
description: 'Email Id of the merchant
Applicable containers: bank,creditCard,investment,loan
'
type: string
Description:
type: object
title: Description
properties:
security:
description: 'The description will provide the actual name of the security.
Applicable containers: investment
'
readOnly: true
type: string
original:
description: 'Original transaction description as it appears at the FI site.
Applicable containers: creditCard, insurance, loan
'
readOnly: true
type: string
simple:
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
type: string
consumer:
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.
type: string
Coordinates:
type: object
title: Coordinates
properties:
latitude:
format: double
description: 'Latitude of the merchant
Applicable containers: bank,creditCard,loan
'
type: number
longitude:
format: double
description: 'Longitude of the merchant
Applicable containers: bank,creditCard,loan
'
type: number
Transaction:
type: object
title: Transaction
properties:
date:
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
type: string
sourceId:
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
type: string
symbol:
description: 'The symbol of the security being traded.
Note: The settle date field applies only to trade-related transactions.
Applicable containers: investment
'
readOnly: true
type: string
cusipNumber:
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
type: string
sourceApcaNumber:
description: '6 Digit APCA number for the initiating institution. The field is fixed-width and padded with leading zeros if applicable. This field will be primarily be available for AU Open Banking sites, and for other regions/providers, the population will depend on the availability of data.
Applicable containers: Bank,Card container
'
readOnly: true
type: string
highLevelCategoryId:
format: int64
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
'
readOnly: true
type: integer
memo:
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
type: string
type:
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
type: string
intermediary:
description: 'The intermediary of the transaction.
Applicable containers: bank,creditCard,investment,loan
'
readOnly: true
type: array
items:
type: string
frequency:
description: 'Frequency is set to MONTHLY if the Merchant type is BILLERS or SUBSCRIPTION.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
type: string
lastUpdated:
readOnly: true
type: string
price:
description: 'The price of the security for the transaction.
Note: The price field applies only to the trade related transactions.
Applicable containers: investment
'
readOnly: true
$ref: '#/definitions/Money'
sourceMerchantCategoryCode:
description: 'The merchant category code for an outgoing payment to a merchant. This field will be primarily be available for AU Open Banking sites, and for other regions/providers, the population will depend on the availability of data.
Applicable containers: Bank,Card,Loan container
'
readOnly: true
type: string
id:
format: int64
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
'
readOnly: true
type: integer
checkNumber:
description: 'The checkNumber of the transaction.
Applicable containers: bank
'
readOnly: true
type: string
typeAtSource:
description: 'The type of transaction. This field will be primarily be available for AU Open Banking sites, and for other regions/providers, the population will depend on the availability of data.
Applicable containers: Bank,Card,Loan container
'
readOnly: true
type: string
valoren:
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
type: string
isManual:
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
type: boolean
sourceBillerName:
description: 'Name of the BPAY biller for the transaction (if available). This field will be primarily be available for AU Open Banking sites, and for other regions/providers, the population will depend on the availability of data.
Applicable containers: Bank,Card container
'
readOnly: true
type: string
merchant:
description: 'The name of the merchant associated with the transaction.
Note: The merchant name field is available only in the United States, Canada, United Kingdom, and India.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
$ref: '#/definitions/Merchant'
sedol:
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
type: string
categoryType:
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
type: string
enum:
- TRANSFER
- DEFERRED_COMPENSATION
- UNCATEGORIZE
- INCOME
- EXPENSE
- LOAN
accountId:
format: int64
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
'
readOnly: true
type: integer
sourceType:
description: 'The source through which the transaction is added to the Yodlee system.
Applicable containers: bank,creditCard,investment,insurance,loann
Applicable Values:
'
readOnly: true
type: string
enum:
- AGGREGATED
- MANUAL
subType:
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
type: string
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
holdingDescription:
description: 'For transactions involving securities, this captures the securities description.
Applicable containers: investment
'
readOnly: true
type: string
status:
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
type: string
enum:
- POSTED
- PENDING
- SCHEDULED
- FAILED
- CLEARED
detailCategoryId:
format: int64
description: 'The id of the detail category that is assigned to the transaction. This is a premium attribute which will be returned in the response only if the Detail Category feature is enabled. The supported values are provided by GET transactions/categories.
Applicable containers: bank,creditCard
'
readOnly: true
type: integer
description:
description: 'Description details
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
$ref: '#/definitions/Description'
settleDate:
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: string
baseType:
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
type: string
enum:
- CREDIT
- DEBIT
categorySource:
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
type: string
enum:
- SYSTEM
- USER
principal:
description: 'The portion of the principal in the transaction amount. The transaction amount can be the amount due, payment amount, minimum amount, repayment, etc.
Applicable containers: loan
'
readOnly: true
$ref: '#/definitions/Money'
sourceBillerCode:
description: 'BPAY Biller Code for the transaction (if available). This field will be primarily be available for AU Open Banking sites, and for other regions/providers, the population will depend on the availability of data.
Applicable containers: Bank,Card container
'
readOnly: true
type: string
interest:
description: 'The portion of interest in the transaction amount. The transaction amount can be the amount due, payment amount, minimum amount, repayment, etc.
Applicable containers: loan
'
readOnly: true
$ref: '#/definitions/Money'
commission:
description: 'A commission or brokerage associated with a transaction.
Additional Details:The commission only applies to trade-related transactions.Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
$ref: '#/definitions/Money'
merchantType:
description: 'Indicates the merchantType of the transaction.e.g:-BILLERS,SUBSCRIPTION,BNPL,OTHERS
Applicable containers: bank,creditCard,investment,loan
'
readOnly: true
type: string
amount:
description: 'The amount of the transaction as it appears at the FI site.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
$ref: '#/definitions/Money'
isPhysical:
description: 'Indicates if the transaction is happened online or in-store.
Applicable containers: bank,creditCard,investment,loan
'
readOnly: true
type: boolean
quantity:
format: double
description: 'The quantity associated with the transaction.
Note: The quantity field applies only to trade-related transactions.
Applicable containers: investment
'
readOnly: true
type: number
isRecurring:
description: 'If the transaction is done on a merchant with merchant type as BILLERS/SUBSCRIPTION, then such transactions are marked isRecurring to True or else it is marked as False.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
type: string
transactionDate:
description: 'The date the transaction happens in the account.
Applicable containers: bank,creditCard,investment,insurance,loan
'
readOnly: true
type: string
createdDate:
readOnly: true
type: string
CONTAINER:
description: 'The account''s container.
Applicable containers: bank,creditCard,investment,insurance,loan
Applicable Values
'
readOnly: true
type: string
enum:
- bank
- creditCard
- investment
- insurance
- loan
- reward
- bill
- realEstate
- otherAssets
- otherLiabilities
businessCategory:
description: 'business category details for the SMB customers.
Applicable containers: Bank container
'
readOnly: true
$ref: '#/definitions/BusinessCategory'
postDate:
description: 'The date on which the transaction is posted to the account.
Applicable containers: bank,creditCard,insurance,loan
'
readOnly: true
type: string
parentCategoryId:
format: int64
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
'
readOnly: true
type: integer
category:
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
type: string
runningBalance:
description: 'The running balance in an account indicates the balance of the account after every transaction.
Applicable containers: bank,creditCard,investment
'
readOnly: true
$ref: '#/definitions/Money'
categoryId:
format: int64
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
'
readOnly: true
type: integer
isin:
description: 'International Securities Identification Number (ISIN) standard is used worldwide to identify specific securities.
Applicable containers: investment
'
readOnly: true
type: string
AccountHolder:
type: object
title: AccountHolder
properties:
identifier:
description: 'Identifiers of the account holder.
Aggregated / Manual: Aggregated
Applicable containers: bank
Endpoints:- GET accounts
- GET accounts/{accountId}
'
readOnly: true
type: array
items:
$ref: '#/definitions/Identifier'
gender:
description: 'Identifiers of the account holder.
Aggregated / Manual: Aggregated
Applicable containers: bank
Endpoints:- GET accounts
- GET accounts/{accountId}
'
readOnly: true
type: string
ownership:
description: 'Indicates the ownership of the account.
Aggregated / Manual: Aggregated
Applicable containers: bank
Endpoints:- GET accounts
- GET accounts/{accountId}
Applicable Values
'
readOnly: true
type: string
enum:
- PRIMARY
- SECONDARY
- CUSTODIAN
- OTHERS
- POWER_OF_ATTORNEY
- TRUSTEE
- JOINT_OWNER
- BENEFICIARY
- AAS
- BUSINESS
- DBA
- TRUST
name:
description: 'Name of the account holder.
Aggregated / Manual: Aggregated
Applicable containers: bank
Endpoints:- GET accounts
- GET accounts/{accountId}
'
readOnly: true
$ref: '#/definitions/Name'
YodleeError:
type: object
title: YodleeError
properties:
errorMessage:
description: The descriptive message that explains the error scenario.
readOnly: true
type: string
errorCode:
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
type: string
referenceCode:
description: Unique Yodlee identifier used to troubleshoot issues at Yodlee's end.
readOnly: true
type: string
VerifyAccountRequest:
type: object
title: VerifyAccountRequest
required:
- transactionCriteria
properties:
container:
type: string
enum:
- bank
- creditCard
- investment
- insurance
- loan
- reward
- bill
- realEstate
- otherAssets
- otherLiabilities
accountId:
format: int64
type: integer
transactionCriteria:
type: array
items:
$ref: '#/definitions/VerifyTransactionCriteria'
VerifiedAccount:
type: object
title: VerifiedAccount
properties:
fullAccountNumber:
type: string
accountType:
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
type: string
providerAccountId:
format: int64
description: 'The primary key of the provider account resource.
Aggregated / Manual: Both
Applicable containers: All containers
'
readOnly: true
type: integer
holder:
type: array
items:
$ref: '#/definitions/AccountHolder'
id:
format: int64
type: integer
accountNumber:
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
type: string
bankTransferCode:
description: 'Bank and branch identification information.
Aggregated / Manual: Aggregated
Applicable containers: bank, investment, loan
Endpoints:
'
readOnly: true
type: array
items:
$ref: '#/definitions/BankTransferCode'
providerName:
description: 'Applicable containers: reward, bank, creditCard, investment, loan, insurance, realEstate, otherLiabilities
'
readOnly: true
type: string
Identifier:
type: object
title: Identifier
properties:
type:
description: Type of Identifier
readOnly: true
type: string
enum:
- NIE
- DNI
- EIN
- BN
- AADHAR
- NIN
- NRIC
value:
description: Value of the identifier
readOnly: true
type: string
VerifyTransactionCriteria:
type: object
title: VerifyTransactionCriteria
required:
- amount
- date
properties:
date:
type: string
amount:
format: double
type: number
verifiedTransaction:
readOnly: true
type: array
items:
$ref: '#/definitions/Transaction'
matched:
description: Indicates if the criteria is matched or not.
Applicable Values
readOnly: true
type: string
enum:
- COMPLETE
- NONE
keyword:
type: string
dateVariance:
type: string
baseType:
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
'
type: string
enum:
- CREDIT
- DEBIT
BankTransferCode:
type: object
title: BankTransferCode
properties:
id:
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: string
type:
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
'
type: string
enum:
- BSB
- IFSC
- ROUTING_NUMBER
- SORT_CODE
Money:
type: object
title: Money
properties:
amount:
format: double
description: Value of amount.
type: number
convertedAmount:
format: double
description: Value of the converted amount.
type: number
currency:
description: Currency should be a valid three-letter ISO Code.
type: string
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:
description: Currency should be a valid three-letter ISO Code.
type: string
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