openapi: 3.0.3
info:
title: Finicity APIs
description: >-
OpenAPI specification for Finicity APIs
contact:
name: Finicity
email: business.development@finicity.com
url: 'https://www.finicity.com/contact/'
version: 1.7.2
servers:
- url: 'https://api.finicity.com'
description: Production
tags:
- name: Accounts
description: Fetch or refresh customer accounts
- name: Analytics and Attributes
description: Generate and fetch consumer attributes (Beta)
- name: App Registration
description: Register and assign apps to customers
- name: Assets
description: Download asset files
- name: Authentication
description: Generate authentication tokens and manage credentials
- name: Bank Statements
description: Fetch account statements and generate reports asynchronously
- name: Cash Flow
description: Generate cash flow reports asynchronously
- name: Connect π
description:
Allow customers to log into their financial institutions and grant
Finicity authorization
- name: Consumers
description:
Create and manage consumers associated with customers in order to use
report services
- name: Customers
description: Enroll and manage customers
- name: Institutions
description: Search and fetch financial institutions
- name: Pay Statements
description: Upload pay statements
- name: Payments
description: Fetch ACH details and account balances
- name: Portfolios
description: Generate portfolios of the most recent reports
- name: Reports
description: Fetch generated reports when ready
- name: Transactions
description:
Fetch customer and account transactions and generate reports
asynchronously
- name: TxPush
description: Manage TxPush subscriptions
- name: Verify Assets
description: Generate asset reports asynchronously
- name: Verify Income and Employment
description: Generate income and employment reports asynchronously
security:
- FinicityAppKey: []
FinicityAppToken: []
paths:
/aggregation/v2/partners/authentication:
post:
tags:
- Authentication
summary: Create Access Token
description: >-
Send Partner ID and Partner Secret to the Partner Authentication service
to obtain a token for accessing Finicity APIs.
* The token is valid for two hours and is required on all calls to the
Finicity APIs
* As a best practice, use a single token for all calls. Assign a
timestamp for each token, and then check the current timestamp before
making any calls. If the token is greater than 90 minutes, generate a
new one.
* β οΈ After five failed attempts to authenticate, your account will be
locked. Contact [support@finicity.com](mailto:support@finicity.com) to
get help resetting your account.
_Supported regions_: 
operationId: CreateToken
requestBody:
$ref: '#/components/requestBodies/CreateTokenRequest'
responses:
'200':
$ref: '#/components/responses/CreateTokenResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/AuthenticationUnauthorizedErrorResponse'
security:
- FinicityAppKey: []
put:
tags:
- Authentication
summary: Modify Partner Secret
description: >-
Change the Partner Secret used to authenticate this partner.
The secret does not expire, but can be changed by calling this API. A
valid Partner Secret may contain upper and lowercase characters,
numbers, and the characters !, @, #, $, %, &, *, _, -, +. It must
include at least one number and at least one letter, and its length
should be between 12 and 255 characters.
_Supported regions_: 
operationId: ModifyPartnerSecret
requestBody:
$ref: '#/components/requestBodies/ModifyPartnerSecretRequest'
responses:
'204':
$ref: '#/components/responses/ModifyPartnerSecretResponse'
'400':
$ref: '#/components/responses/ModifyPartnerSecretBadRequestErrorResponse'
'401':
$ref: '#/components/responses/AuthenticationUnauthorizedErrorResponse'
security:
- FinicityAppKey: []
/connect/v2/generate:
post:
tags:
- Connect π
summary: Generate Connect URL
description: >-
Generate a Connect 2.0 URL link to add within your own applications.
In option, use the `experience` parameter to call Connect (per session)
in the body of the request. Configure the `experience` parameter to
change the brand color, logo, icon, which credit decisioning report to
generate when the Connect application completes, and more.
Note: contact your Sales Account Team to set up the `experience`
parameter.
MVS Developers: You can pre-populate the consumer's SSN on the "Find
employment records" page at the beginning of the MVS payroll app. Pass
the SSN value for the consumer in the body of the request call.
_Supported regions_: 
operationId: GenerateConnectUrl
requestBody:
$ref: '#/components/requestBodies/GenerateConnectUrlRequest'
responses:
'200':
$ref: '#/components/responses/GenerateConnectUrlResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
/connect/v2/generate/lite:
post:
tags:
- Connect π
summary: Generate Lite Connect URL
description: >-
Connect Lite is a variation of Connect Full (`POST
/connect/v2/generate`), which has a limited set of features.
* Sign in, user's credentials, and Multi-Factor Authentication (MFA)
* No user account management
The Connect Web SDK isn't a requirement when using Connect lite.
However, if you want to use the SDK events, routes, and user events,
then you must integrate with the Connect Web SDK.
_Supported regions_: 
operationId: GenerateLiteConnectUrl
requestBody:
$ref: '#/components/requestBodies/GenerateLiteConnectUrlRequest'
responses:
'200':
$ref: '#/components/responses/GenerateConnectUrlResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
/connect/v2/generate/fix:
post:
tags:
- Connect π
summary: Generate Fix Connect URL
description: >-
Use the Connect Fix API when the following conditions occur:
* The connection to the user's financial institution is lost
* The user's credentials were updated (for any number of reasons)
* The user's MFA challenge has expired
_Supported regions_: 
operationId: GenerateFixConnectUrl
requestBody:
$ref: '#/components/requestBodies/GenerateFixConnectUrlRequest'
responses:
'200':
$ref: '#/components/responses/GenerateConnectUrlResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
/connect/v2/send/email:
post:
tags:
- Connect π
summary: Send Connect Email
description: >-
Same as Connect Full (`POST /connect/v2/generate`) but send a Connect
email to a consumer.
_Supported regions_: 
operationId: SendConnectEmail
requestBody:
$ref: '#/components/requestBodies/SendConnectEmailRequest'
responses:
'200':
$ref: '#/components/responses/SendConnectEmailResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
/connect/v2/generate/jointBorrower:
post:
tags:
- Connect π
summary: Generate Connect URL - Joint Borrower
description: >-
Same as Connect Full (`POST /connect/v2/generate`) but for joint
borrowers.
MVS prompts both the primary and joint borrower to enter each of their
financial, payroll, and paystub information in the same Connect session.
_Supported regions_: 
operationId: GenerateJointBorrowerConnectUrl
requestBody:
$ref: '#/components/requestBodies/GenerateJointBorrowerConnectUrlRequest'
responses:
'200':
$ref: '#/components/responses/GenerateJointBorrowerConnectUrlResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
/connect/v2/send/email/jointBorrower:
post:
tags:
- Connect π
summary: Send Connect Email - Joint Borrower
description: >-
Same as Connect Joint Borrower (`POST
/connect/v2/generate/jointBorrower`) but send a Connect email to at
least one of the joint borrower's email addresses.
When the consumer opens the email, MVS prompts both the primary and
joint borrower to enter each of their financial, payroll, and paystub
information in the same Connect session.
_Supported regions_: 
operationId: SendJointBorrowerConnectEmail
requestBody:
$ref: '#/components/requestBodies/SendJointBorrowerConnectEmailRequest'
responses:
'200':
$ref: '#/components/responses/SendConnectEmailResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
/aggregation/v2/customers/testing:
post:
tags:
- Customers
summary: Add Testing Customer
description: >-
Enroll a testing customer ([Test Drive](https://signup.finicity.com/)
accounts).
For using testing customers with FinBank OAuth, you must register a test
application with your systems engineer or account manager. Then, use
that testing `applicationId` when creating testing customers.
Testing Customers can access FinBank profiles (except "FinBank Billable"
profiles), and cannot access live financial institutions.
_Supported regions_: 
operationId: AddTestingCustomer
requestBody:
$ref: '#/components/requestBodies/AddCustomerRequest'
responses:
'201':
$ref: '#/components/responses/AddCustomerResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
/aggregation/v2/customers/active:
post:
tags:
- Customers
summary: Add Customer
description: >-
Enroll an active customer, which is the actual owner of one or more
real-world accounts. This is a billable customer.
Active customers must use the "FinBank Billable" profiles for testing
purposes.
_Supported regions_: 
operationId: AddCustomer
requestBody:
$ref: '#/components/requestBodies/AddCustomerRequest'
responses:
'201':
$ref: '#/components/responses/AddCustomerResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'429':
$ref: '#/components/responses/TooManyRequestsErrorResponse'
/aggregation/v1/customers:
get:
tags:
- Customers
summary: Get Customers
description: >-
Find all customers enrolled by the current partner, where the search
text is found in the customer's username or any combination of
`firstName` and `lastName` fields. If no search text is provided, all
customers will be returned.
_Supported regions_: 
operationId: GetCustomers
parameters:
- $ref: '#/components/parameters/CustomerUsernameParameter'
- $ref: '#/components/parameters/CustomerTypeParameter'
- $ref: '#/components/parameters/CustomerSearchParameter'
- $ref: '#/components/parameters/StartParameter'
- $ref: '#/components/parameters/LimitParameter'
responses:
'200':
$ref: '#/components/responses/GetCustomersResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'/aggregation/v1/customers/{customerId}/application':
get:
tags:
- Customers
summary: Get Customer With App Data by ID
description: >-
Retrieve a customer along with additional details about the OAuth
application.
_Supported regions_: 
operationId: GetCustomerWithAppData
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
responses:
'200':
$ref: '#/components/responses/GetCustomerWithAppDataResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}':
get:
tags:
- Customers
summary: Get Customer by ID
description: >-
Retrieve a customer by ID.
_Supported regions_: 
operationId: GetCustomer
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
responses:
'200':
$ref: '#/components/responses/GetCustomerResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
put:
tags:
- Customers
summary: Modify Customer by ID
description: >-
Modify an enrolled customer by ID.
You must specify either `firstName`, `lastName`, or both in the request.
_Supported regions_: 
operationId: ModifyCustomer
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
requestBody:
$ref: '#/components/requestBodies/ModifyCustomerRequest'
responses:
'204':
$ref: '#/components/responses/ModifyCustomerResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
delete:
tags:
- Customers
summary: Delete Customer by ID
description: >-
Completely remove a customer from the system. This will remove the
customer and all associated accounts and transactions.
β οΈ Use this service carefully! It will not pause for confirmation before
performing the operation!
_Supported regions_: 
operationId: DeleteCustomer
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
responses:
'204':
$ref: '#/components/responses/DeleteCustomerResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v1/customers/{customerId}/consumer':
post:
tags:
- Consumers
summary: Create Consumer
description: >-
Create a consumer record associated with the given customer. A consumer
persists as the owner of any reports that are generated, even after the
original customer is deleted from the system.
A consumer must be created for the given customer before calling any of
the Generate Report services.
_Supported regions_: 
operationId: CreateConsumer
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
requestBody:
$ref: '#/components/requestBodies/CreateConsumerRequest'
responses:
'201':
$ref: '#/components/responses/CreateConsumerResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'409':
$ref: '#/components/responses/ConflictErrorResponse'
get:
tags:
- Consumers
summary: Get Consumer For Customer
description: >-
Get the details of a consumer record by customer ID.
_Supported regions_: 
operationId: GetConsumerForCustomer
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
responses:
'200':
$ref: '#/components/responses/GetConsumerForCustomerResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v1/consumers/{consumerId}':
get:
tags:
- Consumers
summary: Get Consumer by ID
description: >-
Get the details of a consumer record by consumer ID.
_Supported regions_: 
operationId: GetConsumer
parameters:
- $ref: '#/components/parameters/ConsumerIdParameter'
responses:
'200':
$ref: '#/components/responses/GetConsumerResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
put:
tags:
- Consumers
summary: Modify Consumer by ID
description: >-
Modify an existing consumer. All fields are required for a consumer
record, but individual fields for this call are optional because fields
that are not specified will be left unchanged.
_Supported regions_: 
operationId: ModifyConsumer
parameters:
- $ref: '#/components/parameters/ConsumerIdParameter'
requestBody:
$ref: '#/components/requestBodies/ModifyConsumerRequest'
responses:
'204':
$ref: '#/components/responses/ModifyConsumerResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/institutionLogins/{institutionLoginId}/accounts':
get:
tags:
- Accounts
summary: Get Customer Accounts by Institution Login ID
description: >-
Get all accounts associated with the given institution login. All
accounts returned are accessible by a single set of credentials on a
single institution.
_Supported regions_: 
operationId: GetCustomerAccountsByInstitutionLogin
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/InstitutionLoginIdParameter'
responses:
'200':
$ref: '#/components/responses/GetCustomerAccountsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
post:
tags:
- Accounts
summary: Refresh Customer Accounts by Institution Login ID
description: >-
Refresh account and transaction data for all accounts associated with a
given `institutionLoginId` with a connection to the institution.
Client apps are not permitted to automate calls to the Refresh services.
Active accounts are automatically refreshed by Finicity once per day.
Because many financial institutions only post transactions once per day,
calling Refresh repeatedly is usually a waste of resources and is not
recommended.
Apps may call Refresh services for a specific customer when there is a
specific business case for the need of data that is up to date as of the
moment. Please discuss with your account manager and systems engineer
for further clarification.
The recommended timeout setting for this request is 120 seconds in order
to receive a response. However, you can terminate the connection after
making the call the operation will still complete. You will have to pull
the account records to check for an updated aggregation attempt date to
know when the refresh is complete.
_Supported regions_: 
operationId: RefreshCustomerAccountsByInstitutionLogin
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/InstitutionLoginIdParameter'
requestBody:
$ref: '#/components/requestBodies/RefreshCustomerAccountsRequest'
responses:
'200':
$ref: '#/components/responses/RefreshCustomerAccountsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/institutionLogins/{institutionLoginId}':
delete:
tags:
- Accounts
summary: Delete Customer Accounts by Institution Login ID
description: >-
Remove from Finicity aggregation the set of accounts matching the
institution login ID.
_Supported regions_: 
operationId: DeleteCustomerAccountsByInstitutionLogin
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/InstitutionLoginIdParameter'
responses:
'204':
$ref: '#/components/responses/DeleteCustomerAccountsByInstitutionLoginResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v2/customers/{customerId}/accounts/{accountId}':
get:
tags:
- Accounts
summary: Get Customer Account by ID
description: >-
Get a customer account by ID.
_Supported regions_: 
operationId: GetCustomerAccount
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/AccountIdParameter'
responses:
'200':
$ref: '#/components/responses/GetCustomerAccountResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/accounts/{accountId}':
delete:
tags:
- Accounts
summary: Delete Customer Account by ID
description: >-
Remove the given account from Finicity aggregation.
_Supported regions_: 
operationId: DeleteCustomerAccount
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/AccountIdParameter'
responses:
'204':
$ref: '#/components/responses/DeleteCustomerAccountResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/accounts':
get:
tags:
- Accounts
summary: Get Customer Accounts
description: >-
Get all accounts owned by the given customer.
_Supported regions_: 
operationId: GetCustomerAccounts
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/AccountStatusParameter'
responses:
'200':
$ref: '#/components/responses/GetCustomerAccountsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
post:
tags:
- Accounts
summary: Refresh Customer Accounts
description: >-
Refresh account and transaction data for all accounts associated with
the given `customerId` with a connection to the institution.
Client apps are not permitted to automate calls to the Refresh services.
Active accounts are automatically refreshed by Finicity once per day.
Because many financial institutions only post transactions once per day,
calling Refresh repeatedly is usually a waste of resources and is not
recommended.
Apps may call Refresh services for a specific customer when there is a
specific business case for the need of data that is up to date as of the
moment. Please discuss with your account manager and systems engineer
for further clarification.
The recommended timeout setting for this request is 120 seconds in order
to receive a response. However, you can terminate the connection after
making the call the operation will still complete. You will have to pull
the account records to check for an updated aggregation attempt date to
know when the refresh is complete.
_Supported regions_: 
operationId: RefreshCustomerAccounts
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
requestBody:
$ref: '#/components/requestBodies/RefreshCustomerAccountsRequest'
responses:
'200':
$ref: '#/components/responses/RefreshCustomerAccountsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/institutions/{institutionId}/accounts':
get:
tags:
- Accounts
summary: Get Customer Accounts by Institution ID
description: >-
Get all active accounts owned by the given customer at the given
institution.
_Supported regions_: 
operationId: GetCustomerAccountsByInstitution
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/InstitutionIdParameter'
responses:
'200':
$ref: '#/components/responses/GetCustomerAccountsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/accounts/{accountId}/transactions/historic':
post:
tags:
- Transactions
summary: Load Historic Transactions for Customer Account
description: >-
Connect to the account's financial institution and load up to 24 months
of historic transactions for the account. Length of history varies by
institution.
This is a premium service. The billable event is a call to this service
specifying a customer ID that has not been seen before by this service.
(If this service is called multiple times with the same customer ID, to
load transactions from multiple accounts, only one billable event has
occurred.)
The recommended timeout setting for this request is 180 seconds in order
to receive a response. However, you can terminate the connection after
making the call the operation will still complete. You will have to pull
the account records to check for an updated aggregation attempt date to
know when the refresh is complete.
The date range sent to the institution is calculated from the account's
`createdDate`. This means that calling this service a second time for
the same account normally will not add any new transactions for the
account. For this reason, a second call to this service for a known
account ID will usually return immediately.
In a few specific scenarios, it may be desirable to force a second
connection to the institution for a known account ID. Some examples are:
* The institution's policy has changed, making more transactions
available
* Finicity has now added a longer transaction history support for the
institution
* The first call encountered an error, and the resulting Aggregation
Ticket has now been fixed by the Finicity Support Team
In these cases, the POST request can contain the parameter `force=true`
in the request body to force the second connection.
_Supported regions_: 
operationId: LoadHistoricTransactionsForCustomerAccount
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/AccountIdParameter'
requestBody:
$ref: '#/components/requestBodies/LoadHistoricTransactionsForCustomerAccountRequest'
responses:
'203':
$ref: '#/components/responses/MFAChallengeNeededResponse'
'204':
$ref: '#/components/responses/LoadHistoricTransactionsForCustomerAccountResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/accounts/{accountId}/owner':
get:
tags:
- Payments
summary: Get Account Owner
description: >-
Retrieve the names and addresses of the account owner from a financial
institution.
Note: this is a premium service, billable per every successful API call.
This service retrieves account data from the institution. This usually
returns quickly, but in some scenarios may take a few minutes to
complete. In the event of a timeout condition, retry the call.
_Supported regions_: 
operationId: GetAccountOwner
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/AccountIdParameter'
responses:
'200':
$ref: '#/components/responses/GetAccountOwnerResponse'
'203':
$ref: '#/components/responses/MFAChallengeNeededResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
/aggregation/v1/partners/applications:
post:
tags:
- App Registration
summary: Register App
description: >-
Register a new application to access financial institutions using OAuth
connections.
_Supported regions_: 
operationId: RegisterApp
requestBody:
$ref: '#/components/requestBodies/RegisterAppRequest'
responses:
'201':
$ref: '#/components/responses/RegisterAppResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'/aggregation/v1/partners/applications/{preAppId}':
put:
tags:
- App Registration
summary: Modify App Registration
description: >-
Update a registered application.
_Supported regions_: 
operationId: ModifyAppRegistration
parameters:
- $ref: '#/components/parameters/PreAppIdPathParameter'
requestBody:
$ref: '#/components/requestBodies/ModifyAppRegistrationRequest'
responses:
'200':
$ref: '#/components/responses/ModifyAppRegistrationResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
/aggregation/v2/partners/applications:
get:
tags:
- App Registration
summary: Get App Registration Status
description: >-
Get the status of your application registration(s).
_Supported regions_: 
operationId: GetAppRegistrationStatus
parameters:
- $ref: '#/components/parameters/PreAppIdQueryParameter'
- $ref: '#/components/parameters/ApplicationIdQueryParameter'
- $ref: '#/components/parameters/AppRegistrationStatusParameter'
- $ref: '#/components/parameters/ApplicationNameParameter'
- $ref: '#/components/parameters/SubmittedDateParameter'
- $ref: '#/components/parameters/ModifiedDateParameter'
- $ref: '#/components/parameters/ResultPageParameter'
- $ref: '#/components/parameters/ResultPageSizeParameter'
responses:
'200':
$ref: '#/components/responses/GetAppRegistrationStatusResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/applications/{applicationId}':
put:
tags:
- App Registration
summary: Set Customer App ID
description: >-
If you have multiple applications for a single client, and you want to
register their applications to access financial institutions using OAuth
connections, then use this API to assign applications to an existing
customer.
_Supported regions_: 
operationId: SetCustomerAppID
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ApplicationIdPathParameter'
requestBody:
$ref: '#/components/requestBodies/SetCustomerAppIDRequest'
responses:
'200':
$ref: '#/components/responses/SetCustomerAppIDResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v2/customers/{customerId}/institutionLogins/{institutionLoginId}/migration':
put:
tags:
- App Registration
summary: Migrate Institution Login Accounts
description: >-
The `institutionLoginId` parameter uses Finicity's internal FI mapping
to move accounts from the current FI legacy connection to the new OAuth
FI connection.
This API returns a list of accounts for the given institution login ID.
_Supported regions_: 
operationId: MigrateInstitutionLoginAccounts
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/InstitutionLoginIdParameter'
requestBody:
$ref: '#/components/requestBodies/MigrateInstitutionLoginAccountsRequest'
responses:
'200':
$ref: '#/components/responses/MigrateInstitutionLoginAccountsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
/institution/v2/certifiedInstitutions/rssd:
get:
tags:
- Institutions
summary: Get Certified Institutions With RSSD
description: >-
Search for certified financial institutions w/RSSD.
_Supported regions_: 
operationId: GetCertifiedInstitutionsWithRSSD
parameters:
- $ref: '#/components/parameters/InstitutionSearchParameter'
- $ref: '#/components/parameters/StartParameter'
- $ref: '#/components/parameters/LimitParameter'
- $ref: '#/components/parameters/ProductTypeParameter'
responses:
'200':
$ref: '#/components/responses/GetCertifiedInstitutionsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
/institution/v2/institutions:
get:
tags:
- Institutions
summary: Get Institutions
description: >-
Search for financial institutions.
_Supported regions_: 
operationId: GetInstitutions
parameters:
- $ref: '#/components/parameters/InstitutionSearchParameter'
- $ref: '#/components/parameters/StartParameter'
- $ref: '#/components/parameters/LimitParameter'
- $ref: '#/components/parameters/ProductTypeParameter'
responses:
'200':
$ref: '#/components/responses/GetInstitutionsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
/institution/v2/certifiedInstitutions:
get:
tags:
- Institutions
summary: Get Certified Institutions
description: >-
Search for financial institutions by certified product.
_Supported regions_: 
operationId: GetCertifiedInstitutions
parameters:
- $ref: '#/components/parameters/InstitutionSearchParameter'
- $ref: '#/components/parameters/StartParameter'
- $ref: '#/components/parameters/LimitParameter'
- $ref: '#/components/parameters/ProductTypeParameter'
responses:
'200':
$ref: '#/components/responses/GetCertifiedInstitutionsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'/institution/v2/institutions/{institutionId}':
get:
tags:
- Institutions
summary: Get Institution by ID
description: >-
Get financial institution details by ID.
_Supported regions_: 
operationId: GetInstitution
parameters:
- $ref: '#/components/parameters/InstitutionIdParameter'
responses:
'200':
$ref: '#/components/responses/GetInstitutionResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/institution/v2/institutions/{institutionId}/branding':
get:
tags:
- Institutions
summary: Get Institution Branding by ID
description: >-
Return the branding information for a financial institution.
_Supported regions_: 
operationId: GetInstitutionBranding
parameters:
- $ref: '#/components/parameters/InstitutionIdParameter'
responses:
'200':
$ref: '#/components/responses/GetInstitutionBrandingResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/voa':
post:
tags:
- Verify Assets
summary: Generate VOA Report
description: >-
Generate a Verification of Assets (VOA) report for all checking,
savings, money market, and investment accounts for the given customer.
This service retrieves up to twelve months of transaction history for
each account and uses this information to generate the VOA report.
This is a premium service. The billing rate is the variable rate for
Verification of Assets under the current subscription plan. The billable
event is the successful generation of a VOA report.
Before calling this API, a consumer must be created for the given
customer ID (see Consumers APIs).
If no account of type checking, savings, money market, or investment is
found, the service will return HTTP 400 Bad Request.
_Supported regions_: 
operationId: GenerateVOAReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GenerateVOAReportRequest'
responses:
'202':
$ref: '#/components/responses/GenerateVOAReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/voaHistory':
post:
tags:
- Verify Assets
summary: Generate VOA With Income Report
description: >-
Generate a Verification of Assets with Income (VOAI) report for all
checking, savings, money market, and investment accounts for the given
customer. This service retrieves up to 24 months of transaction history
for each account and uses this information to generate the VOAI report.
The report includes 1 - 6 months of all debit and credit transactions
for asset verification. By default, the history is set to 61 days,
however, you can change the transaction history in this section by
setting the `fromDate` parameter. The report also includes up to 24
months of income credit transactions (ordered by account and confidence
level) regardless of `fromDate` for income verification.
This is a premium service. The billable event is the successful
generation of a VOAI report.
Before calling this API, a consumer must be created for the given
customer ID (see Consumers APIs).
If no account of type checking, savings, money market, or investment is
found, the service will return HTTP 400 Bad Request.
_Supported regions_: 
operationId: GenerateVOAWithIncomeReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GenerateVOAWithIncomeReportRequest'
responses:
'202':
$ref: '#/components/responses/GenerateVOAWithIncomeReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/preQualVoa':
post:
tags:
- Verify Assets
summary: Generate Prequalification (CRA) Report
description: >-
Retrieve all checking, savings, money market, and investment accounts
for a consumer. The account, owner information, and the number of
insufficient funds (NSFs) for checking accounts are also provided.
If no account of type checking, savings, money market, or investment is
found, the service will return HTTP 400 Bad Request.
_Supported regions_: 
operationId: GeneratePrequalificationCRAReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GeneratePrequalificationReportRequest'
responses:
'202':
$ref: '#/components/responses/GeneratePrequalificationCRAReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/assetSummary':
post:
tags:
- Verify Assets
summary: Generate Prequalification (Non-CRA) Report
description: >-
Retrieve all checking, savings, money market, and investment accounts
for a customer. The account, owner information, and the number of
insufficient funds (NSFs) for checking accounts are also provided.
If no account type of checking, savings, money market, or investment is
found, the service will return HTTP 400 Bad Request.
_Supported regions_: 
operationId: GeneratePrequalificationNonCRAReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GeneratePrequalificationReportRequest'
responses:
'202':
$ref: '#/components/responses/GeneratePrequalificationNonCRAReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/voi':
post:
tags:
- Verify Income and Employment
summary: Generate VOI Report
description: >-
Generate a Verification of Income (VOI) report for all checking,
savings, and money market accounts for the given customer. This service
retrieves up to two years of transaction history for each account and
uses this information to generate the VOI report.
This is a premium service. The billing rate is the variable rate for
Verification of Income under the current subscription plan. The billable
event is the successful generation of a VOI report.
If no account of type checking, savings, or money market is found, the
service will return HTTP 400 Bad Request.
_Supported regions_: 
operationId: GenerateVOIReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GenerateVOIReportRequest'
responses:
'202':
$ref: '#/components/responses/GenerateVOIReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/voePayroll':
post:
tags:
- Verify Income and Employment
summary: Generate VOE - Payroll Report
description: >-
Premium Service: A billable event when the API response is successful.
MVS Implementation Options: Direct API Integration.
Used as a complementary report to the VOIE-Payroll report. This report
is used to fulfill the pre-close VOE requirements. It retrieves the
customer's employment details and employment status through the payroll
source without any income information.
To generate this report, pass the values from the customer SSN, DOB, and
the report ID from the first VOIE-Payroll report generated after the
Connect session.
_Supported regions_: 
operationId: GenerateVOEPayrollReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GeneratePayrollReportRequest'
responses:
'202':
$ref: '#/components/responses/GenerateVOEPayrollReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/voeTransactions':
post:
tags:
- Verify Income and Employment
summary: Generate VOE - Transactions Report
description: >-
Premium Service: A billable event when the API response is successful.
MVS-Direct integration developers only.
Used as a complimentary report to the VOA with Income and VOIE - Paystub
(with TXVerify) reports and used to fulfill the pre-close VOE
requirements.
Retrieve the latest credit transaction information from the borrower's
connected bank accounts and groups them into income streams so that you
can view their payment history to ensure a direct deport was made within
the expected cadence. The report displays transaction descriptions
without any dollar amounts so that income re-verification isn't
necessary.
_Supported regions_: 
operationId: GenerateVOETransactionsReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GenerateVOETransactionsReportRequest'
responses:
'202':
$ref: '#/components/responses/GenerateVOETransactionsReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/payStatement':
post:
tags:
- Verify Income and Employment
summary: Generate Pay Statement Report
description: >-
Generate Pay Statement Extraction Report for the given customer. This
service accepts asset IDs of the stored pay statements to generate a Pay
Statement Extraction Report.
This is a premium service. The billing rate is the variable rate for Pay
Statement Extraction Report under the current subscription plan. The
billable event is the successful generation of a Pay Statement
Extraction Report.
_Supported regions_: 
operationId: GeneratePayStatementReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GeneratePayStatementReportRequest'
responses:
'202':
$ref: '#/components/responses/GeneratePayStatementReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/voieTxVerify/withInterview':
post:
tags:
- Verify Income and Employment
summary: Generate VOIE - Paystub (with TXVerify) Report
description: >-
Generate a VOIE - Paystub (with TXVerify) report for all checking and
savings under the given customer. This service retrieves up to two years
of transaction history for the given accounts. It then uses this
information as well as the provided paystub(s), which are passed into
the request body as asset IDs (generated using the Store Customer Pay
Statement API) to generate the VOIE - Paystub (with TXVerify) report.
Note: if you are using this API to refresh the bank transactions, use
the same asset ID from the first report. A new paystub is not required
unless the paystub is too old for underwriting requirements. Using the
same asset ID that was on the original report and the previously
extracted details will be used to speed up report generation response
time.
This is a premium service. The billing rate is the variable rate for
VOIE TXVerify under the current subscription plan. The billable event is
the successful generation of a VOIE TXVerify Report.
_Supported regions_: 
operationId: GenerateVOIEPaystubWithTXVerifyReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GenerateVOIEPaystubWithTXVerifyReportRequest'
responses:
'202':
$ref: '#/components/responses/GenerateVOIEPaystubWithTXVerifyReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/voieTxVerify/withStatement':
post:
tags:
- Verify Income and Employment
summary: Generate VOIE - Paystub Report
description: >-
Generate a VOIE - Paystub report. This service uses the provided
paystub(s), which are passed into the request body as asset IDs
(generated using the Store Customer Pay Statement API) to generate the
VOIE - Paystub report with digitized paystub details.
This is a premium service. The billing rate is the variable rate for
VOIE - Paystub under the current subscription plan. The billable event
is the successful generation of a VOIE - Paystub Report.
_Supported regions_: 
operationId: GenerateVOIEPaystubReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GenerateVOIEPaystubReportRequest'
responses:
'202':
$ref: '#/components/responses/GenerateVOIEPaystubReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/voiePayroll':
post:
tags:
- Verify Income and Employment
summary: Refresh VOIE - Payroll Report
description: >-
The VOIE β Payroll report generates when the customer completes Connect.
Lenders, who commonly use this report for pre-close verification
employment check, can refresh this report by passing the consumer's SSN,
DOB, and the report ID from the first VOIE β Payroll report they
received.
We'll refresh this report and update any new pay histories since the
first report generated, including borrower's employment status as active
or not.
Note: lenders can only refresh this report one time in a 60-day period
starting from the date of the first report. Any further report refreshes
will incur additional charges.
_Supported regions_: 
operationId: RefreshVOIEPayrollReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GeneratePayrollReportRequest'
responses:
'202':
$ref: '#/components/responses/RefreshVOIEPayrollReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/accounts/{accountId}/statement':
get:
tags:
- Bank Statements
summary: Get Customer Account Statement
description: >-
Retrieve the customer's bank statements in PDF format. Up to 24 months
of history is available depending on the financial institution. Since
this is a premium service, charges incur per each successful statement
retrieved.
For certified financial institutions, statements are available for the
following account types:
* Checking
* Savings
* Money market
* CDs
* Investments
* Mortgage
* Credit cards
* Loans
* Line of credit
* Student Loans
Note: setting the timeout to 180 seconds is recommended to allow enough
time for a response.
_Supported regions_: 
operationId: GetCustomerAccountStatement
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/AccountIdParameter'
- $ref: '#/components/parameters/StatementIndexParameter'
responses:
'200':
$ref: '#/components/responses/GetCustomerAccountStatementResponse'
'203':
$ref: '#/components/responses/MFAChallengeNeededResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/statement':
post:
tags:
- Bank Statements
summary: Generate Statement Report
description: >-
Generate a Statement Report report for the given accounts under the
given customer.
This is a premium service. A billable event will be created upon the
successful generation of the Statement Report.
Before calling this API, a consumer must be created for the given
customer ID (see Consumers APIs).
_Supported regions_: 
operationId: GenerateStatementReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GenerateStatementReportRequest'
responses:
'202':
$ref: '#/components/responses/GenerateStatementReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v3/customers/{customerId}/transactions':
get:
tags:
- Transactions
summary: Get All Customer Transactions
description: >-
Get all transactions available for this customer within the given date
range, across all accounts. This service supports paging and sorting by
`transactionDate` (or `postedDate` if no transaction date is provided),
with a maximum of 1000 transactions per request.
Standard consumer aggregation provides up to 180 days of transactions
prior to the date each account was added to the Finicity system. To
access older transactions, you must first call the service Load Historic
Transactions for Account.
There is no limit for the size of the window between `fromDate` and
`toDate`, however, the maximum number of transactions returned on one
page is 1000.
_Supported regions_: 
operationId: GetAllCustomerTransactions
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/RequiredFromDateParameter'
- $ref: '#/components/parameters/RequiredToDateParameter'
- $ref: '#/components/parameters/StartParameter'
- $ref: '#/components/parameters/LimitParameter'
- $ref: '#/components/parameters/SortParameter'
- $ref: '#/components/parameters/IncludePendingParameter'
responses:
'200':
$ref: '#/components/responses/GetCustomerTransactionsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v2/customers/{customerId}/transactions/{transactionId}':
get:
tags:
- Transactions
summary: Get Customer Transaction by ID
description: >-
Get details for the given transaction.
_Supported regions_: 
operationId: GetCustomerTransaction
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/TransactionIdParameter'
responses:
'200':
$ref: '#/components/responses/GetCustomerTransactionResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v4/customers/{customerId}/accounts/{accountId}/transactions':
get:
tags:
- Transactions
summary: Get Customer Account Transactions
description: >-
Get all transactions available for this customer account within the
given date range. This service supports paging and sorting by
`transactionDate` (or `postedDate` if no transaction date is provided),
with a maximum of 1000 transactions per request.
Standard consumer aggregation provides up to 180 days of transactions
prior to the date each account was added to the Finicity system. To
access older transactions, you must first call the Cash Flow
Verification service Load Historic Transactions for Account.
There is no limit for the size of the window between `fromDate` and
`toDate`, however, the maximum number of transactions returned on one
page is 1000.
_Supported regions_: 
operationId: GetCustomerAccountTransactions
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/AccountIdParameter'
- $ref: '#/components/parameters/RequiredFromDateParameter'
- $ref: '#/components/parameters/RequiredToDateParameter'
- $ref: '#/components/parameters/StartParameter'
- $ref: '#/components/parameters/LimitParameter'
- $ref: '#/components/parameters/SortParameter'
- $ref: '#/components/parameters/IncludePendingParameter'
responses:
'200':
$ref: '#/components/responses/GetCustomerTransactionsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/transactions':
post:
tags:
- Transactions
summary: Generate Transactions Report
description: >-
Generate a Transaction Report for the given accounts under the given
customer. This service retrieves up to 24 months of transaction history
for the given customer. It then uses this information to generate the
Transaction Report.
This is a premium service. A billable event will be created upon the
successful generation of the Transactions Report.
Before calling this API, a consumer must be created for the given
customer ID (see Consumers APIs).
There cannot be more than 24 months between `fromDate` and `toDate`.
_Supported regions_: 
operationId: GenerateTransactionsReport
parameters:
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/RequiredToDateParameter'
- $ref: '#/components/parameters/IncludePendingParameter'
requestBody:
$ref: '#/components/requestBodies/GenerateTransactionsReportRequest'
responses:
'202':
$ref: '#/components/responses/GenerateTransactionsReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/payStatements':
post:
tags:
- Pay Statements
summary: Store Customer Pay Statement
description: >-
Upload pay statements for a customer.
_Supported regions_: 
operationId: StoreCustomerPayStatement
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
requestBody:
$ref: '#/components/requestBodies/StoreCustomerPayStatementRequest'
responses:
'200':
$ref: '#/components/responses/StoreCustomerPayStatementResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v2/customers/{customerId}/accounts/{accountId}/loanDetails':
get:
tags:
- Payments
summary: Get Loan Payment Details
description: >-
Return the loan payment details of the customer for a loan-type account.
Note: this is a premium service, billable per every successful API call.
_Supported regions_: 
operationId: GetLoanPaymentDetails
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/AccountIdParameter'
responses:
'200':
$ref: '#/components/responses/GetLoanPaymentDetailsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v1/customers/{customerId}/portfolios/{portfolioId}':
get:
tags:
- Portfolios
summary: Get Portfolio by Customer
description: >
Return a portfolio of most recently generated reports for each report
type for the given customer. If there are multiple reports that were
generated for a report type (VOA, VOI, etc.), only the most recently
generated report for the type will be returned.
_Supported regions_: 
operationId: GetPortfolioByCustomer
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/PortfolioIdParameter'
responses:
'200':
$ref: '#/components/responses/GetPortfolioByCustomerResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/accounts/{accountId}/txpush':
post:
tags:
- TxPush
summary: Subscribe to TxPush Notifications
description: >-
Register a client app's TxPush Listener to receive TxPush notifications
related to the given account.
Each call to this service will return two records, one with class
account and one with class transaction. Account events are sent when
values change in the account's fields (such as `balance` or
`interestRate`). Transaction events are sent whenever a new transaction
is posted for the account. For institutions that do not provide TxPush
services, notifications are sent as soon as Finicity finds a new
transaction or new account data through regular aggregation processes.
The listener's URL must be secure (HTTPS) for any real-world account. In
addition, the client's TxPush Listener will need to be verified. HTTP
and HTTPS connections are only allowed on the standard ports 80 (HTTP)
and 443 (HTTPS). The use of other ports will result with the call
failing.
For additional details on this process, see [TxPush Listener
Service](https://docs.finicity.com/txpush-listener-service/).
_Supported regions_: 
operationId: SubscribeToTxPushNotifications
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
# ID of the account whose events will be sent to the TxPush Listener
- $ref: '#/components/parameters/AccountIdParameter'
requestBody:
$ref: '#/components/requestBodies/SubscribeToTxPushNotificationsRequest'
responses:
'201':
$ref: '#/components/responses/SubscribeToTxPushNotificationsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
delete:
tags:
- TxPush
summary: Disable TxPush Notifications
description: >-
Delete all TxPush subscriptions with their notifications for the given
account. No more notifications will be sent for account or transaction
events.
For additional details on this process, see [TxPush Listener
Service](https://docs.finicity.com/txpush-listener-service/).
_Supported regions_: 
operationId: DisableTxPushNotifications
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
# ID of the account whose events won't be sent to the TxPush Listener
- $ref: '#/components/parameters/AccountIdParameter'
responses:
'204':
$ref: '#/components/responses/DisableTxPushNotificationsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/accounts/{accountId}/transactions':
post:
tags:
- TxPush
summary: Create TxPush Test Transaction
description: >-
Inject a transaction into the transaction list for a testing account.
This allows an app to trigger TxPush notifications for the account in
order to test the app's TxPush Listener service. This causes the
platform to send one transaction event and one account event (showing
that the account balance has changed). This service is only supported
for testing accounts.
For additional details on this process, see [TxPush Listener
Service](https://docs.finicity.com/txpush-listener-service/).
_Supported regions_: 
operationId: CreateTxPushTestTransaction
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
# ID of the account whose events will be sent to the TxPush Listener
- $ref: '#/components/parameters/AccountIdParameter'
requestBody:
$ref: '#/components/requestBodies/CreateTxPushTestTransactionRequest'
responses:
'201':
$ref: '#/components/responses/CreateTxPushTestTransactionResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/subscriptions/{subscriptionId}':
delete:
tags:
- TxPush
summary: Delete TxPush Subscription
description: >-
Delete a specific subscription to TxPush notifications for the given
account. This could be individual deleting the account or transactions
events. No more events will be sent for that specific subscription.
For additional details on this process, see [TxPush Listener
Service](https://docs.finicity.com/txpush-listener-service/).
_Supported regions_: 
operationId: DeleteTxPushSubscription
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/SubscriptionIdParameter'
responses:
'204':
$ref: '#/components/responses/DeleteTxPushSubscriptionResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v1/consumers/{consumerId}/portfolios/{portfolioId}':
get:
tags:
- Portfolios
summary: Get Portfolio by Consumer
description: >-
Return a portfolio of most recently generated reports for each report
type for a given consumer. If there are multiple reports that were
generated for a report type (VOA, VOI, etc.), only the most recently
generated report for the type will be returned.
_Supported regions_: 
operationId: GetPortfolioByConsumer
parameters:
- $ref: '#/components/parameters/ConsumerIdParameter'
- $ref: '#/components/parameters/PortfolioIdParameter'
responses:
'200':
$ref: '#/components/responses/GetPortfolioByConsumerResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/accounts/{accountId}/details':
get:
tags:
- Payments
summary: Get Account ACH Details
description: >-
Return the real account number and routing number details for an ACH
payment.
Note: this is a premium service, billable per every successful API call.
_Supported account types_: "checking", "savings", "moneyMarket", "loan"
_Supported regions_: 
operationId: GetAccountACHDetails
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/AccountIdParameter'
responses:
'200':
$ref: '#/components/responses/GetAccountACHDetailsResponse'
'400':
$ref: '#/components/responses/GetAccountACHDetailsBadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v3/customers/{customerId}/reports/{reportId}':
get:
tags:
- Reports
summary: Get Report by Customer and ID
description: >-
Get a report that has been generated by a previous call to one of the
Generate Report services.
The report's `status` field contains "inProgress", "failure", or
"success". If the status shows "inProgress", the client app should wait
20 seconds and then call this API again.
_Supported regions_: 
operationId: GetReportByCustomer
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportIdParameter'
- $ref: '#/components/parameters/OnBehalfOfParameter'
- $ref: '#/components/parameters/PurposeParameter'
responses:
'200':
$ref: '#/components/responses/GetReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v3/consumers/{consumerId}/reports/{reportId}':
get:
tags:
- Reports
summary: Get Report by Consumer and ID
description: >-
Get a report that has been generated by a previous call to one of the
Generate Report services.
The report's `status` field contains "inProgress", "failure", or
"success". If the status shows "inProgress", the client app should wait
20 seconds and then call this API again.
_Supported regions_: 
operationId: GetReportByConsumer
parameters:
- $ref: '#/components/parameters/PurposeParameter'
- $ref: '#/components/parameters/ConsumerIdParameter'
- $ref: '#/components/parameters/ReportIdParameter'
- $ref: '#/components/parameters/OnBehalfOfParameter'
responses:
'200':
$ref: '#/components/responses/GetReportResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v1/customers/{customerId}/reports':
get:
tags:
- Reports
summary: Get Reports by Customer ID
description: >-
Get all reports that have been generated by previous calls to Generate
Report services for the given customer.
The `status` fields in the returned list contain "inProgress",
"failure", or "success". If the status shows "inProgress", the client
app should wait 20 seconds and then call this API again.
_Supported regions_: 
operationId: GetReportsByCustomerId
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/PurposeParameter'
responses:
'200':
$ref: '#/components/responses/GetReportsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'429':
$ref: '#/components/responses/TooManyRequestsErrorResponse'
'/decisioning/v1/consumers/{consumerId}/reports':
get:
tags:
- Reports
summary: Get Reports by Consumer ID
description: >-
Get all reports that have been generated by previous calls to Generate
Report services for the given consumer.
The `status` fields in the returned list contain "inProgress",
"failure", or "success". If the status shows "inProgress", the client
app should wait 20 seconds and then call this API again.
_Supported regions_: 
operationId: GetReportsByConsumerId
parameters:
- $ref: '#/components/parameters/PurposeParameter'
- $ref: '#/components/parameters/ConsumerIdParameter'
responses:
'200':
$ref: '#/components/responses/GetReportsResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'429':
$ref: '#/components/responses/TooManyRequestsErrorResponse'
'/aggregation/v1/customers/{customerId}/assets/{assetId}':
get:
tags:
- Assets
summary: Get Asset by Customer and ID
description: >-
Retrieve a binary file for the given asset ID.
_Supported regions_: 
operationId: GetAssetByCustomerID
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/AssetIdParameter'
responses:
'200':
$ref: '#/components/responses/GetAssetByCustomerIDResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/accounts/{accountId}/availableBalance/live':
get:
tags:
- Payments
summary: Get Available Balance - Live
description: >-
Retrieve the available and cleared account balances for a single account
in real-time directly from a financial institution.
Note: this is a premium service, billable per every successful API call.
_Supported account types_: "checking", "savings", "moneyMarket", "cd"
_Supported regions_: 
operationId: GetAvailableBalanceLive
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/AccountIdParameter'
responses:
'200':
$ref: '#/components/responses/GetAvailableBalanceLiveResponse'
'400':
$ref: '#/components/responses/GetAvailableBalanceLiveBadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/aggregation/v1/customers/{customerId}/accounts/{accountId}/availableBalance':
get:
tags:
- Payments
summary: Get Available Balance
description: >-
Retrieve the latest cached available and cleared account balances for a
customer. Since we update and store balances throughout the day, this is
the most accurate balance information available when a connection to a
financial institution is unavailable or when a faster response is
needed. Only deposit account types are supported: Checking, Savings,
Money Market, and CD.
Note: this is a premium service, billable per every successful API call.
Enrollment is required.
_Supported account types_: "checking", "savings", "moneyMarket", "cd"
_Supported regions_: 
operationId: GetAvailableBalance
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/AccountIdParameter'
responses:
'200':
$ref: '#/components/responses/GetAvailableBalanceResponse'
'400':
$ref: '#/components/responses/GetAvailableBalanceBadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/cashFlowBusiness':
post:
tags:
- Cash Flow
summary: Generate Cash Flow Report - Business
description: >-
Generate a Cash Flow Report (Business) report for all checking and
savings under the given customer. This service retrieves up to two years
of transaction history for the given account. It then uses this
information to generate the CFR report. A consumer is not required to
generate this report.
This report is not provided under FCRA rules, and this report is not
available in the Finicity Consumer Portal for the borrower to view.
If no account type of checking or savings is found, the service will
return HTTP 400 Bad Request.
_Supported regions_: 
operationId: GenerateCashFlowBusinessReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GenerateCashFlowReportRequest'
responses:
'202':
$ref: '#/components/responses/GenerateCashFlowReportBusinessResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/decisioning/v2/customers/{customerId}/cashFlowPersonal':
post:
tags:
- Cash Flow
summary: Generate Cash Flow Report - Personal
description: >-
Generate a Cash Flow Report (Personal) report for all checking and
savings under the given customer. This service retrieves up to two years
of transaction history for the given account. It then uses this
information to generate the CFR report.
This report is provided under FCRA rules, with Finicity acting as the
CRA (Consumer Reporting Agency). If an individual account is included in
the report - for example, with an individual acting as an personal
guarantor on the loan - then this version of the report should be used.
In case of an adverse action on the loan where the decision was based on
this report, then the borrower can be referred to the [Finicity Consumer
Portal](https://consumer.finicityreports.com) where they can view this
report and submit a dispute if they feel any information in this report
is inaccurate.
Before calling this API, a consumer must be created for the given
customer ID (see Consumers APIs).
If no account type of checking or savings is found, the service will
return HTTP 400 Bad Request.
_Supported regions_: 
operationId: GenerateCashFlowPersonalReport
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/ReportCallbackUrlParameter'
requestBody:
$ref: '#/components/requestBodies/GenerateCashFlowReportRequest'
responses:
'202':
$ref: '#/components/responses/GenerateCashFlowReportPersonalResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/analytics/ca360/v1/customers/{customerId}/analytics':
post:
tags:
- Analytics and Attributes
summary: Generate Consumer Attributes
description: >-
Generate a Consumer Attributes report for the given customer. The "to"
and "from" date range is the last 12 months of consumer data, based on
the date at which the report was generated.
An analytic ID is created and associated with the customer's ID. If you
generate multiple Consumer Attributes reports for the same customer,
then each report will have its own analytic ID.
_Supported regions_: 
operationId: GenerateConsumerAttributes
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
requestBody:
$ref: '#/components/requestBodies/GenerateConsumerAttributesRequest'
responses:
'200':
$ref: '#/components/responses/GenerateConsumerAttributesReponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
get:
tags:
- Analytics and Attributes
summary: List Consumer Attributes
description: >-
Retrieve a list of all analytic IDs previously created for a customer
using the Generate Consumer Attributes APIs.
_Supported regions_: 
operationId: ListConsumerAttributes
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
responses:
'200':
$ref: '#/components/responses/ListConsumerAttributesResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
/analytics/ca360/v1/customers/{customerId}/analytics/fcra:
post:
tags:
- Analytics and Attributes
summary: Generate FCRA Consumer Attributes
description: >-
_Supported regions_: 
operationId: GenerateFCRAConsumerAttributes
parameters:
- $ref: '#/components/parameters/CustomerIdParameter'
requestBody:
$ref: '#/components/requestBodies/GenerateConsumerAttributesRequest'
responses:
'200':
$ref: '#/components/responses/GenerateConsumerAttributesReponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/analytics/ca360/v1/customers/{customerId}/analytics/{analyticsId}':
get:
tags:
- Analytics and Attributes
summary: Get Consumer Attributes By ID
description: >-
Retrieve a Consumer Attributes report for a customer.
Use the analytic and customer IDs to retrieve 12 months of data
attributes according to the "to" and "from" date range of the report at
the time it was created.
If the current date is before the end of the calendar month, then the
most recent month provides all available data up to the current date.
_Supported regions_: 
operationId: GetConsumerAttributesByID
parameters:
- $ref: '#/components/parameters/AnalyticIdParameter'
- $ref: '#/components/parameters/CustomerIdParameter'
responses:
'200':
$ref: '#/components/responses/GetConsumerAttributesByIDResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
'/analytics/ca360/v1/customers/{customerId}/analytics/{analyticsId}/fcra':
get:
tags:
- Analytics and Attributes
summary: Get FCRA Consumer Attributes By ID
description: >-
Retrieve a FCRA Consumer Attributes report for a customer.
Use the analytic and customer IDs to retrieve 12 months of FCRA data
attributes according to the `To` and `From` date range of the report at
the time it was created.
If the current date is before the end of the calendar month, then the
most recent month provides all available data up to the current date.
_Supported regions_: 
operationId: GetFCRAConsumerAttributesByID
parameters:
- $ref: '#/components/parameters/AnalyticIdParameter'
- $ref: '#/components/parameters/CustomerIdParameter'
- $ref: '#/components/parameters/PurposeParameter'
responses:
'200':
$ref: '#/components/responses/GetConsumerAttributesByIDResponse'
'400':
$ref: '#/components/responses/BadRequestErrorResponse'
'401':
$ref: '#/components/responses/UnauthorizedErrorResponse'
'404':
$ref: '#/components/responses/ResourceNotFoundErrorResponse'
components:
securitySchemes:
FinicityAppKey:
name: Finicity-App-Key
type: apiKey
in: header
description: The "Finicity-App-Key" from the developer dashboard
FinicityAppToken:
name: Finicity-App-Token
type: apiKey
in: header
description: A token returned by the `/authentication` API
requestBodies:
CreateTokenRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PartnerCredentials'
ModifyPartnerSecretRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PartnerCredentialsWithNewSecret'
GenerateConnectUrlRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ConnectParameters'
GenerateLiteConnectUrlRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/LiteConnectParameters'
GenerateFixConnectUrlRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/FixConnectParameters'
SendConnectEmailRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ConnectEmailParameters'
GenerateJointBorrowerConnectUrlRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ConnectJointBorrowerParameters'
SendJointBorrowerConnectEmailRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ConnectJointBorrowerEmailParameters'
AddCustomerRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/NewCustomer'
ModifyCustomerRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CustomerUpdate'
CreateConsumerRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/NewConsumer'
ModifyConsumerRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ConsumerUpdate'
RefreshCustomerAccountsRequest:
description: No payload expected
content:
application/json:
schema: {}
LoadHistoricTransactionsForCustomerAccountRequest:
description: No payload expected
content:
application/json:
schema: {}
RegisterAppRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Application'
ModifyAppRegistrationRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Application'
MigrateInstitutionLoginAccountsRequest:
required: true
description: No payload expected
content:
application/json:
schema: {}
SetCustomerAppIDRequest:
description: No payload expected
content:
application/json:
schema: {}
GeneratePayrollReportRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PayrollReportConstraints'
examples:
GeneratePayrollReportRequestExample:
$ref: '#/components/examples/GeneratePayrollReportRequestExample'
GeneratePayStatementReportRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PayStatementReportConstraints'
examples:
GeneratePayStatementReportRequestExample:
$ref: '#/components/examples/GeneratePayStatementReportRequestExample'
GenerateCashFlowReportRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CashFlowReportConstraints'
examples:
GenerateCashFlowReportRequestExample:
$ref: '#/components/examples/GenerateCashFlowReportRequestExample'
GenerateTransactionsReportRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TransactionsReportConstraints'
examples:
GenerateTransactionsReportRequestExample:
$ref: '#/components/examples/GenerateTransactionsReportRequestExample'
GenerateVOAReportRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/VOAReportConstraints'
examples:
GenerateVOAReportRequestExample:
$ref: '#/components/examples/GenerateVOAReportRequestExample'
GenerateVOAWithIncomeReportRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/VOAWithIncomeReportConstraints'
examples:
GenerateVOAWithIncomeReportRequestExample:
$ref: '#/components/examples/GenerateVOAWithIncomeReportRequestExample'
GeneratePrequalificationReportRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PrequalificationReportConstraints'
examples:
GeneratePrequalificationReportRequestExample:
$ref: '#/components/examples/GeneratePrequalificationReportRequestExample'
GenerateVOIReportRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/VOIReportConstraints'
examples:
GenerateVOIReportRequestExample:
$ref: '#/components/examples/GenerateVOIReportRequestExample'
GenerateVOIEPaystubWithTXVerifyReportRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/VOIEWithTXVerifyReportConstraints'
examples:
GenerateVOIEPaystubWithTXVerifyReportRequestExample:
$ref: '#/components/examples/GenerateVOIEPaystubWithTXVerifyReportRequestExample'
GenerateVOIEPaystubReportRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/VOIEReportConstraints'
examples:
GenerateVOIEPaystubReportRequestExample:
$ref: '#/components/examples/GenerateVOIEPaystubReportRequestExample'
StoreCustomerPayStatementRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PayStatement'
GenerateVOETransactionsReportRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/VOETransactionsReportConstraints'
examples:
GenerateVOETransactionsReportRequestExample:
$ref: '#/components/examples/GenerateVOETransactionsReportRequestExample'
GenerateStatementReportRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/StatementReportConstraints'
examples:
GenerateStatementReportRequestExample:
$ref: '#/components/examples/GenerateStatementReportRequestExample'
CreateTxPushTestTransactionRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TestTxPushTransaction'
SubscribeToTxPushNotificationsRequest:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TxPushSubscriptionParameters'
GenerateConsumerAttributesRequest:
content:
application/json:
schema:
$ref: '#/components/schemas/ConsumerAttributeAccountIDs'
responses:
CreateTokenResponse:
description: The access token was successfully created
content:
application/json:
schema:
$ref: '#/components/schemas/AccessToken'
ModifyPartnerSecretResponse:
description: The Partner Secret was successfully updated
ModifyPartnerSecretBadRequestErrorResponse:
description: The request was rejected
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
InvalidNewPartnerSecretExample:
$ref: '#/components/examples/InvalidNewPartnerSecretExample'
GenericBadRequestExample:
$ref: '#/components/examples/GenericBadRequestExample'
GenerateConnectUrlResponse:
description: The URL link was successfully generated
content:
application/json:
schema:
$ref: '#/components/schemas/ConnectUrl'
SendConnectEmailResponse:
description: The URL link was successfully generated and the email sent
content:
application/json:
schema:
$ref: '#/components/schemas/ConnectEmailUrl'
GenerateJointBorrowerConnectUrlResponse:
description: The URL link was successfully generated
content:
application/json:
schema:
$ref: '#/components/schemas/ConnectUrl'
AddCustomerResponse:
description: The customer was successfully created
content:
application/json:
schema:
$ref: '#/components/schemas/CreatedCustomer'
GetCustomersResponse:
description: Customers were successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/Customers'
GetCustomerResponse:
description: The customer was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/Customer'
GetCustomerWithAppDataResponse:
description: The customer was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/CustomerWithAppData'
ModifyCustomerResponse:
description: The customer was successfully updated
DeleteCustomerResponse:
description: The customer was successfully deleted
CreateConsumerResponse:
description: The consumer was successfully created
content:
application/json:
schema:
$ref: '#/components/schemas/CreatedConsumer'
GetConsumerForCustomerResponse:
description: The consumer was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/Consumer'
GetConsumerResponse:
description: The consumer was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/Consumer'
ModifyConsumerResponse:
description: The consumer was successfully updated
GetCustomerAccountsResponse:
description: The account list was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/CustomerAccounts'
RefreshCustomerAccountsResponse:
description: The account list was successfully refreshed
content:
application/json:
schema:
$ref: '#/components/schemas/CustomerAccounts'
DeleteCustomerAccountsByInstitutionLoginResponse:
description: The customer accounts were successfully deleted
DeleteCustomerAccountResponse:
description: The customer account was successfully deleted
LoadHistoricTransactionsForCustomerAccountResponse:
description:
Historic transactions have been loaded successfully. The transactions
are now available by calling the Get Customer Account Transactions API.
GetCustomerAccountResponse:
description: The account was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/CustomerAccount'
GetAccountOwnerResponse:
description: The account owner was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/AccountOwner'
MFAChallengeNeededResponse:
description:
The response contains an MFA challenge in XML or JSON format. Contact
your Account Manager or Systems Engineers to determine the best route to
handle this error.
RegisterAppResponse:
description: The app registration was successfully created
content:
application/json:
schema:
$ref: '#/components/schemas/RegisteredApplication'
SetCustomerAppIDResponse:
description: The app was successfully assigned
ModifyAppRegistrationResponse:
description: The app registration was updated
content:
application/json:
schema:
$ref: '#/components/schemas/RegisteredApplication'
GetAppRegistrationStatusResponse:
description: The app registration statuses were returned
content:
application/json:
schema:
$ref: '#/components/schemas/AppStatuses'
MigrateInstitutionLoginAccountsResponse:
description: The migration succeeded
content:
application/json:
schema:
$ref: '#/components/schemas/CustomerAccounts'
GetCertifiedInstitutionsResponse:
description: Institutions were successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/CertifiedInstitutions'
GetInstitutionResponse:
description: Institution was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/InstitutionWrapper'
GetInstitutionsResponse:
description: Institutions were successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/Institutions'
GetInstitutionBrandingResponse:
description: Institution branding was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/BrandingWrapper'
GenerateVOEPayrollReportResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/PayrollReportAck'
examples:
GenerateVOEPayrollReportResponseExample:
$ref: '#/components/examples/GenerateVOEPayrollReportResponseExample'
RefreshVOIEPayrollReportResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/PayrollReportAck'
examples:
RefreshVOIEPayrollReportResponseExample:
$ref: '#/components/examples/RefreshVOIEPayrollReportResponseExample'
GenerateTransactionsReportResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/TransactionsReportAck'
examples:
GenerateTransactionsReportResponseExample:
$ref: '#/components/examples/GenerateTransactionsReportResponseExample'
GenerateVOAReportResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/VOAReportAck'
examples:
GenerateVOAReportResponseExample:
$ref: '#/components/examples/GenerateVOAReportResponseExample'
GenerateVOAWithIncomeReportResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/VOAWithIncomeReportAck'
examples:
GenerateVOAWithIncomeReportResponseExample:
$ref: '#/components/examples/GenerateVOAWithIncomeReportResponseExample'
GeneratePrequalificationCRAReportResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/PrequalificationReportAck'
examples:
GeneratePrequalificationCRAReportResponseExample:
$ref: '#/components/examples/GeneratePrequalificationCRAReportResponseExample'
GeneratePrequalificationNonCRAReportResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/PrequalificationReportAck'
examples:
GeneratePrequalificationNonCRAReportResponseExample:
$ref: '#/components/examples/GeneratePrequalificationNonCRAReportResponseExample'
GenerateVOIReportResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/VOIReportAck'
examples:
GenerateVOIReportResponseExample:
$ref: '#/components/examples/GenerateVOIReportResponseExample'
GetReportResponse:
description: The report was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/Report'
examples:
CashFlowPersonalReportExample:
$ref: '#/components/examples/CashFlowPersonalReportExample'
CashFlowBusinessReportExample:
$ref: '#/components/examples/CashFlowBusinessReportExample'
PrequalificationCRAReportExample:
$ref: '#/components/examples/PrequalificationCRAReportExample'
PrequalificationNonCRAReportExample:
$ref: '#/components/examples/PrequalificationNonCRAReportExample'
PayStatementReportExample:
$ref: '#/components/examples/PayStatementReportExample'
StatementReportExample:
$ref: '#/components/examples/StatementReportExample'
TransactionsReportExample:
$ref: '#/components/examples/TransactionsReportExample'
VOAReportExample:
$ref: '#/components/examples/VOAReportExample'
VOAWithIncomeReportExample:
$ref: '#/components/examples/VOAWithIncomeReportExample'
VOEPayrollReportExample:
$ref: '#/components/examples/VOEPayrollReportExample'
VOETransactionsReportExample:
$ref: '#/components/examples/VOETransactionsReportExample'
VOIReportExample:
$ref: '#/components/examples/VOIReportExample'
VOIEPayrollReportExample:
$ref: '#/components/examples/VOIEPayrollReportExample'
VOIEPaystubReportExample:
$ref: '#/components/examples/VOIEPaystubReportExample'
VOIEPaystubWithTXVerifyReportExample:
$ref: '#/components/examples/VOIEPaystubWithTXVerifyReportExample'
GetReportsResponse:
description: The reports summaries were successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/ReportSummaries'
GetAssetByCustomerIDResponse:
description: The asset was successfully downloaded
content:
application/octet-stream:
schema:
type: string
format: binary
GetCustomerAccountStatementResponse:
description: The statement was successfully downloaded as a PDF file
content:
application/octet-stream:
schema:
type: string
format: binary
StoreCustomerPayStatementResponse:
description: The pay statement was successfully uploaded
content:
application/json:
schema:
$ref: '#/components/schemas/Asset'
GenerateVOETransactionsReportResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/VOETransactionsReportAck'
examples:
GenerateVOETransactionsReportResponseExample:
$ref: '#/components/examples/GenerateVOETransactionsReportResponseExample'
GeneratePayStatementReportResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/PayStatementReportAck'
examples:
GeneratePayStatementReportResponseExample:
$ref: '#/components/examples/GeneratePayStatementReportResponseExample'
GenerateCashFlowReportBusinessResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/CashFlowReportAck'
examples:
GenerateCashFlowReportBusinessResponseExample:
$ref: '#/components/examples/GenerateCashFlowReportBusinessResponseExample'
GenerateCashFlowReportPersonalResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/CashFlowReportAck'
examples:
GenerateCashFlowReportPersonalResponseExample:
$ref: '#/components/examples/GenerateCashFlowReportPersonalResponseExample'
GenerateVOIEPaystubWithTXVerifyReportResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/VOIEPaystubWithTXVerifyReportAck'
examples:
GenerateVOIEPaystubWithTXVerifyReportResponseExample:
$ref: '#/components/examples/GenerateVOIEPaystubWithTXVerifyReportResponseExample'
GenerateVOIEPaystubReportResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/VOIEPaystubReportAck'
examples:
GenerateVOIEPaystubReportResponseExample:
$ref: '#/components/examples/GenerateVOIEPaystubReportResponseExample'
GenerateStatementReportResponse:
description:
"The report is being generated. When finished, a notification will be
sent to the specified callback URL (Report Listener Service) and the
report can be fetched using Get Report APIs. If you don't use a callback
URL, Get Report returns a minimal report with the following status:
'inProgress'. Repeat the call every 20 seconds until Get Report returns
a different status."
content:
application/json:
schema:
$ref: '#/components/schemas/StatementReportAck'
examples:
GenerateStatementReportResponseExample:
$ref: '#/components/examples/GenerateStatementReportResponseExample'
GetCustomerTransactionsResponse:
description: The transactions were successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/Transactions'
GetCustomerTransactionResponse:
description: The transaction was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/Transaction'
GetAccountACHDetailsResponse:
description: Account ACH details were successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/ACHDetails'
GetAvailableBalanceResponse:
description: The balance was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/AvailableBalance'
GetAvailableBalanceLiveResponse:
description: The live balance was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/AvailableBalance'
GetLoanPaymentDetailsResponse:
description: The loan payment details were successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/LoanPaymentDetails'
GetPortfolioByCustomerResponse:
description: The portfolio was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/PortfolioSummary'
GetPortfolioByConsumerResponse:
description: The portfolio was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/PortfolioWithConsumerSummary'
DeleteTxPushSubscriptionResponse:
description: The subscription was successfully deleted
DisableTxPushNotificationsResponse:
description: Subscriptions were successfully deleted for the given account
SubscribeToTxPushNotificationsResponse:
description: The subscription was successfully created
content:
application/json:
schema:
$ref: '#/components/schemas/TxPushSubscriptions'
CreateTxPushTestTransactionResponse:
description: The test notification was successfully sent
content:
application/json:
schema:
$ref: '#/components/schemas/CreatedTestTxPushTransaction'
GenerateConsumerAttributesReponse:
description: The Consumer Attributes report was successfully generated
content:
application/json:
schema:
$ref: '#/components/schemas/ConsumerAttributesAnalyticId'
GetConsumerAttributesByIDResponse:
description: The Consumer Attributes report was successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/ConsumerAttributes'
ListConsumerAttributesResponse:
description: Attributes IDs were successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/ConsumerAttributeList'
AuthenticationUnauthorizedErrorResponse:
description: >-
The request lacks valid authentication credentials. Check Partner ID,
Partner Secret or Finicity-App-Key.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
MissingFinicityAppKeyExample:
$ref: '#/components/examples/MissingFinicityAppKeyExample'
InvalidCredentialsExample:
$ref: '#/components/examples/InvalidCredentialsExample'
UnauthorizedErrorResponse:
description: >-
The request lacks valid authentication credentials. Check
"Finicity-App-Key" or "Finicity-App-Token".
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
ExpiredTokenExample:
$ref: '#/components/examples/ExpiredTokenExample'
MissingFinicityAppKeyExample:
$ref: '#/components/examples/MissingFinicityAppKeyExample'
BadRequestErrorResponse:
description: The request was rejected
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
MissingFieldExample:
$ref: '#/components/examples/MissingFieldExample'
InvalidFieldExample:
$ref: '#/components/examples/InvalidFieldExample'
InvalidExperienceFieldExample:
$ref: '#/components/examples/InvalidExperienceFieldExample'
GenericBadRequestExample:
$ref: '#/components/examples/GenericBadRequestExample'
AccountTypeNotSupportedExample:
$ref: '#/components/examples/AccountTypeNotSupportedExample'
TooManyRequestsErrorResponse:
description:
The service can't accept more requests or is not available from the
[Test Drive](https://signup.finicity.com/).
ResourceNotFoundErrorResponse:
description: The resource doesn't exist
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
ConsumerNotFoundExample:
$ref: '#/components/examples/ConsumerNotFoundExample'
NoAccountForInstitutionLoginIdExample:
$ref: '#/components/examples/NoAccountForInstitutionLoginIdExample'
CustomerNotFoundExample:
$ref: '#/components/examples/CustomerNotFoundExample'
NoConsumerForCustomerExample:
$ref: '#/components/examples/NoConsumerForCustomerExample'
ResourceNotFoundExample:
$ref: '#/components/examples/ResourceNotFoundExample'
NoRegisteredApplicationExample:
$ref: '#/components/examples/NoRegisteredApplicationExample'
ConflictErrorResponse:
description: The resource already exists
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
ConsumerExistsConflictExample:
$ref: '#/components/examples/ConsumerExistsConflictExample'
GetAccountACHDetailsBadRequestErrorResponse:
description: The request was rejected
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
MissingFieldExample:
$ref: '#/components/examples/MissingFieldExample'
InvalidFieldExample:
$ref: '#/components/examples/InvalidFieldExample'
GenericBadRequestExample:
$ref: '#/components/examples/GenericBadRequestExample'
AccountTypeNotSupportedExample:
$ref: '#/components/examples/AccountTypeNotSupportedExample'
GetAvailableBalanceLiveBadRequestErrorResponse:
description: The request was rejected
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
MissingFieldExample:
$ref: '#/components/examples/MissingFieldExample'
InvalidFieldExample:
$ref: '#/components/examples/InvalidFieldExample'
GenericBadRequestExample:
$ref: '#/components/examples/GenericBadRequestExample'
AccountTypeNotSupportedExample:
$ref: '#/components/examples/AccountTypeNotSupportedExample'
GetAvailableBalanceBadRequestErrorResponse:
description: The request was rejected
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
MissingFieldExample:
$ref: '#/components/examples/MissingFieldExample'
InvalidFieldExample:
$ref: '#/components/examples/InvalidFieldExample'
GenericBadRequestExample:
$ref: '#/components/examples/GenericBadRequestExample'
AccountTypeNotSupportedExample:
$ref: '#/components/examples/AccountTypeNotSupportedExample'
examples:
MissingFinicityAppKeyExample:
value:
code: 10026
message: Missing parameter (Finicity-App-Key)
InvalidCredentialsExample:
value:
code: 10001
message: Invalid credentials
GenericBadRequestExample:
value:
code: 14020
message: Bad request.
AccountTypeNotSupportedExample:
value:
code: 14020
message: 'Bad request. (Account type not supported).'
MissingFieldExample:
value:
code: '10010'
status: '400'
message: '"partnerId" is required'
user_message: >-
One or more of the fields could not be validated. Please ensure you
have entered the correct data.
tags: ''
InvalidFieldExample:
value:
code: '10010'
status: '400'
message: Customer ID does not exist or does not belong to this partner
user_message: >-
One or more of the fields could not be validated. Please ensure you
have entered the correct data.
tags: ''
InvalidExperienceFieldExample:
value:
code: '10010'
status: '400'
message: '"experience" must be a valid GUID'
user_message:
'One or more of the fields could not be validated. Please ensure you
have entered the correct data.'
tags: ''
InvalidNewPartnerSecretExample:
value:
code: 24437
message: New password is not as per policy
ExpiredTokenExample:
value:
code: '10022'
status: '401'
message: Invalid authorization credentials
user_message: The session has expired or is invalid
tags: ''
NoAccountForInstitutionLoginIdExample:
value:
code: '38007'
status: '404'
title: Connecting accounts error
user_message:
Customer does not have any accounts associated with
institutionLoginId.
tags: ''
level: 'error'
message:
'Customer does not have any accounts associated with
institutionLoginId.'
CustomerNotFoundExample:
value:
code: 14001
message: 'Customer not found.'
ConsumerNotFoundExample:
value:
code: 10100
message: 'Cannot find consumer with id 1234.'
NoConsumerForCustomerExample:
value:
code: 10100
message: 'Cannot find consumer for customer with id 5011115315."'
ResourceNotFoundExample:
value:
code: 14001
message: 'Resource not found.'
NoRegisteredApplicationExample:
value:
code: 50051
message: 'No registered partner applications found.'
ConsumerExistsConflictExample:
value:
code: 11000
message: 'A consumer already exists for customer 4025024821'
GeneratePayrollReportRequestExample:
value:
payrollData:
ssn: '999990000'
dob: '315576000'
reportId: abcdefghijkl-voiepayroll
reportCustomFields:
- label: loanID
value: '12345'
shown: true
payStatementsFromDate: 1580558400
GenerateVOEPayrollReportResponseExample:
value:
id: 41h4nzppn47u-voepayroll
portfolioId: 9qud7dtuzbew-3-port
customerType: active
customerId: 1011140000
requestId: 7a7qyps2iy
requesterName: Decisioning API
createdDate: 1579819592
title: Finicity Verification of Employment - Payroll
consumerId: 656cf7083c5c06e0c125a698579f0000
consumerSsn: '6789'
constraints:
payrollData:
payrollDataRetrievalId: hahvhe2k0000
employerNames:
- ACME INC
reportId: abcdefghijkl-voiepayroll
payStatementsFromDate: 1580558400
reportCustomFields:
- label: loanID
value: '12345'
shown: true
type: voePayroll
status: inProgress
RefreshVOIEPayrollReportResponseExample:
value:
id: 123456789012-voiepayroll
customerId: 1011140000
consumerId: 656cf7083c5c06e0c125a698579f0000
consumerSsn: '6789'
requesterName: Decisioning API
requestId: 7a7qyps2iy
type: voiePayroll
status: inProgress
createdDate: 1579819592
constraints:
payrollData:
payrollDataRetrievalId: hahvhe2k0000
employerNames:
- ACME INC
reportId: abcdefghijkl-voiepayroll
payStatementsFromDate: 1580558400
reportCustomFields:
- label: loanID
value: '12345'
shown: true
customerType: active
title: Finicity Verification of Income and Employment - Payroll
portfolioId: 9qud7dtuzbew-2-port
GeneratePayStatementReportRequestExample:
value:
paystatementReport:
assetIds:
- 6f8fb0a0-e882-4f57-b672-cf53f1397581
extractEarnings: true
extractDeductions: false
extractDirectDeposit: true
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
GeneratePayStatementReportResponseExample:
value:
id: y0ejausptjg1-paystatement
portfolioId: spd8aehuw63i-10-port
customerType: active
customerId: 1003413624
requestId: 8wy5htqg8u
requesterName: Decisioning API
createdDate: 1588350269
title: Finicity Pay Statement Extraction Report
consumerId: 4089f408963dd6b90b28a935e9903c0e
consumerSsn: '6789'
constraints:
paystatementReport:
assetIds:
- 6f8fb0a0-e882-4f57-b672-cf53f1397581
extractEarnings: true
extractDeductions: false
extractDirectDeposit: true
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
type: paystatement
status: inProgress
GenerateStatementReportRequestExample:
value:
statementReportData:
accountId: 1000076901
index: 1
reportCustomFields:
- label: loanID
value: '123456'
shown: true
GenerateStatementReportResponseExample:
value:
id: 38dknche83oh-statement
portfolioId: sy7aa68w2ugx-1-port
customerType: active
customerId: 1010560999
requestId: ny7x32stfq
requesterName: Demo
createdDate: 1596226182
title: Finicity Statement Report
consumerId: 555595ec74c8ec57adf44dadddb6a35
consumerSsn: '1234'
constraints:
statementReportData:
accountId: 1000076901
index: 1
reportCustomFields:
- label: loanID
value: '123456'
shown: true
type: statement
status: inProgress
GenerateCashFlowReportRequestExample:
value:
accountIds: '1000535275'
incomeStreamConfidenceMinimum: 50
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
showNsf: false
fromDate: 1580558400
GenerateCashFlowReportBusinessResponseExample:
value:
id: 383z55zudewm-cfrb
customerType: active
customerId: 1275320
requestId: 7a7qyps2iy
requesterName: Decisioning API
createdDate: 1579819592
title: Finicity Cash Flow Report - Business
consumerId: 3f7ff2cf0ffb3d0cd59875e070c9b1d4
consumerSsn: '1234'
constraints:
accountIds:
- '1000535275'
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
type: cfrb
status: inProgress
GenerateCashFlowReportPersonalResponseExample:
value:
id: 383z51zurqwo-cfrp
customerType: active
customerId: 1275320
requestId: 7a7qyps2iy
requesterName: Decisioning API
createdDate: 1579819592
title: Finicity Cash Flow Report - Personal
consumerId: 3f7ff2cf0ffb3d0cd59875e070c9b1d4
consumerSsn: '1234'
constraints:
accountIds:
- '1000535275'
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
type: cfrp
status: inProgress
GenerateTransactionsReportRequestExample:
value:
accountIds: 1027339038 1027339039
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
fromDate: 1580558400
GenerateTransactionsReportResponseExample:
value:
id: dnuru2ua2trs-transactions
portfolioId: hupvwpdzr9dq-16-port
customerType: testing
customerId: 1000018865
requestID: ky2nhsufhv
requesterName: Decisioning API Tests
createdDate: 1594678007
title: Finicity Transactions Report
consumerId: a925b07c9e028c680ad9c1d18d2e7199
consumerSsn: '6789'
constraints:
accountIds:
- '1000075473'
fromDate: 1578952809
toDate: 1594677609
includePending: true
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
type: transactions
status: inProgress
GenerateVOAReportRequestExample:
value:
accountIds: '1000535275'
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
showNsf: false
fromDate: 1580558400
GenerateVOAReportResponseExample:
value:
id: u4hstnnak45g
portfolioId: dyr6qvqd2yhb-1-port
customerType: active
customerId: 1000006677
requestId: sfb7xp439w
requesterName: Decisioning API
createdDate: 1588350269
title: Finicity Verification of Assets
consumerId: ac39e237c7619a4ecf014b8d399c0696
consumerSsn: '6789'
constraints:
accountIds:
- '1000535275'
- '1000535276'
fromDate: 1577986990
showNsf: false
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
type: voa
status: inProgress
GenerateVOAWithIncomeReportRequestExample:
value:
accountIds: '1000535275'
fromDate: 1580558400
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
showNsf: false
incomeStreamConfidenceMinimum: 50
GenerateVOAWithIncomeReportResponseExample:
value:
id: u4hstnyak45g
portfolioId: dyr6weqd2yhb-1-port
customerType: active
customerId: 1000006677
requestId: sfb7x1we9w
requesterName: Decisioning API
createdDate: 1588350269
title: Verification of Asset and Income - Transactions
consumerId: ac39e237c7619a4ecf014b8d399c0696
consumerSsn: '6789'
constraints:
accountIds:
- '1000535275'
fromDate: 1580558400
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
showNsf: false
incomeStreamConfidenceMinimum: 50
type: voaHistory
status: inProgress
GeneratePrequalificationReportRequestExample:
value:
accountIds: '1000535275'
fromDate: 1580558400
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
showNsf: false
GeneratePrequalificationCRAReportResponseExample:
value:
id: 88w4fbssrbja-prequalvoa
portfolioId: 0whcism47a34-5-port
customerType: active
customerId: 1000006677
requestId: sfb7xacr9w
requesterName: Decisioning API
createdDate: 1588350269
title: Asset Ready Report (CRA)
consumerId: cb619e10185177cd92271c4da2df3fa3
consumerSsn: '6789'
constraints:
accountIds:
- '1000535275'
- '1000535276'
fromDate: 1577986990
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
showNsf: false
type: preQualVoa
status: inProgress
GeneratePrequalificationNonCRAReportResponseExample:
value:
id: rceiqx616awa-assetsummary
portfolioId: 0whcism47ttt-5-port
customerType: active
customerId: 1000006677
requestId: sfb7xp4iui
requesterName: Decisioning API
createdDate: 1588350269
title: Asset Ready Report (NON-CRA)
constraints:
accountIds:
- '1000535275'
- '1000535276'
fromDate: 1577986990
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
showNsf: false
type: assetSummary
status: inProgress
GenerateVOETransactionsReportRequestExample:
value:
reportId: j7k8qbgwsa7d-voietxverify
accountIds: '123456789'
fromDate: 1580558400
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
incomeStreamConfidenceMinimum: 50
GenerateVOETransactionsReportResponseExample:
value:
id: u4hstny1k25g-voetransactions
portfolioId: dyr6weqd2yhb-2-port
customerType: active
customerId: 1000006677
requestId: sfb7x1we9w
requesterName: Decisioning API
createdDate: 1588350269
title: Finicity Verification Employment - Transactions
consumerId: ac39e237c7619a4ecf014b8d399c0696
consumerSsn: '6789'
constraints:
reportId: j7k8qbgwsa7d-voietxverify
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
type: voeTransactions
status: inProgress
GenerateVOIEPaystubReportRequestExample:
value:
voieWithStatementData:
assetIds:
- d50ed92f-543b-431c-8286-c8b8f6556679
reportCustomFields:
- label: loanID
value: '123456'
shown: true
- label: trackingID
value: '5555'
shown: true
GenerateVOIEPaystubReportResponseExample:
value:
id: 2f3z55zuwewm-voietxverify
portfolioId: 9qud7dtuzbew-13-port
customerType: active
customerId: 1275320
requestId: 7a7qyps2iy
requesterName: Decisioning API
createdDate: 1579819592
title: Verification of Income and Employment - Paystub
consumerId: 3f7ff2cf0ffb3d0cd59875e070c9b1d4
consumerSsn: '6789'
constraints:
voieWithStatementData:
assetIds:
- d50ed92f-543b-431c-8286-c8b8f6556679
extractEarnings: true
extractDeductions: false
extractDirectDeposit: true
reportCustomFields:
- label: loanID
value: '123456'
shown: true
- label: trackingID
value: '5555'
shown: true
type: voieTxVerify
status: inProgress
GenerateVOIEPaystubWithTXVerifyReportRequestExample:
value:
accountIds: '1028361677'
voieWithInterviewData:
txVerifyInterview:
- assetId: 7eb57060-6d98-4449-992d-4dd4490448f3-1236011097
reportCustomFields:
- label: loanID
value: '123456'
shown: true
GenerateVOIEPaystubWithTXVerifyReportResponseExample:
value:
id: 2f3z55zuwewm-voietxverify
customerId: 1275320
consumerId: 3f7ff2cf0ffb3d0cd59875e070c9b1d4
consumerSsn: '6789'
requesterName: Decisioning API
requestId: 7a7qyps2iy
type: voieTxVerify
status: inProgress
createdDate: 1579819592
constraints:
accountIds:
- '1000535275'
voieWithInterviewData:
txVerifyInterview:
- assetId: 6f8fb0a0-e882-4f57-b672-cf53f1397581
accounts: []
extractEarnings: true
extractDeductions: false
extractDirectDeposit: true
reportCustomFields:
- label: loanID
value: '123456'
shown: true
customerType: active
title:
Finicity Verification of Income and Employment - Paystub (with
TXVerify)
portfolioId: 9qud7dtuzbew-2-port
GenerateVOIReportRequestExample:
value:
accountIds: 1000535275 1000535276
fromDate: 1577986990
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
incomeStreamConfidenceMinimum: 50
GenerateVOIReportResponseExample:
value:
id: u4hstnnaewetr-voi
portfolioId: dyr6qvqd2erw-1-port
customerType: active
customerId: 1000006677
requestId: sfb7xp4wer
requesterName: Decisioning API
createdDate: 1588350269
title: Finicity Verification of Income
consumerId: ac39e237c7619a4ecf014b8d399c0696
consumerSsn: '6789'
constraints:
accountIds:
- '1000535275'
- '1000535276'
fromDate: 1577986990
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
type: voi
status: inProgress
CashFlowPersonalReportExample:
summary: Cash Flow Report - Personal
value:
id: sd1j45yn37wr-cfrp
portfolioId: igi5kj6hh58y-1-port
customerType: testing
customerId: '5555'
requestId: xtw6tjemt6
title: Finicity Cash Flow Report - Personal
consumerId: 555595ec74c8ec57adf44dadddb6a35
consumerSsn: '1111'
requesterName: Decisioning API Tests
type: cfrp
status: success
createdDate: 1575666823
startDate: 1512594823
endDate: 1575666823
days: '730'
seasoned: true
institutions:
- id: '102105'
name: FinBank Profiles
urlHomeApp: http://www.finbank.com
accounts:
- id: '6681984'
ownerName: PATRICK & LORRAINE PURCHASER
ownerAddress: 7195 BELMONT ST. PARLIN, NJ 08859
name: Checking
number: XX1111
type: checking
aggregationStatusCode: '0'
currentBalance: 100000
availableBalance: 1000
balanceDate: 1614880526
transactions:
- id: '100671406523'
amount: -81.7
postedDate: 1614859200
description: TMOBILE*AUTO PAY
normalizedPayee: T-Mobile
institutionTransactionId: '0000000000'
category: Mobile Phone
cashFlowBalance:
monthlyCashFlowBalances:
- month: 1551423600
minDailyBalance: -65894.54
maxDailyBalance: -62196.98
averageDailyBalance: -64594.87
standardDeviationOfDailyBalance: '1099'
numberOfDaysNegativeBalance: '28'
numberOfDaysPositiveBalance: '0'
minDailyBalance: 3479.39
maxDailyBalance: 3479.39
twelveMonthAverageDailyBalance: 3479.39
sixMonthAverageDailyBalance: 3479.39
twoMonthAverageDailyBalance: 3479.39
twelveMonthStandardDeviationOfDailyBalance: '20'
sixMonthStandardDeviationOfDailyBalance: '20'
twoMonthStandardDeviationOfDailyBalance: '20'
numberDaysNegativeBalance: '6'
numberOfDaysPositiveBalance: '0'
cashFlowCredit:
monthlyCashFlowCredits:
- month: 1551423600
numberOfCredits: '3'
totalCreditsAmount: 5000.29
largestCredit: 2182.34
numberOfCreditsLessTransfers: '3'
totalCreditsAmountLessTransfers: 5000.29
averageCreditAmount: 1666.76
estimatedNumberOfLoanDeposits: '0'
estimatedLoanDepositAmount: 0
twelveMonthCreditTotal: 1200
twelveMonthCreditTotalLessTransfers: 1000
sixMonthCreditTotal: 750
sixMonthCreditTotalLessTransfers: 500
twoMonthCreditTotal: 150
twoMonthCreditTotalLessTransfers: 100
cashFlowDebit:
monthlyCashFlowDebits:
- month: 1551423600
numberOfDebits: '12'
totalDebitsAmount: -2063.43
largestDebit: -953.73
numberOfDebitsLessTransfers: '12'
totalDebitsAmountLessTransfers: -2063.43
averageDebitAmount: -171.95
twelveMonthDebitTotal: 1200
twelveMonthDebitTotalLessTransfers: 1000
sixMonthDebitTotal: 750
sixMonthDebitTotalLessTransfers: 500
twoMonthDebitTotal: 150
twoMonthDebitTotalLessTransfers: 100
cashFlowCharacteristic:
monthlyCashFlowCharacteristics:
- month: 1551423600
totalCreditsLessTotalDebits: 2936.86
totalCreditsLessTotalDebitsLessTransfers: 2936.86
averageTransactionAmount: 195.79
averageMonthlyNet: 2350
averageMonthlyNetLessTransfers: 1000
twelveMonthTotalNet: 12500
twelveMonthTotalNetLessTransfers: 12400
sixMonthAverageTotalCreditsLessTotalDebits: 55555
sixMonthAverageTotalCreditsLessTotalDebitsLessTransfers: 55555
twoMonthAverageTotalCreditsLessTotalDebits: 55555
twoMonthAverageTotalCreditsLessTotalDebitsLessTransfers: 55555
cashFlowBalanceSummary:
monthlyCashFlowBalanceSummaries:
- month: 1551423600
minDailyBalance: -65894.54
maxDailyBalance: -62196.98
averageDailyBalance: -64594.87
standardDeviationOfDailyBalance: '1099'
numberOfDaysNegativeBalance: '28'
numberOfDaysPositiveBalance: '0'
minDailyBalance: 3479.39
maxDailyBalance: 3479.39
twelveMonthAverageDailyBalance: 3479.39
sixMonthAverageDailyBalance: 3479.39
twoMonthAverageDailyBalance: 3479.39
twelveMonthStandardDeviationOfDailyBalance: '20'
sixMonthStandardDeviationOfDailyBalance: '20'
twoMonthStandardDeviationOfDailyBalance: '20'
numberOfDaysNegativeBalance: '6'
numberOfDaysPositiveBalance: '11'
cashFlowCreditSummary:
monthlyCashFlowCreditSummaries:
- month: 1551423600
numberOfCredits: '3'
totalCreditsAmount: 5000.29
largestCredit: 2182.34
numberOfCreditsLessTransfers: '3'
totalCreditsAmountLessTransfers: 5000.29
averageCreditAmount: 1666.76
estimatedNumberOfLoanDeposits: '0'
estimatedLoanDepositAmount: 0
twelveMonthCreditTotal: 1200
twelveMonthCreditTotalLessTransfers: 1000
sixMonthCreditTotal: 750
sixMonthCreditTotalLessTransfers: 500
twoMonthCreditTotal: 150
twoMonthCreditTotalLessTransfers: 100
cashFlowDebitSummary:
monthlyCashFlowDebitSummaries:
- month: 1551423600
numberOfDebits: '12'
totalDebitsAmount: -2063.43
largestDebit: -953.73
numberOfDebitsLessTransfers: '12'
totalDebitsAmountLessTransfers: -2063.43
averageDebitAmount: -171.95
twelveMonthDebitTotal: -1200
twelveMonthDebitTotalLessTransfers: -1000
sixMonthDebitTotal: -750
sixMonthDebitTotalLessTransfers: -500
twoMonthDebitTotal: -150
twoMonthDebitTotalLessTransfers: -100
cashFlowCharacteristicsSummary:
monthlyCashFlowCharacteristicSummaries:
- month: 1551423600
totalCreditsLessTotalDebits: 2936.86
totalCreditsLessTotalDebitsLessTransfers: 2936.86
averageTransactionAmount: 195.79
averageMonthlyNet: 1250
averageMonthlyNetLessTransfers: 1000
twelveMonthTotalNet: 12500
twelveMonthTotalNetLessTransfers: 12400
sixMonthAverageTotalCreditsLessTotalDebits: 55555
sixMonthAverageTotalCreditsLessTotalDebitsLessTransfers: 55555
twoMonthAverageTotalCreditsLessTotalDebits: 55555
twoMonthAverageTotalCreditsLessTotalDebitsLessTransfers: 55555
possibleLoanDeposits:
- id: '102105'
name: FinBank Profiles
urlHomeApp: http://www.finbank.com
accounts:
- id: '6681984'
ownerName: PATRICK & LORRAINE PURCHASER
ownerAddress: 7195 BELMONT ST. PARLIN, NJ 08859
name: Checking
number: XX1111
type: checking
aggregationStatusCode: '0'
currentBalance: 100000
availableBalance: 1000
balanceDate: 1614880526
transactions:
- id: '100671406523'
amount: -81.7
postedDate: 1614859200
description: TMOBILE*AUTO PAY
normalizedPayee: T-Mobile
institutionTransactionId: '0000000000'
category: Mobile Phone
CashFlowBusinessReportExample:
summary: Cash Flow Report - Business
value:
id: sd1j45yn37wr-cfrb
customerType: testing
customerId: '5555'
requestId: xtw6tjemt6
title: Finicity Cash Flow Report - Business
requesterName: Decisioning API Tests
type: cfrb
status: success
createdDate: 1575666823
startDate: 1512594823
endDate: 1575666823
days: '730'
seasoned: true
institutions:
- id: '102105'
name: FinBank Profiles
urlHomeApp: http://www.finbank.com
accounts:
- id: '6681984'
ownerName: PATRICK & LORRAINE PURCHASER
ownerAddress: 7195 BELMONT ST. PARLIN, NJ 08859
name: Checking
number: XX1111
type: checking
aggregationStatusCode: '0'
currentBalance: 100000
availableBalance: 1000
balanceDate: 1614880526
transactions:
- id: '100671406523'
amount: -81.7
postedDate: 1614859200
description: TMOBILE*AUTO PAY
normalizedPayee: T-Mobile
institutionTransactionId: '0000000000'
category: Mobile Phone
cashFlowBalance:
monthlyCashFlowBalances:
- month: 1551423600
minDailyBalance: -65894.54
maxDailyBalance: -62196.98
averageDailyBalance: -64594.87
standardDeviationOfDailyBalance: '1099'
numberOfDaysNegativeBalance: '28'
numberOfDaysPositiveBalance: '0'
minDailyBalance: 3479.39
maxDailyBalance: 3479.39
twelveMonthAverageDailyBalance: 3479.39
sixMonthAverageDailyBalance: 3479.39
twoMonthAverageDailyBalance: 3479.39
twelveMonthStandardDeviationOfDailyBalance: '20'
sixMonthStandardDeviationOfDailyBalance: '20'
twoMonthStandardDeviationOfDailyBalance: '20'
numberDaysNegativeBalance: '6'
numberOfDaysPositiveBalance: '0'
cashFlowCredit:
monthlyCashFlowCredits:
- month: 1551423600
numberOfCredits: '3'
totalCreditsAmount: 5000.29
largestCredit: 2182.34
numberOfCreditsLessTransfers: '3'
totalCreditsAmountLessTransfers: 5000.29
averageCreditAmount: 1666.76
estimatedNumberOfLoanDeposits: '0'
estimatedLoanDepositAmount: 0
twelveMonthCreditTotal: 1200
twelveMonthCreditTotalLessTransfers: 1000
sixMonthCreditTotal: 750
sixMonthCreditTotalLessTransfers: 500
twoMonthCreditTotal: 150
twoMonthCreditTotalLessTransfers: 100
cashFlowDebit:
monthlyCashFlowDebits:
- month: 1551423600
numberOfDebits: '12'
totalDebitsAmount: -2063.43
largestDebit: -953.73
numberOfDebitsLessTransfers: '12'
totalDebitsAmountLessTransfers: -2063.43
averageDebitAmount: -171.95
twelveMonthDebitTotal: 1200
twelveMonthDebitTotalLessTransfers: 1000
sixMonthDebitTotal: 750
sixMonthDebitTotalLessTransfers: 500
twoMonthDebitTotal: 150
twoMonthDebitTotalLessTransfers: 100
cashFlowCharacteristic:
monthlyCashFlowCharacteristics:
- month: 1551423600
totalCreditsLessTotalDebits: 2936.86
totalCreditsLessTotalDebitsLessTransfers: 2936.86
averageTransactionAmount: 195.79
averageMonthlyNet: 2350
averageMonthlyNetLessTransfers: 1000
twelveMonthTotalNet: 12500
twelveMonthTotalNetLessTransfers: 12400
sixMonthAverageTotalCreditsLessTotalDebits: 55555
sixMonthAverageTotalCreditsLessTotalDebitsLessTransfers: 55555
twoMonthAverageTotalCreditsLessTotalDebits: 55555
twoMonthAverageTotalCreditsLessTotalDebitsLessTransfers: 55555
cashFlowBalanceSummary:
monthlyCashFlowBalanceSummaries:
- month: 1551423600
minDailyBalance: -65894.54
maxDailyBalance: -62196.98
averageDailyBalance: -64594.87
standardDeviationOfDailyBalance: '1099'
numberOfDaysNegativeBalance: '28'
numberOfDaysPositiveBalance: '0'
minDailyBalance: 3479.39
maxDailyBalance: 3479.39
twelveMonthAverageDailyBalance: 3479.39
sixMonthAverageDailyBalance: 3479.39
twoMonthAverageDailyBalance: 3479.39
twelveMonthStandardDeviationOfDailyBalance: '20'
sixMonthStandardDeviationOfDailyBalance: '20'
twoMonthStandardDeviationOfDailyBalance: '20'
numberOfDaysNegativeBalance: '6'
numberOfDaysPositiveBalance: '11'
cashFlowCreditSummary:
monthlyCashFlowCreditSummaries:
- month: 1551423600
numberOfCredits: '3'
totalCreditsAmount: 5000.29
largestCredit: 2182.34
numberOfCreditsLessTransfers: '3'
totalCreditsAmountLessTransfers: 5000.29
averageCreditAmount: 1666.76
estimatedNumberOfLoanDeposits: '0'
estimatedLoanDepositAmount: 0
twelveMonthCreditTotal: 1200
twelveMonthCreditTotalLessTransfers: 1000
sixMonthCreditTotal: 750
sixMonthCreditTotalLessTransfers: 500
twoMonthCreditTotal: 150
twoMonthCreditTotalLessTransfers: 100
cashFlowDebitSummary:
monthlyCashFlowDebitSummaries:
- month: 1551423600
numberOfDebits: '12'
totalDebitsAmount: -2063.43
largestDebit: -953.73
numberOfDebitsLessTransfers: '12'
totalDebitsAmountLessTransfers: -2063.43
averageDebitAmount: -171.95
twelveMonthDebitTotal: -1200
twelveMonthDebitTotalLessTransfers: -1000
sixMonthDebitTotal: -750
sixMonthDebitTotalLessTransfers: -500
twoMonthDebitTotal: -150
twoMonthDebitTotalLessTransfers: -100
cashFlowCharacteristicsSummary:
monthlyCashFlowCharacteristicSummaries:
- month: 1551423600
totalCreditsLessTotalDebits: 2936.86
totalCreditsLessTotalDebitsLessTransfers: 2936.86
averageTransactionAmount: 195.79
averageMonthlyNet: 1250
averageMonthlyNetLessTransfers: 1000
twelveMonthTotalNet: 12500
twelveMonthTotalNetLessTransfers: 12400
sixMonthAverageTotalCreditsLessTotalDebits: 55555
sixMonthAverageTotalCreditsLessTotalDebitsLessTransfers: 55555
twoMonthAverageTotalCreditsLessTotalDebits: 55555
twoMonthAverageTotalCreditsLessTotalDebitsLessTransfers: 55555
possibleLoanDeposits:
- id: '102105'
name: FinBank Profiles
urlHomeApp: http://www.finbank.com
accounts:
- id: '6681984'
ownerName: PATRICK & LORRAINE PURCHASER
ownerAddress: 7195 BELMONT ST. PARLIN, NJ 08859
name: Checking
number: XX1111
type: checking
aggregationStatusCode: '0'
currentBalance: 100000
availableBalance: 1000
balanceDate: 1614880526
transactions:
- id: '100671406523'
amount: -81.7
postedDate: 1614859200
description: TMOBILE*AUTO PAY
normalizedPayee: T-Mobile
institutionTransactionId: '0000000000'
category: Mobile Phone
PrequalificationCRAReportExample:
summary: Prequalification CRA Report
value:
id: 88w4fbssrbja-prequalvoa
customerId: 1000006677
requesterName: Decisioning API
requestId: sfb7xacr9w
type: preQualVoa
status: success
createdDate: 1588350269
constraints:
accountIds:
- '1000535275'
- '1000535276'
fromDate: 1577986990
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
showNsf: false
customerType: active
title: Asset Ready Report (CRA)
startDate: 1572625469
endDate: 1588350269
days: 230
seasoned: true
consolidatedAvailableBalance: 1929.57
portfolioId: 0whcism47a34-5-port
consumerId: ac39e237c7619a4ecf014b8d399c0696
consumerSsn: '6789'
institutions:
id: 101732
name: FinBank
urlHomeApp: https://finbank.prod.fini.city/CCBankImageMFA/login.jsp
accounts:
id: 1000023996
number: '1111'
name: Checking
type: checking
aggregationStatusCode: 0
balance: 501.24
balanceDate: 1588350276
averageMonthlyBalance: 501.02
totNumberInsufficientFundsFeeDebitTxAccount: 0
totNumberInsufficientFundsFeeDebitTxOver6MonthsAccount: 0
totNumberDaysSinceMostRecentInsufficientFundsFeeDebitTxAccount: 120
transactions: []
asset:
type: checking
availableBalance: 1000
currentBalance: 1000
twoMonthAverage: -1865.96
sixMonthAverage: -7616.01
beginningBalance: -17795.6
details:
interestMarginBalance: -50000
availableCashBalance: 1500
vestedBalance: 300000
currentLoanBalance: 0
availableBalanceAmount: 1000
assets:
currentBalance: 1000
availableBalance: 1000
twoMonthAverage: -1865.96
sixMonthAverage: -7616.01
beginningBalance: -17795.6
PrequalificationNonCRAReportExample:
summary: Prequalification Non-CRA Report
value:
id: rceiqx616awa-assetsummary
customerId: 1000006677
requesterName: Decisioning API
requestId: sfb7xp4iui
type: assetSummary
status: success
createdDate: 1588350269
constraints:
accountIds:
- '1000535275'
- '1000535276'
fromDate: 1577986990
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
showNsf: false
customerType: active
title: Asset Ready Report (non-CRA)
startDate: 1572625469
endDate: 1588350269
days: 230
seasoned: true
consolidatedAvailableBalance: 1929.57
portfolioId: 0whcism47ttt-5-port
institutions:
- id: 101732
name: FinBank
urlHomeApp: https://finbank.prod.fini.city/CCBankImageMFA/login.jsp
accounts:
- id: 1000023996
number: '1111'
ownerName: JOHN DOE
ownerAddress: 924 GAINSVILLE HIGHWAY SUITE 130 BUFORD, GA 30518
name: Checking
type: checking
availableBalance: 0
aggregationStatusCode: 0
balance: 501.24
balanceDate: 1588350276
averageMonthlyBalance: 501.02
totNumberInsufficientFundsFeeDebitTxAccount: 0
totNumberInsufficientFundsFeeDebitTxOver6MonthsAccount: 0
totNumberDaysSinceMostRecentInsufficientFundsFeeDebitTxAccount: 120
transactions: []
asset:
type: checking
currentBalance: 1000
twoMonthAverage: -1865.96
sixMonthAverage: -7616.01
beginningBalance: -17795.6
details:
interestMarginBalance: -50000
availableCashBalance: 1500
vestedBalance: 300000
currentLoanBalance: 0
availableBalanceAmount: 1000
assets:
currentBalance: 1000
twoMonthAverage: -1865.96
sixMonthAverage: -7616.01
beginningBalance: -17795.6
PayStatementReportExample:
summary: Pay Statement Report
value:
id: y0ejausptjg1-paystatement
customerId: 1003413624
consumerId: 4089f408963dd6b90b28a935e9903c0e
consumerSsn: '6789'
requesterName: Decisioning API
requestId: 8wy5htqg8u
type: paystatement
status: success
createdDate: 1588350269
constraints:
paystatementReport:
assetIds:
- 6f8fb0a0-e882-4f57-b672-cf53f1397581
extractEarnings: true
extractDeductions: false
extractDirectDeposit: true
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
customerType: active
title: Finicity Pay Statement Extraction Report
startDate: 1572625469
endDate: 1588350269
portfolioId: spd8aehuw63i-10-port
reportStyle: paystatement
numberOfBillableAssets: 1
assetIds:
- 6f8fb0a0-e882-4f57-b672-cf53f1397581
payStatementTxVerifyDaoList:
payPeriod: LastPayPeriod
billable: true
assetId: 6f8fb0a0-e882-4f57-b672-cf53f1397581
payDate: 1559241000
startDate: 1557513000
endDate: 1558722600
netPayCurrent: 1802.22
netPayYTD: 36000
grossPayCurrent: 24200
grossPayYTD: 72600
payrollProvider: Finicity
employer:
name: Rocket Surgery
employee:
name: Patrick Purchaser
payStat:
name: regular 1
type: regular
description: regular income
amountCurrent: 6000
amountYTD: 18000
deductions:
- name: '401'
description: 401k
amountCurrent: 1744.61
amountYTD: 1744.6
type: 401 Deductions
directDeposits:
- financialInstitutionName: America First
accountType: Checking
amountCurrent: 1744.61
accountLastFour: XX34
description: Payroll
StatementReportExample:
summary: Statement Report
value:
id: 38dknche83oh-statement
customerType: active
customerId: 1000262464
requestId: nd4b55a4bg
title: Finicity Statement Report
consumerId: d15ff15ed0c8627eae61c452928d7fc3
consumerSsn: '1111'
requesterName: Demo
constraints:
statementReportData:
accountId: 1000076901
index: 1
reportCustomFields:
- label: loanID
value: '123456'
shown: true
type: statement
status: success
createdDate: 1586189339
assetId: aaaa3be2-6f1a-4aac-a360-4ad240aa652d
TransactionsReportExample:
summary: Transactions Report
value:
id: '1000075473'
title: Finicity Transactions Report
customerType: testing
customerId: 1000018865
consumerId: a925b07c9e028c680ad9c1d18d2e7199
consumerSsn: '6789'
type: transactions
status: success
createdDate: 1594678007
constraints:
accountIds:
- '1000075473'
fromDate: 1578952809
toDate: 1594677609
includePending: true
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
startDate: 1579348800
endDate: 1594382400
days: 174
seasoned: false
portfolioId: wqbh0r2kbv5g-4-port
institutions:
- id: 102105
name: FinBank Profiles - A
urlHomeApp: http://www.finbank.com
accounts:
- id: 1000075473
number: '5015'
name: Super Checking
type: checking
availableBalance: 1000
aggregationStatusCode: 0
balance: 1000
balanceDate: 1594676289
transactions:
- id: 100001490719
amount: -224
postedDate: 1594382400
description: ACH Withdrawal AMERICA FIRST CR
normalizedPayee: America First Cr
institutionTransactionId: '0000000000'
category: Income
memo: AMERICA FIRST CR
- id: 100001490897
amount: -81.7
postedDate: 1594123200
description: TMOBILE*AUTO PAY
normalizedPayee: T-Mobile
institutionTransactionId: '0000000000'
category: Mobile Phone
memo: TMOBILE debit
VOAReportExample:
summary: VOA Report
value:
id: u4hstnnak45g
customerId: 1000006677
consumerId: ac39e237c7619a4ecf014b8d399c0696
consumerSsn: '6789'
requesterName: Decisioning API
requestId: sfb7xp439w
type: voa
status: success
createdDate: 1588350269
constraints:
accountIds:
- '1000535275'
- '1000535276'
fromDate: 1577986990
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
showNsf: false
customerType: active
title: Finicity Verification of Assets
startDate: 1572625469
endDate: 1588350269
days: 180
seasoned: false
consolidatedAvailableBalance: 2345
portfolioId: dyr6qvqd2yhb-1-port
institutions:
id: 101732
name: FinBank
urlHomeApp: https://finbank.prod.fini.city/CCBankImageMFA/login.jsp
accounts:
id: 1000023996
number: '1111'
ownerName: JOHN DOE
ownerAddress: 924 GAINSVILLE HIGHWAY SUITE 130 BUFORD, GA 30518
name: Checking
type: checking
availableBalance: 501.24
aggregationStatusCode: 0
balance: 501.24
balanceDate: 1588350276
averageMonthlyBalance: 501.02
totNumberInsufficientFundsFeeDebitTxAccount: 0
totNumberInsufficientFundsFeeDebitTxOver2MonthsAccount: 0
totNumberDaysSinceMostRecentInsufficientFundsFeeDebitTxAccount: 120
transactions:
- id: 100000527471
amount: 22.21
postedDate: 1582286400
description: FINICITY INC PAYROLL
memo: Finicity amount credit
normalizedPayee: Finicity
institutionTransactionId: '100000000'
category: Paycheck
bestRepresentation: FINICITY INC PAYROLL
details:
interestMarginBalance: -50000
availableCashBalance: 1500
vestedBalance: 300000
currentLoanBalance: 0
availableBalanceAmount: 1000
asset:
currentBalance: 1000
twoMonthAverage: -1865.96
sixMonthAverage: -7616.01
beginningBalance: -17795.6
assets:
type: checking
availableBalance: 1000
currentBalance: 1000
twoMonthAverage: -1865.96
sixMonthAverage: -7616.01
beginningBalance: -17795.6
VOAWithIncomeReportExample:
summary: VOA With Income Report
value:
id: u4hstnyak45g
portfolioId: dyr6weqd2yhb-1-port
customerType: active
customerId: 1000006677
requestId: sfb7x1we9w
title: Finicity Verification of Asset and Income - Transactions
consumerId: ac39e237c7619a4ecf014b8d399c0696
consumerSsn: '6789'
requesterName: Decisioning API
constraints:
accountIds:
- '1000535275'
- '1000535276'
fromDate: 1577986990
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
- label: loanType
value: car
shown: false
- label: vendorID
value: 1613aa23
shown: true
- label: vendorName
value: PSC Finance
shown: false
showNsf: false
type: voaHistory
status: success
createdDate: 1588350269
startDate: 1572625469
endDate: 1588350269
days: 230
seasoned: true
institutions:
id: 101732
name: FinBank
urlHomeApp: https://finbank.prod.fini.city/CCBankImageMFA/login.jsp
accounts:
id: 6001966289
number: '1111'
ownerName: JOHN DOE
ownerAddress: 924 GAINSVILLE HIGHWAY SUITE 130 BUFORD, GA 30518
name: Checking
type: checking
currency: USD
aggregationStatusCode: 0
balance: 509.37
balanceDate: 1652114265
averageMonthlyBalance: 507.37
totNumberInsufficientFundsFeeDebitTxAccount: 0
totNumberDaysSinceMostRecentInsufficientFundsFeeDebitTxAccount: 0
transactions:
id: 100000527471
amount: 22.21
postedDate: 1582286400
description: FINICITY INC PAYROLL
normalizedPayee: Finicity
institutionTransactionId: '100000000'
category: Paycheck
asset:
type: checking
currentBalance: 1000
twoMonthAverage: -1865.96
sixMonthAverage: -7616.01
beginningBalance: -17795.6
details:
interestMarginBalance: -50000
availableCashBalance: 1500
vestedBalance: 300000
currentLoanBalance: 0
availableBalanceAmount: 1000
incomeStreams:
id: dens28i3vsch-voah
name: none
status: ACTIVE
estimateInclusion: MODERATE
confidence: 70
cadence:
startDate: 1577986990
stopDate: 1587986990
days: 14
netMonthly:
- month: 1522562400
net: 2004.77
netAnnual: 110475.7
projectedNetAnnual: 0
estimatedGrossAnnual:
projectedGrossAnnual: 151609
averageMonthlyIncomeNet: 9206.31
incomeStreamMonths: 18
transactions:
- id: 100000527471
amount: 22.21
postedDate: 1582286400
description: FINICITY INC PAYROLL
normalizedPayee: Finicity
institutionTransactionId: '100000000'
category: Paycheck
assets:
currentBalance: 1000
twoMonthAverage: -1865.96
sixMonthAverage: -7616.01
beginningBalance: -17795.6
consolidatedAvailableBalance: 2345
VOEPayrollReportExample:
summary: VOE - Payroll Report
value:
id: 41h4nzppn47u-voepayroll
portfolioId: 9qud7dtuzbew-3-port
createdDate: 1579819592
requesterName: Decisioning API
requestId: 7a7qyps2iy
customerType: active
customerId: 1275320
consumerId: 3f7ff2cf0ffb3d0cd59875e070c9b1d4
consumerSsn: '6789'
type: voePayroll
title: Verification of Employment - Payroll
status: success
constraints:
payrollData:
payrollDataRetrievalId: hahvhe2k0000
employerNames:
- ACME INC
reportId: abcdefghijkl-voiepayroll
employmentHistory:
- asOfDate: 1596175200
employerName: ACME INC
payrollSource: finPayroll
employee:
name: John Doe Smith
givenName: John
middleName: Doe
familyName: Smith
address:
- address1: Address 1
city: City
state: TX
zip: '99999'
employment:
employerName: ACME INC
legalEntityId: '752760000'
originalHireDate: 1527832800
latestHireDate: 1527832800
latestPayDate: 1596175200
daysSinceLastPay: 10
numberPayCadenceWithoutPay: 1
employmentEndDate: 1527832800
employmentDuration: P1Y6M0D
employerAddress:
- address1: Address 1
city: City
state: TX
zip: '99999'
employmentStatusCode: A
employmentStatusName: Active
workLevelCode: FT
workLevelName: Full Time-Regular
workLevelStatus: Full Time
positionTitle: Shift Supervisor
positionDuration: P1Y6M0D
income:
payFrequency: Weekly
VOETransactionsReportExample:
summary: VOE - Transactions Report
value:
id: n1rndg1iz8yy-voetransactions
portfolioId: dyr6weqd2yhb-2-port
customerType: active
customerId: 1000006677
requestId: sfb7x1we9w
title: Finicity Verification of Employment - Transactions
consumerId: ac39e237c7619a4ecf014b8d399c0696
consumerSsn: '6789'
requesterName: Decisioning API
constraints:
reportId: j7k8qbgwsa7d-voietxverify
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
incomeStreamConfidenceMinimum: 50
type: voeTransactions
status: success
createdDate: 1588350269
startDate: 1572625469
endDate: 1588350269
days: 120
seasoned: true
institutions:
- id: 101732
name: FinBank
urlHomeApp: https://finbank.prod.fini.city/CCBankImageMFA/login.jsp
accounts:
- id: 1000023996
number: '1111'
ownerName: JOHN DOE
ownerAddress: 924 GAINSVILLE HIGHWAY SUITE 130 BUFORD, GA 30518
name: Checking
type: checking
aggregationStatusCode: 0
incomeStreams:
- id: u4hstnyak45g1
name: none
status: ACTIVE
estimateInclusion: MODERATE
confidence: 70
cadence:
startDate: 1577986990
stopDate: 1587986990
days: 14
daysSinceLastTransaction: 15
nextExpectedTransactionDate: 1698788820
incomeStreamMonths: 18
transactions:
- id: 100000527471
postedDate: 1582286400
description: FINICITY INC PAYROLL
normalizedPayee: Finicity
institutionTransactionId: '100000000'
category: Paycheck
VOIReportExample:
summary: VOI Report
value:
id: u4hstnnaewetr-voi
customerId: 1000006677
consumerId: ac39e237c7619a4ecf014b8d399c0696
consumerSsn: '6789'
requesterName: Decisioning API
requestId: sfb7xp4wer
type: voi
status: success
createdDate: 1588350269
customerType: active
title: Finicity Verification of Income
startDate: 1572625469
endDate: 1588350269
days: 200
seasoned: true
portfolioId: dyr6qvqd2erw-1-port
institutions:
id: 101732
name: FinBank
urlHomeApp: https://finbank.prod.fini.city/CCBankImageMFA/login.jsp
accounts:
id: 1000023996
number: '1111'
name: Checking
type: checking
aggregationStatusCode: 0
incomeStreams:
id: dens28i3vsch-voi1
name: none
status: ACTIVE
estimateInclusion: MODERATE
confidence: 70
cadence:
startDate: 1577986990
stopDate: 1587986990
days: 14
netMonthly:
- month: 1522562400
net: 2004.77
netAnnual: 110475.7
projectedNetAnnual: 0
estimatedGrossAnnual:
projectedGrossAnnual: 151609
averageMonthlyIncomeNet: 9206.31
incomeStreamMonths: 18
transactions:
- id: 100000527471
amount: 22.21
postedDate: 1582286400
description: FINICITY INC PAYROLL
memo: Finicity amount credit
institutionTransactionId: '100000000'
category: Paycheck
balance: 714.16
averageMonthlyBalance: 720.75
transactions: []
availableBalance: 714.16
currentBalance: 714.16
beginningBalance: 714.77
miscDeposits:
- id: 100000527471
amount: 22.21
postedDate: 1582286400
description: FINICITY INC PAYROLL
memo: Finicity amount credit
institutionTransactionId: '100000000'
category: Paycheck
income:
- confidenceType: MODERATE
netMonthly:
- month: 1522562400
net: 2004.77
incomeEstimate:
netAnnual: 1000.12
projectedNetAnnual: 1500.23
estimatedGrossAnnual: 2000.12
projectedGrossAnnual: 2500.23
VOIEPayrollReportExample:
summary: VOIE - Payroll Report
value:
id: 41h4nzppn37u-voiepayroll
portfolioId: 9qud7dtuzbew-13-port
customerType: active
customerId: 1275320
requestId: 7a7qyps2iy
consumerId: 3f7ff2cf0ffb3d0cd59875e070c9b1d4
consumerSsn: '6789'
requesterName: Decisioning API
type: voiePayroll
status: success
createdDate: 1579819592
title: Verification of Income and Employment - Payroll
constraints:
payrollData:
payrollDataRetrievalId: hahvhe2k0000
employerNames:
- ACME INC
reportCustomFields:
label: loanID
value: '12345'
shown: true
payStatementsFromDate: 1580558400
employmentHistory:
asOfDate: 1596175200
employerName: ACME INC
payrollSource: finPayroll
employee:
name: John Doe Smith
givenName: John
middleName: Doe
familyName: Smith
address:
- address1: Address 1
city: City
state: TX
zip: '99999'
employment:
employerName: ACME INC
legalEntityId: '752760000'
originalHireDate: 1527832800
latestHireDate: 1527832800
latestPayDate: 1596175200
daysSinceLastPay: 10
numberPayCadenceWithoutPay: 1
employmentEndDate: 1527832800
employmentDuration: P1Y6M0D
employerAddress:
- address1: Address 1
city: City
state: TX
zip: '99999'
employmentStatusCode: A
employmentStatusName: Active
workLevelCode: FT
workLevelName: Full Time-Regular
workLevelStatus: Full Time
positionTitle: Shift Supervisor
positionDuration: P1Y6M0D
income:
payFrequency: Weekly
payType: Hourly
basePayRate: 27.5
annualIncome:
- year: '2021'
grossPayAmountYTD: 73925.12
netPayAmountYTD: 73925.12
basePayAmountYTD: 73925.12
overtimePayAmountYTD: 100.01
- year: '2020'
grossPayAmountYTD: 73925.12
netPayAmountYTD: 73925.12
basePayAmountYTD: 73925.12
overtimePayAmountYTD: 100.01
- year: '2019'
grossPayAmountYTD: 73925.12
netPayAmountYTD: 73925.12
basePayAmountYTD: 73925.12
overtimePayAmountYTD: 100.01
monthlyIncome:
estimatedMonthlyBasePay: 2000
estimatedMonthlyOvertimePay: 100
directPayStatements:
- payrollPayHistoryId: cy1a742k28
lastPayPeriodIndicator: true
mainPayStatementFields:
payDate: 1596175200
startDate: 1595138400
endDate: 1595656800
payPeriodHours: 40
payFrequency: Weekly
payType: Hourly
grossPayAmount: 1888.75
grossPayAmountYTD: 73925
netPayAmount: 1401.95
netPayAmountYTD: 73925
earnings:
- name: basePayAmount
type: base
rate: 27.5
amount: 1100
amountYTD: 5500
deductions:
- type: Federal tax
amount: 143.45
- type: State tax
amount: 12.5
directDeposits:
- accountTypeCode: Savings
amount: 1401.95
accountLastFour: '1234'
routingNumber: '000000000'
VOIEPaystubReportExample:
summary: VOIE - Paystub Report
value:
id: 2f3z55zuwewm-voietxverify
portfolioId: 9qud7dtuzbew-13-port
customerType: active
customerId: 1275320
consumerId: 3f7ff2cf0ffb3d0cd59875e070c9b1d4
consumerSsn: '6789'
requesterName: Decisioning API
requestId: 7a7qyps2iy
type: voieTxVerify
status: success
createdDate: 1579819592
title: Verification of Income and Employment - Paystub
reportStyle: voieWithStatement
constraints:
voieWithStatementData:
assetIds:
- d50ed92f-543b-431c-8286-c8b8f6556679
extractEarnings: true
extractDeductions: false
extractDirectDeposit: true
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
assetIds:
- 6f8fb0a0-e882-4f57-b672-cf53f1397581
numberOfBillableAssets: 1
payStatements:
payPeriod: LastPayPeriod
billable: true
assetId: 6f8fb0a0-e882-4f57-b672-cf53f1397581
payDate: 1559241000
startDate: 1557513000
endDate: 1558722600
netPayCurrent: 1802.22
netPayYTD: 36000
grossPayCurrent: 24200
grossPayYTD: 72600
employer:
name: Rocket Surgery
employee:
name: Patrick Purchaser
payStat:
name: regular 1
type: regular
description: regular income
amountCurrent: 6000
amountYTD: 18000
directDeposits:
- amountCurrent: 1744.61
accountLastFour: '1234'
monthlyIncome:
estimatedMonthlyBasePay: 2000
estimatedMonthlyOvertimePay: 50
estimatedMonthlyBonusPay: 20
estimatedMonthlyCommissionPay: 50
institutions: []
VOIEPaystubWithTXVerifyReportExample:
summary: VOIE - Paystub With TXVerify Report
value:
id: 2f3z55zuwewm-voietxverify
customerId: 1275320
consumerId: 3f7ff2cf0ffb3d0cd59875e070c9b1d4
consumerSsn: '6789'
requesterName: Decisioning API
requestId: 7a7qyps2iy
type: voieTxVerify
status: success
createdDate: 1579819592
title: Verification of Income and Employment - Paystub (with TXVerify)
constraints:
accountIds:
- '1000535275'
- '6001966284'
fromDate: 1620322948
voieWithInterviewData:
txVerifyInterview:
- assetId: 6f8fb0a0-e882-4f57-b672-cf53f1397581
accounts: []
extractEarnings: true
extractDeductions: false
extractDirectDeposit: true
reportCustomFields:
- label: loanID
value: '12345'
shown: true
- label: trackingID
value: '5555'
shown: true
incomeStreamConfidenceMinimum: 50
customerType: active
portfolioId: 9qud7dtuzbew-13-port
numberOfBillableAssets: 1
reportStyle: voieWithInterview
assetIds:
- 6f8fb0a0-e882-4f57-b672-cf53f1397581
payStatements:
payPeriod: LastPayPeriod
billable: true
assetId: 6f8fb0a0-e882-4f57-b672-cf53f1397581
payDate: 1559241000
startDate: 1557513000
endDate: 1558722600
netPayCurrent: 1802.22
netPayYTD: 36000
grossPayCurrent: 24200
grossPayYTD: 72600
matchType: NET_PAY_MATCH
employer:
name: Rocket Surgery
employee:
name: Patrick Purchaser
payStat:
name: regular 1
type: regular
description: regular income
amountCurrent: 6000
amountYTD: 18000
directDeposits:
- fiName: America First
accountType: Checking
amountCurrent: 1744.61
description: Payroll
monthlyIncome:
estimatedMonthlyBasePay: 2000
estimatedMonthlyOvertimePay: 50
estimatedMonthlyBonusPay: 20
estimatedMonthlyCommissionPay: 50
institutions:
id: 101732
name: FinBank
urlHomeApp: https://finbank.prod.fini.city/CCBankImageMFA/login.jsp
accounts:
id: 1000023996
number: '1111'
ownerName: JOHN DOE
ownerAddress: 924 GAINSVILLE HIGHWAY SUITE 130 BUFORD, GA 30518
name: Checking
type: checking
availableBalance: 123.45
aggregationStatusCode: 0
balance: 123.45
balanceDate: 1588350276
averageMonthlyBalance: 301.45
transactions: []
details:
interestMarginBalance: -50000
availableCashBalance: 1500
vestedBalance: 300000
currentLoanBalance: 0
availableBalanceAmount: 2000
incomeStream:
id: dens28i3vsch-voitxverify2
name: none
status: ACTIVE
confidence: 70
cadence:
startDate: 1577986990
stopDate: 1587986990
days: 180
netAnnual: 110475.7
projectedNetAnnual: 0
estimatedGrossAnnual: 0
projectedGrossAnnual: 151609
incomeStreamMonths: 24
averageMonthlyIncomeNet: 9206.31
transactions:
- id: 100000527471
amount: 1802.22
postedDate: 1559241000
description: FINICITY INC PAYROLL
memo: Finicity amount credit
institutionTransactionId: '100000000'
category: Paycheck
payStatementMatchTypes:
- DATE
- NET_AMOUNT
- DIRECT_DEPOSIT_AMOUNT
- EMPLOYER_NAME
- INCOME_STREAM_PAYCHECK
incomeStreams:
- id: dens28i3vsch-voitxverify2
name: none
status: ACTIVE
confidence: 70
cadence:
startDate: 1577986990
stopDate: 1587986990
days: 180
netAnnual: 110475.7
projectedNetAnnual: 0
estimatedGrossAnnual: 0
projectedGrossAnnual: 151609
incomeStreamMonths: 24
averageMonthlyIncomeNet: 9206.31
transactions:
- id: 100000527471
amount: 1802.22
postedDate: 1559241000
description: FINICITY INC PAYROLL
memo: Finicity amount credit
institutionTransactionId: '100000000'
category: Paycheck
payStatementMatchTypes:
- DATE
- NET_AMOUNT
- DIRECT_DEPOSIT_AMOUNT
- EMPLOYER_NAME
- INCOME_STREAM_PAYCHECK
institutions:
id: 101732
name: FinBank
urlHomeApp: https://finbank.prod.fini.city/CCBankImageMFA/login.jsp
accounts:
- id: 1000023996
ownerName: JOHN DOE
ownerAddress: 924 GAINSVILLE HIGHWAY SUITE 130 BUFORD, GA 30518
name: Checking
number: '1111'
type: checking
aggregationStatusCode: 0
incomeStreams:
- id: dens28i3vsch-voietxverify
name: none
status: ACTIVE
confidence: 70
cadence:
startDate: 1577986990
stopDate: 1587986990
days: 180
netMonthly:
- month: 1522562400
net: 2004.77
netAnnual: 110475.7
projectedNetAnnual: 0
estimatedGrossAnnual: 12392.1
projectedGrossAnnual: 151609
averageMonthlyIncomeNet: 9206.31
incomeStreamMonths: 24
transactions:
- id: 100000527471
amount: 1802.22
postedDate: 1559241000
description: FINICITY INC PAYROLL
memo: Finicity amount credit
institutionTransactionId: '100000000'
category: Paycheck
balance: 123.45
averageMonthlyBalance: 301.45
transactions: []
availableBalance: 123.45
parameters:
AssetIdParameter:
description: The asset ID
name: assetId
in: path
required: true
schema:
$ref: '#/components/schemas/AssetId'
example: 097545c5-1c2a-4f20-a5ef-77f0820344c9-2018601178
CustomerIdParameter:
description: A customer ID
name: customerId
in: path
required: true
schema:
$ref: '#/components/schemas/CustomerId'
example: '1005061234'
AccountStatusParameter:
description: A filter to fetch account in the given status
name: status
in: query
required: false
schema:
$ref: '#/components/schemas/AccountStatus'
example: pending
AnalyticIdParameter:
description: The analytic ID
name: analyticsId
in: path
required: true
schema:
$ref: '#/components/schemas/AnalyticId'
example: CA-5dfbaa3ac-5321
TransactionIdParameter:
description: A transaction ID
name: transactionId
in: path
required: true
schema:
$ref: '#/components/schemas/TransactionId'
example: 21284820852
IncludePendingParameter:
description: If pending transactions must be included
name: includePending
in: query
required: false
schema:
$ref: '#/components/schemas/IncludePending'
example: false
ApplicationIdPathParameter:
description: The application ID
name: applicationId
in: path
required: true
schema:
$ref: '#/components/schemas/ApplicationId'
example: '123456789'
ApplicationIdQueryParameter:
description: The application ID
name: applicationId
in: query
required: false
schema:
$ref: '#/components/schemas/ApplicationId'
example: '123456789'
AppRegistrationStatusParameter:
description: Look up app registration requests by status
name: status
in: query
required: false
schema:
$ref: '#/components/schemas/AppRegistrationStatus'
example: P
ApplicationNameParameter:
description: Look up app registration requests by app name
name: appName
in: query
required: false
schema:
$ref: '#/components/schemas/ApplicationName'
example: Awesome Budget App
SubmittedDateParameter:
description:
Look up app registration requests by the date they were submitted
name: submittedDate
in: query
required: false
schema:
$ref: '#/components/schemas/UnixDate'
example: 1607450357
ModifiedDateParameter:
description:
Look up app registration requests by the date the request was updated.
This can be used to determine when a request was updated to "A" or "R".
name: modifiedDate
in: query
required: false
schema:
$ref: '#/components/schemas/UnixDate'
example: 1607450357
PreAppIdQueryParameter:
description: The application registration tracking ID
name: preAppId
in: query
required: false
schema:
$ref: '#/components/schemas/PreAppId'
example: '2581'
PreAppIdPathParameter:
description: The application registration tracking ID
name: preAppId
in: path
required: true
schema:
$ref: '#/components/schemas/PreAppId'
example: '2581'
CustomerSearchParameter:
name: search
in: query
required: false
description: >-
The text you wish to match. Leave this empty if you wish to return all
customers. Must be URL-encoded (see: [Handling Spaces in
Queries](https://docs.finicity.com/endpoint-syntax-and-format/)).
schema:
type: string
example: searchvalue
CustomerUsernameParameter:
name: username
in: query
required: false
description: Username for exact match (will return 0 or 1 record)
schema:
$ref: '#/components/schemas/CustomerUsername'
example: customerusername1
CustomerTypeParameter:
name: type
in: query
required: false
description: >-
"testing" or "active" to return only customers of that type, or leave
empty to return all customers
schema:
$ref: '#/components/schemas/CustomerType'
example: 'active'
AccountIdParameter:
description: The account ID
name: accountId
in: path
required: true
schema:
$ref: '#/components/schemas/AccountId'
example: '5011648377'
StatementIndexParameter:
name: index
in: query
required: false
description:
Request statements from 1-24. By default, 1 is the most recent
statement. Increase the index value to count back (by month) and
retrieve its most recent statement.
schema:
type: integer
format: int32
default: 1
example: 1
maximum: 24
SubscriptionIdParameter:
description: The subscription ID
name: subscriptionId
in: path
required: true
schema:
$ref: '#/components/schemas/SubscriptionId'
example: 17554874
InstitutionLoginIdParameter:
description: The institution login ID
name: institutionLoginId
in: path
required: true
schema:
$ref: '#/components/schemas/InstitutionLoginId'
example: '1007302745'
InstitutionIdParameter:
description: The institution ID
name: institutionId
in: path
required: true
schema:
$ref: '#/components/schemas/NumericInstitutionId'
example: 4222
PurposeParameter:
name: purpose
in: query
required: false
description: >-
2-digit code from [Permissible Purpose
Codes](https://docs.finicity.com/permissible-purpose-codes/), specifying
the reason for retrieving this report. Required for retrieving some
reports.
schema:
type: string
example: '99'
ReportIdParameter:
name: reportId
in: path
description: ID of the report
required: true
schema:
$ref: '#/components/schemas/ReportId'
example: u4hstnnak45g
OnBehalfOfParameter:
name: onBehalfOf
in: query
description:
The name of the entity you are retrieving the report on behalf of
required: false
schema:
type: string
example: 'Some entity'
ConsumerIdParameter:
description: The consumer ID
name: consumerId
in: path
required: true
schema:
$ref: '#/components/schemas/ConsumerId'
example: '0bf46322c167b562e6cbed9d40e19a4c'
PortfolioIdParameter:
description:
A portfolio ID with the portfolio version number. Using the portfolio
number without a version number will return the most recently generated
reports.
name: portfolioId
in: path
required: true
schema:
$ref: '#/components/schemas/PortfolioId'
example: y4zsgccj4xpw-6-port
StartParameter:
name: start
in: query
required: false
description: Index of the page of results to return
schema:
type: integer
format: int32
default: 1
example: 1
LimitParameter:
name: limit
in: query
required: false
description: Maximum number of results per page
schema:
type: integer
format: int32
default: 25
maximum: 1000
example: 25
SortParameter:
name: sort
in: query
required: false
description: 'Date sort order: "asc" for ascending, "desc" for descending'
schema:
type: string
default: 'desc'
example: 'desc'
ResultPageParameter:
name: page
in: query
required: false
description: Index of the page of results to return
schema:
type: integer
format: int32
default: 1
example: 1
ResultPageSizeParameter:
name: pageSize
in: query
required: false
description: Maximum number of results per page
schema:
type: integer
format: int32
default: 1
example: 20
ProductTypeParameter:
name: type
in: query
description:
'A product type: "transAgg", "ach", "stateAgg", "voi", "voa", "aha",
"availBalance", "accountOwner"'
required: false
schema:
type: string
example: voa
InstitutionSearchParameter:
name: search
in: query
description:
Search term (financial institution `name` field). Leave empty for all
FIs.
required: false
schema:
type: string
example: finbank
RequiredFromDateParameter:
description: A start date
name: fromDate
in: query
required: true
schema:
$ref: '#/components/schemas/UnixDate'
example: 1607450357
RequiredToDateParameter:
description: A end date
name: toDate
in: query
required: true
schema:
$ref: '#/components/schemas/UnixDate'
example: 1607450357
ReportCallbackUrlParameter:
name: callbackUrl
in: query
required: false
description:
A Report Listener URL to receive notifications. The webhook must respond
to the Finicity API with a 2xx HTTP status code.
schema:
type: string
example: 'https://finicity-test/webhook'
schemas:
ErrorMessage:
required:
- code
type: object
properties:
code:
type: object
description:
'An error code (can be returned as a number or a string). Useful
links: [API Errors](https://docs.finicity.com/api-errors/),
[Aggregation Status
Codes](https://docs.finicity.com/aggregation-status-codes/).'
example: '10001'
status:
type: string
description: A status code
example: '401'
title:
type: string
description: A title for the error
example: Connecting accounts error
level:
type: string
description: An error level
example: error
message:
type: string
description: An error message
example: Invalid authorization credentials
user_message:
type: string
description: Some more details about the error
example: The session has expired or is invalid
assetId:
$ref: '#/components/schemas/AssetId'
accountId:
$ref: '#/components/schemas/AccountId'
PartnerId:
type: string
description:
Your Partner ID displayed in the [Developer
Dashboard](https://developer.finicity.com/admin)
example: '1234583871234'
PartnerName:
type: string
description: Name of a Finicity partner
example: Finicity Test API
ConnectLanguage:
description: >
Generate a translated Connect URL link.
Supported languages:
* English (default)
* Spanish (United States): `es`
* French (Canada): `fr` or `fr-CA`
type: string
example: 'fr-CA'
ConsumerId:
type: string
description:
'A consumer ID. See Create Consumer API for how to create a consumer ID.'
example: '0bf46322c167b562e6cbed9d40e19a4c'
CustomerId:
type: string
description:
'A customer ID. See Add Customer API for how to create a customer ID.'
example: '1005061234'
NumericCustomerId:
type: integer
format: int64
description:
'A customer ID represented as a number. See Add Customer API for how to
create a customer ID.'
example: 1005061234
AccountStatus:
description: An account status
type: string
example: pending
ReportId:
type: string
description: A report ID
example: u4hstnnak45g
ReportTitle:
type: string
description: Title of the report
example: Finicity Asset Ready Report (CRA)
ReportRequestId:
type: string
description:
Finicity indicator to track all activity associated with this report
example: cjqm4wtdcn
PortfolioId:
type: string
description:
A unique identifier that will be consistent across all reports created
for the same customer
example: y4zsgccj4xpw-6-port
AccountId:
type: string
description: An account ID
example: '5011648377'
NumericAccountId:
type: integer
format: int64
description: An account ID represented as a number
example: 5011648377
AccountNumberLast4:
type: string
description: The last 4 digits of the ACH account number
example: '5678'
SubscriptionId:
description: ID of a TxPush subscription
type: integer
format: int64
example: 17554874
SubscriptionType:
type: string
description: A TxPush subscription type ("account" or "transaction")
example: 'account'
TransactionId:
type: integer
description: A transaction ID
format: int64
example: 21284820852
IncludePending:
type: boolean
description: If pending transactions must be included
example: true
default: false
AssetId:
type: string
description:
An asset ID. Generated by Connect or by using the Store Customer Pay
Statement API.
example: 097545c5-1c2a-4f20-a5ef-77f0820344c9-2018601178
ReportAccountIdsString:
type: string
description:
A whitespace-separated list of account IDs to be included in the report
(all accounts will be included if not set)
example: '5011648377 5011648378 5011648379'
ReportAccountIds:
description:
An array of account IDs to be included in the report (all accounts will
be included if not set)
type: array
items:
$ref: '#/components/schemas/AccountId'
example:
- '5011648377'
- '5011648378'
- '5011648379'
Rssd:
type: integer
description: >-
The RSSD ID is a unique identifier assigned to financial institutions by
the Federal Reserve. While the length of the RSSD ID varies by
institution, it cannot exceed 10 numerical digits.
format: int64
example: 490535
InstitutionId:
description: The ID of a financial institution
type: string
example: '4222'
NumericInstitutionId:
description: The ID of a financial institution, represented as a number
type: integer
format: int64
example: 4222
InstitutionName:
type: string
description: The name of the institution
example: 'FinBank'
InstitutionTransAgg:
type: boolean
description: >-
"true": The institution is certified for the Transaction Aggregation
product
"false": The institution is decertified for the Transaction Aggregation
product
example: true
InstitutionAch:
type: boolean
description: >-
"true": The institution is certified for the ACH product
"false": The institution is decertified for the ACH product
example: true
InstitutionStateAgg:
type: boolean
description: >-
"true": The institution is certified for the Statement Aggregation
product
"false": The institution is decertified for the Statement Aggregation
product
example: false
InstitutionVoi:
type: boolean
description: >-
"true": The institution is certified for the VOI product
"false": The institution is decertified for the VOI product
example: true
InstitutionVoa:
type: boolean
description: >-
"true": The institution is certified for the VOA product
"false": The institution is decertified for the VOA product
example: true
InstitutionAha:
type: boolean
description: >-
"true": The institution is certified for the Account History Aggregation
product
"false": The institution is decertified for the Account History
Aggregation product
example: false
InstitutionAvailableBalance:
type: boolean
description: >-
"true": The institution is certified for the Account Balance Check (ABC)
product
"false": The institution is decertified for the Account Balance Check
(ABC) product
example: false
InstitutionAccountOwner:
type: boolean
description: >-
"true": The institution is certified for the Account Owner product
"false": The institution is decertified for the Account Owner product
example: true
InstitutionLoginId:
type: string
description: An institution login ID (from the account record)
example: '1007302745'
NumericInstitutionLoginId:
type: integer
format: int64
description:
An institution login ID (from the account record), represented as a
number
example: 1007302745
PartnerCredentials:
required:
- partnerId
- partnerSecret
type: object
properties:
partnerId:
$ref: '#/components/schemas/PartnerId'
partnerSecret:
type: string
description:
Your Partner Secret displayed in the [Developer
Dashboard](https://developer.finicity.com/admin)
example: aqJ5Ic4SEVx2IgDQ6oR4
PartnerCredentialsWithNewSecret:
required:
- partnerId
- partnerSecret
- newPartnerSecret
type: object
allOf:
- $ref: '#/components/schemas/PartnerCredentials'
- type: object
properties:
newPartnerSecret:
type: string
description: A new value for the Partner Secret
example: OrU7tjiA3tIspCgb85xV
AccessToken:
required:
- token
type: object
description: >-
A temporary access token to be passed in the `Finicity-App-Token` HTTP
header of all subsequent API requests
properties:
token:
description: The access token value
type: string
example: YBh22Sb9Es6e66Q7lWdt
ConnectParameters:
required:
- partnerId
- customerId
type: object
properties:
language:
$ref: '#/components/schemas/ConnectLanguage'
partnerId:
$ref: '#/components/schemas/PartnerId'
customerId:
$ref: '#/components/schemas/CustomerId'
consumerId:
# Required for any connect type that generates a report
$ref: '#/components/schemas/ConsumerId'
redirectUri:
$ref: '#/components/schemas/RedirectUri'
webhook:
$ref: '#/components/schemas/Webhook'
webhookContentType:
$ref: '#/components/schemas/WebhookContentType'
webhookData:
$ref: '#/components/schemas/WebhookData'
webhookHeaders:
$ref: '#/components/schemas/WebhookHeaders'
optionalConsumerInfo:
$ref: '#/components/schemas/ConsumerInfo'
singleUseUrl:
$ref: '#/components/schemas/SingleUseUrl'
experience:
$ref: '#/components/schemas/Experience'
institutionSettings:
$ref: '#/components/schemas/InstitutionSettings'
fromDate:
$ref: '#/components/schemas/ConnectFromDate'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
LiteConnectParameters:
required:
- partnerId
- customerId
- institutionId
type: object
properties:
language:
$ref: '#/components/schemas/ConnectLanguage'
partnerId:
$ref: '#/components/schemas/PartnerId'
customerId:
$ref: '#/components/schemas/CustomerId'
institutionId:
$ref: '#/components/schemas/NumericInstitutionId'
redirectUri:
$ref: '#/components/schemas/RedirectUri'
webhook:
$ref: '#/components/schemas/Webhook'
webhookContentType:
$ref: '#/components/schemas/WebhookContentType'
webhookData:
$ref: '#/components/schemas/WebhookData'
webhookHeaders:
$ref: '#/components/schemas/WebhookHeaders'
experience:
$ref: '#/components/schemas/Experience'
singleUseUrl:
$ref: '#/components/schemas/SingleUseUrl'
FixConnectParameters:
required:
- partnerId
- customerId
- institutionLoginId
type: object
properties:
language:
$ref: '#/components/schemas/ConnectLanguage'
partnerId:
$ref: '#/components/schemas/PartnerId'
customerId:
$ref: '#/components/schemas/CustomerId'
institutionLoginId:
# Used in type "fix" in order to pull up a fix flow for a specific set of
# accounts under one institution login ID
$ref: '#/components/schemas/InstitutionLoginId'
redirectUri:
$ref: '#/components/schemas/RedirectUri'
webhook:
$ref: '#/components/schemas/Webhook'
webhookContentType:
$ref: '#/components/schemas/WebhookContentType'
webhookData:
$ref: '#/components/schemas/WebhookData'
webhookHeaders:
$ref: '#/components/schemas/WebhookHeaders'
experience:
$ref: '#/components/schemas/Experience'
singleUseUrl:
$ref: '#/components/schemas/SingleUseUrl'
ConnectEmailParameters:
required:
- partnerId
- customerId
- consumerId
- email
type: object
properties:
language:
$ref: '#/components/schemas/ConnectLanguage'
partnerId:
$ref: '#/components/schemas/PartnerId'
customerId:
$ref: '#/components/schemas/CustomerId'
consumerId:
$ref: '#/components/schemas/ConsumerId'
redirectUri:
# If this parameter isn't specified, then a "thank you" screen
# appears and the customer ends Connect.
$ref: '#/components/schemas/RedirectUri'
webhook:
$ref: '#/components/schemas/Webhook'
webhookContentType:
$ref: '#/components/schemas/WebhookContentType'
webhookData:
$ref: '#/components/schemas/WebhookData'
webhookHeaders:
$ref: '#/components/schemas/WebhookHeaders'
institutionSettings:
$ref: '#/components/schemas/InstitutionSettings'
email:
$ref: '#/components/schemas/EmailOptions'
experience:
$ref: '#/components/schemas/Experience'
singleUseUrl:
$ref: '#/components/schemas/SingleUseUrl'
fromDate:
$ref: '#/components/schemas/ConnectFromDate'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
optionalConsumerInfo:
$ref: '#/components/schemas/ConsumerInfo'
ConnectJointBorrowerParameters:
required:
- partnerId
- borrowers
type: object
properties:
language:
$ref: '#/components/schemas/ConnectLanguage'
partnerId:
$ref: '#/components/schemas/PartnerId'
borrowers:
$ref: '#/components/schemas/Borrowers'
redirectUri:
$ref: '#/components/schemas/RedirectUri'
webhook:
$ref: '#/components/schemas/Webhook'
webhookContentType:
$ref: '#/components/schemas/WebhookContentType'
webhookData:
$ref: '#/components/schemas/WebhookData'
webhookHeaders:
$ref: '#/components/schemas/WebhookHeaders'
institutionSettings:
$ref: '#/components/schemas/InstitutionSettings'
experience:
$ref: '#/components/schemas/Experience'
fromDate:
$ref: '#/components/schemas/ConnectFromDate'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
singleUseUrl:
$ref: '#/components/schemas/SingleUseUrl'
ConnectJointBorrowerEmailParameters:
required:
- partnerId
- borrowers
- email
- experience
type: object
properties:
language:
$ref: '#/components/schemas/ConnectLanguage'
partnerId:
$ref: '#/components/schemas/PartnerId'
borrowers:
$ref: '#/components/schemas/Borrowers'
redirectUri:
$ref: '#/components/schemas/RedirectUri'
webhook:
$ref: '#/components/schemas/Webhook'
webhookContentType:
$ref: '#/components/schemas/WebhookContentType'
webhookData:
$ref: '#/components/schemas/WebhookData'
webhookHeaders:
$ref: '#/components/schemas/WebhookHeaders'
institutionSettings:
$ref: '#/components/schemas/InstitutionSettings'
email:
$ref: '#/components/schemas/EmailOptions'
experience:
$ref: '#/components/schemas/Experience'
fromDate:
$ref: '#/components/schemas/ConnectFromDate'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
singleUseUrl:
$ref: '#/components/schemas/SingleUseUrl'
Borrowers:
type: array
items:
$ref: '#/components/schemas/Borrower'
description: >-
(MVS) Array of borrowers to pass the primary and joint borrower's
customer and consumer IDs
Borrower:
required:
- customerId
- consumerId
- type
type: object
properties:
customerId:
$ref: '#/components/schemas/CustomerId'
consumerId:
$ref: '#/components/schemas/ConsumerId'
type:
$ref: '#/components/schemas/BorrowerType'
optionalConsumerInfo:
$ref: '#/components/schemas/ConsumerInfo'
BorrowerType:
description: '"primary" or "jointBorrower"'
type: string
example: primary
ConsumerInfo:
description: The SSN and date of birth of a consumer
required:
- ssn
type: object
properties:
ssn:
$ref: '#/components/schemas/SocialSecurityNumberNoHyphens'
dob:
$ref: '#/components/schemas/ConsumerDateOfBirth'
SocialSecurityNumberNoHyphens:
type: string
description: A full SSN without hyphens
example: '999999999'
SocialSecurityNumber:
type: string
description: A full SSN with or without hyphens
example: '999-99-9999'
SocialSecurityNumberLastDigits:
type: string
description: Last 4 digits of a SSN
example: '9999'
EmailAddress:
type: string
description: An email address
example: finicity@test.com
ConsumerDateOfBirth:
# Note: DOB's prior to 1970 result in a negative timestamp; this is acceptable. Note: All other timestamps in Decisioning are in MST.
$ref: '#/components/schemas/UnixDate'
RedirectUri:
type: string
description: >-
The URL that customers will be redirected to after completing Finicity
Connect. Required unless Connect is embedded inside our application
(iframe).
example: 'https://www.finicity.com/connect/'
Webhook:
type: string
description: >-
The publicly available URL you want to be notified with events as the
user progresses through the application. See [Connect Webhook
Event](https://docs.finicity.com/connect-and-mvs-webhooks/) for event
details.
example: 'https://webhook.site/8d4421a7-d1d1-4f01-bb08-5370aff0321b'
WebhookContentType:
type: string
description: >-
The content type the webhook events will be sent in. Supported types:
"application/json" and "application/xml".
default: application/json
example: application/json
WebhookData:
type: object
description: >-
Allows additional identifiable information to be inserted into the
payload of connect webhook events. See: [Custom
Webhooks](https://docs.finicity.com/custom-webhooks/).
WebhookHeaders:
type: object
description: >-
Allows additional identifiable information to be included as headers of
connect webhook event. See: [Custom
Webhooks](https://docs.finicity.com/custom-webhooks/).
Experience:
type: string
description: >-
The `experience` field allows you to customize:
* Brand: color and logo
* Icon: displayed on the "Share your data" page
* Popular institutions: displayed on the Bank Search page
* Report: the credit decisioning report to send when Connect completes.
* MVS modules: financial, payroll, paystub
Note: the Finicity sales engineers (SE) help you set up a default
experience for your company when you migrate to Connect 2.0. For each
additional experience you create thereafter, they'll give you a unique
ID. See [Generate 2.0 Connect URL
APIs](https://docs.finicity.com/migrate-to-connect-web-sdk-2-0/#migrate-connect-web-sdk-1).
Experience values options:
* "default": your default experience (must be defined)
* GUID: the code for a different experience
* Not defined: If you don't pass the experience parameter, then
Connect's out of the box default experience (add accounts but no
branding) is used, and the MVS modules will not run.
example: 'default'
SingleUseUrl:
type: boolean
description: >-
"true": The URL link expires after a Connect session successfully
completes.
Note: when the `singleUseUrl` and the `experience` parameters are passed
in the same call, the `singleUseUrl` value overrides the `singleUseUrl`
value configured in the `experience` parameter.
example: true
VOAReportConstraints:
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIdsString'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
showNsf:
$ref: '#/components/schemas/ShowNsf'
fromDate:
# Limits the transaction history in the financial reports. Transactions are included if they are equal to or greater than the `fromDate`
$ref: '#/components/schemas/UnixDate'
VOAReportConstraintsOut:
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIds'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
showNsf:
$ref: '#/components/schemas/ShowNsf'
fromDate:
# Limits the transaction history in the financial reports. Transactions are included if they are equal to or greater than the `fromDate`
$ref: '#/components/schemas/UnixDate'
VOAWithIncomeReportConstraints:
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIdsString'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
showNsf:
$ref: '#/components/schemas/ShowNsf'
fromDate:
# Limits the transaction history in the financial reports. Transactions are included if they are equal to or greater than the `fromDate`
$ref: '#/components/schemas/UnixDate'
incomeStreamConfidenceMinimum:
$ref: '#/components/schemas/IncomeStreamConfidenceMinimum'
VOAWithIncomeReportConstraintsOut:
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIds'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
showNsf:
$ref: '#/components/schemas/ShowNsf'
fromDate:
# Limits the transaction history in the financial reports. Transactions are included if they are equal to or greater than the `fromDate`
$ref: '#/components/schemas/UnixDate'
incomeStreamConfidenceMinimum:
$ref: '#/components/schemas/IncomeStreamConfidenceMinimum'
PrequalificationReportConstraints:
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIdsString'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
showNsf:
$ref: '#/components/schemas/ShowNsf'
fromDate:
# Limits the transaction history in the financial reports. Transactions are included if they are equal to or greater than the `fromDate`
$ref: '#/components/schemas/UnixDate'
PrequalificationReportConstraintsOut:
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIds'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
showNsf:
$ref: '#/components/schemas/ShowNsf'
fromDate:
# Limits the transaction history in the financial reports. Transactions are included if they are equal to or greater than the `fromDate`
$ref: '#/components/schemas/UnixDate'
VOIReportConstraints:
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIdsString'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
fromDate:
# Limits the transaction history in the financial reports. Transactions are included if they are equal to or greater than the `fromDate`
$ref: '#/components/schemas/UnixDate'
incomeStreamConfidenceMinimum:
$ref: '#/components/schemas/IncomeStreamConfidenceMinimum'
VOIReportConstraintsOut:
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIds'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
fromDate:
# Limits the transaction history in the financial reports. Transactions are included if they are equal to or greater than the `fromDate`
$ref: '#/components/schemas/UnixDate'
incomeStreamConfidenceMinimum:
$ref: '#/components/schemas/IncomeStreamConfidenceMinimum'
ReportCustomField:
type: object
properties:
label:
type: string
description: The name of the custom field
example: 'loanID'
value:
type: string
description: The value of the custom field
example: '123456'
shown:
type: boolean
description: If the custom field will show on the PDF or not
example: true
ReportCustomFields:
type: array
items:
$ref: '#/components/schemas/ReportCustomField'
description: >-
The `reportCustomFields` parameter is used when experiences are
associated with a credit decisioning report.
Designate up to 5 custom fields that you'd like associated with the
report when it's generated. Every custom field consists of three
variables: `label`, `value`, and `shown`. The `shown` variable is "true"
or "false".
* "true": (default) display the custom field in the PDF report
* "false": don't display the custom field in the PDF report
For an experience that generates multiple reports, the
`reportCustomFields` parameter gets passed to all reports.
All custom fields display in the Reseller Billing API.
IncomeStreamConfidenceMinimum:
type: integer
description:
"Include income streams in the report, based on the income stream's
confidence score. For example, Use the value 50 to include only income
streams with a confidence score of 50 or higher."
format: int32
example: 50
ConnectFromDate:
type: integer
description: >-
The `fromDate` parameter is used when experiences are associated with a
credit decisioning report and any other reports with transaction data.
The value is in epoch time and must be 10 digits. Example: 1494449017.
If it's greater than 10 digits, then the `fromDate` is set to the credit
decisioning report's default `fromDate`.
For an experience that generates multiple reports, the `fromDate` gets
passed to the reports that support it.
However, Connect doesn't pass this parameter to the following reports:
* Pay Statement Extraction Report
* VOIE - Paystub (with TXVerify) Report
* Statement Report
* Verification of Income Report
* VOIE - Payroll Report
Note: this field isn't used if you're only collecting transaction data
without a report.
format: int64
example: 1607450357
InstitutionSettings:
type: object
description: >-
Advanced options for configuration of which institutions to display in.
See [Institution
Settings](https://docs.finicity.com/connect-institution-settings/).
ConnectUrl:
description: A Connect URL object
required:
- link
type: object
properties:
link:
$ref: '#/components/schemas/ConnectLink'
ConnectEmailUrl:
required:
- link
- emailConfig
type: object
properties:
link:
$ref: '#/components/schemas/ConnectLink'
emailConfig:
$ref: '#/components/schemas/EmailOptions'
ConnectLink:
type: string
description: A generated Connect URL
example: 'https://connect2.finicity.com?customerId=5025024821&institutionId=102105&origin=url&partnerId=2445583925753&signature=b5667164db7a9a0007b59267785c996ca3bc9ce97f2e72c98099cead76edfad9×tamp=1648050761908&ttl=1648057961908&type=lite&webhookContentType=application%2Fjson'
EmailOptions:
description: Configuration for the Connect email's sent to customers
required:
- to
type: object
properties:
to:
type: string
description:
The email address for the customer receiving the Connect email
example: alex.salido@finicity.com
from:
type: string
description:
The name of a person or business sending the Connect email
example: test.lender@test.com
supportPhone:
type: string
description: The support phone number listed in the email
example: 800-555-5555
subject:
type: string
description:
The subject line of the email. The default is "Verify your Financial
Information".
example: Verify your income
firstName:
type: string
description:
'The first name of the customer or both names of the customers for
joint borrowers. Example: "Marvin and Jenny".'
example: Bob
institutionName:
type: string
description: The name of your company
example: Acme Lending
institutionAddress:
type: string
description:
The institution address to appear in the footer of the email
example: '222 Winipeg Drive SLC UT, 84109'
signature:
type: array
items:
type: string
description: A signature for the email
example:
- Cindy Mayfield
- Senior Loan Officer
- Direct 123-456-7890
CustomerUsername:
type: string
description: >-
The customer's username, assigned by the partner (a unique identifier),
following these rules: minimum 6 characters maximum 255 characters any
mix of uppercase, lowercase, numeric, and non-alphabet special
characters ! @ . # $ % & * _ β + the use of email in this field is
discouraged it is recommended to use a unique non-email identifier. Use
of special characters may result in an error (e.g. Γ, ΓΌ, etc.).
Usernames are unique. A username used in [Test
Drive](https://signup.finicity.com/) can't be reused in other plans.
example: customerusername1
FirstName:
type: string
description: First name(s) / given name(s)
example: John
LastName:
type: string
description: Last name(s) / surname(s)
example: Smith
Address:
type: string
description: A street address
example: 434 W Ascension Way
AddressLine1:
type: string
description: An address line 1
example: 434 W Ascension Way
AddressLine2:
type: string
description: An address line 2
example: 'Suite #200'
City:
type: string
description: A city
example: Murray
State:
type: string
description: A state
example: UT
Country:
type: string
description: A country code
example: USA
ZipCode:
type: string
description: A ZIP code
example: '84123'
PhoneNumber:
type: string
description: A phone number
example: '1-800-986-3343'
Suffix:
type: string
description: A person suffix
example: Mr
ApplicationId:
type: string
description:
'`applicationId` value returned from the Get App Registration Status API
and the partner assign the customers to. This cannot be changed once
set. Only applicable in cases of partners with multiple registered
applications. If the partner only has one app, this can usually be
omitted. This field is populated after the app is in a status approved.'
example: '123456789'
PreAppId:
type: string
description:
Identifier to track the application registration from the App
Registration and Get App Registration Status APIs
example: '2581'
NumericPreAppId:
type: integer
format: int64
description:
Identifier to track the application registration from the App
Registration and Get App Registration Status APIs, represented as a
number
example: 2581
ApplicationName:
type: string
description: The name of the application assigned to the customer
example: Awesome Budget App
UnixDate:
type: integer
description:
'A date in Unix epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
ReportStartDate:
type: integer
description:
'The `postedDate` of the earliest transaction analyzed for the report. A
date in Unix epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
ReportEndDate:
type: integer
description:
'The `postedDate` of the latest transaction analyzed for the report. A
date in Unix epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
DateAsOf:
type: integer
description:
'(All Account Types) Most recent date of the following information. A
date in Unix epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
OpenDate:
type: integer
description:
'(Checking/Savings/CD/MoneyMarket) Date when account was opened. A date
in Unix epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
PeriodStartDate:
type: integer
description:
'(Checking/Savings/CD/MoneyMarket) Start date of period. A date in Unix
epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
PeriodEndDate:
type: integer
description:
'End date of period. A date in Unix epoch time (in seconds). See:
[Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
MaturityDate:
type: integer
description:
'(Checking/Savings/CD/MoneyMarket) Maturity date of account type. A date
in Unix epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
PaymentDueDate:
type: integer
description:
'(Credit Card/Line Of Credit) Due date for the next payment. A date in
Unix epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
StatementStartDate:
type: integer
description:
'(Credit Card/Line Of Credit) Start date of statement period. A date in
Unix epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
StatementEndDate:
type: integer
description:
'(Credit Card/Line Of Credit) End date of statement period. A date in
Unix epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
LastPaymentDate:
type: integer
description:
'(Credit Card/Line Of Credit) The date of the last payment. A date in
Unix epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
PayoffAmountDate:
type: integer
description:
'(Mortgage/Loan) Date of final payment. A date in Unix epoch time (in
seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
OriginalMaturityDate:
type: integer
description:
'(Mortgage/Loan) Original date of loan maturity. A date in Unix epoch
time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
InitialMlDate:
type: integer
description:
'(Mortgage/Loan) Original date of loan. A date in Unix epoch time (in
seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
NextPaymentDate:
type: integer
description:
'(Mortgage/Loan) Due date for the next payment. A date in Unix epoch
time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
LastPaymentDueDate:
type: integer
description:
'(Mortgage/Loan) Due date of last payment. A date in Unix epoch time (in
seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
LastPaymentReceiveDate:
type: integer
description:
'(Mortgage/Loan) The date of the last payment. A date in Unix epoch time
(in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
FirstPaymentDate:
type: integer
description:
'(Mortgage/Loan) First payment due date. A date in Unix epoch time (in
seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
LoanStatusStartDate:
type: integer
description:
'(Student Loan) The start date of the current status. A date in Unix
epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
LoanStatusEndDate:
type: integer
description:
'(Student Loan) The end date of the current status. A date in Unix epoch
time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
RepaymentPlanStartDate:
type: integer
description:
'(Student Loan) The start date of the current repayment plan. A date in
Unix epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
RepaymentPlanEndDate:
type: integer
description:
'(Student Loan) The end date of the current repayment plan. A date in
Unix epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
ExpectedPayoffDate:
type: integer
description:
'(Student Loan) The expected date of the payoff date. A date in Unix
epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
OutOfSchoolDate:
type: integer
description:
'(Student Loan) The date the borrower graduated or dropped below
half-time enrollment in school. A date in Unix epoch time (in seconds).
See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
ConvertToRepayment:
type: integer
description:
'(Student Loan) The date the loan enters into repayment. A date in Unix
epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
TransactionPostedDate:
type: integer
description:
"A date in Unix epoch time (in seconds). Represents the timestamp of the
transaction when it was posted or cleared by the institution. This value
isn't required for student loan transaction data. See: [Handling Epoch
Dates and Times](https://docs.finicity.com/endpoint-syntax-and-format/)."
format: int64
example: 1607450357
TransactionCreatedDate:
type: integer
description:
'A date in Unix epoch time (in seconds). Represents the timestamp of the
transaction when it was added to our platform. See: [Handling Epoch
Dates and Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
TransactionFirstEffectiveDate:
type: integer
description:
'A date in Unix epoch time (in seconds). Represents the first timestamp
of the transaction recorded in the `effectiveDate` field. See: [Handling
Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
TransactionEffectiveDate:
type: integer
description:
'A date in Unix epoch time (in seconds). Represents the timestamp of the
transaction when it became effective on an account by an institution.
See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: 1607450357
StringUnixDate:
type: string
description:
'A date in Unix epoch time (in seconds). See: [Handling Epoch Dates and
Times](https://docs.finicity.com/endpoint-syntax-and-format/).'
format: int64
example: '1607450357'
NoZoneDateTime:
type: string
description: A date-time without time zone
example: '2022-04-12T11:51:23'
Date:
type: string
format: date
description:
A 'YYYY-MM-DD' date notation as defined by [RFC 3339, section
5.6](https://www.rfc-editor.org/rfc/rfc3339#section-5.6)
example: '2022-04-12'
AnalyticId:
type: string
description: An ID for a Consumer Attributes report
example: CA-5dfbaa3ac-5321
MoreResultsAvailable:
type: boolean
description:
'If the value of `moreAvailable` is "true", you can retrieve the next
page of results by increasing the value of the start parameter in your
next request:"...&start=6&limit=5"'
example: true
DisplayingResults:
type: integer
description: The number of results returned
example: 2
FoundResults:
type: integer
description: The total number of results matching search criteria
example: 200
Currency:
type: string
description: A currency code
example: 'USD'
CustomerType:
type: string
description:
The type of customer ("active" or "testing" or "" for all types)
example: active
NewCustomer:
description: A new customer to be enrolled
required:
- username
type: object
properties:
username:
$ref: '#/components/schemas/CustomerUsername'
firstName:
$ref: '#/components/schemas/FirstName'
lastName:
$ref: '#/components/schemas/LastName'
applicationId:
$ref: '#/components/schemas/ApplicationId'
CustomerUpdate:
description: Represent an update to customer fields
type: object
properties:
firstName:
$ref: '#/components/schemas/FirstName'
lastName:
$ref: '#/components/schemas/LastName'
CreatedCustomer:
description: A new customer that was just enrolled
required:
- id
- username
- createdDate
type: object
properties:
id:
$ref: '#/components/schemas/CustomerId'
username:
$ref: '#/components/schemas/CustomerUsername'
createdDate:
$ref: '#/components/schemas/UnixDate'
Customer:
description: A finicity customer record
required:
- id
- username
- type
- createdDate
type: object
properties:
id:
$ref: '#/components/schemas/CustomerId'
username:
$ref: '#/components/schemas/CustomerUsername'
firstName:
$ref: '#/components/schemas/FirstName'
lastName:
$ref: '#/components/schemas/LastName'
type:
$ref: '#/components/schemas/CustomerType'
createdDate:
$ref: '#/components/schemas/StringUnixDate'
lastModifiedDate:
$ref: '#/components/schemas/StringUnixDate'
CustomerWithAppData:
description: A finicity customer record with application info
required:
- id
- username
- firstName
- lastName
- type
- createdDate
- applicationId
- applicationName
allOf:
- $ref: '#/components/schemas/Customer'
- type: object
properties:
applicationId:
$ref: '#/components/schemas/ApplicationId'
applicationName:
$ref: '#/components/schemas/ApplicationName'
Customers:
description: A list of customers
required:
- found
- displaying
- moreAvailable
- customers
type: object
properties:
found:
$ref: '#/components/schemas/FoundResults'
displaying:
$ref: '#/components/schemas/DisplayingResults'
moreAvailable:
$ref: '#/components/schemas/MoreResultsAvailable'
customers:
type: array
items:
$ref: '#/components/schemas/Customer'
description: A list of customer records
NewConsumer:
description: A new consumer to be created
required:
- firstName
- lastName
- address
- city
- state
- zip
- phone
- ssn
- birthday
type: object
properties:
firstName:
$ref: '#/components/schemas/FirstName'
lastName:
$ref: '#/components/schemas/LastName'
address:
$ref: '#/components/schemas/Address'
city:
$ref: '#/components/schemas/City'
state:
$ref: '#/components/schemas/State'
zip:
$ref: '#/components/schemas/ZipCode'
phone:
$ref: '#/components/schemas/PhoneNumber'
ssn:
$ref: '#/components/schemas/SocialSecurityNumber'
birthday:
$ref: '#/components/schemas/Birthday'
email:
$ref: '#/components/schemas/EmailAddress'
suffix:
$ref: '#/components/schemas/Suffix'
ConsumerUpdate:
type: object
properties:
firstName:
$ref: '#/components/schemas/FirstName'
lastName:
$ref: '#/components/schemas/LastName'
address:
$ref: '#/components/schemas/Address'
city:
$ref: '#/components/schemas/City'
state:
$ref: '#/components/schemas/State'
zip:
$ref: '#/components/schemas/ZipCode'
phone:
$ref: '#/components/schemas/PhoneNumber'
ssn:
$ref: '#/components/schemas/SocialSecurityNumber'
birthday:
$ref: '#/components/schemas/Birthday'
email:
$ref: '#/components/schemas/EmailAddress'
suffix:
$ref: '#/components/schemas/Suffix'
CreatedConsumer:
description: A consumer that was just created
type: object
properties:
id:
$ref: '#/components/schemas/ConsumerId'
createdDate:
$ref: '#/components/schemas/UnixDate'
customerId:
$ref: '#/components/schemas/NumericCustomerId'
Consumer:
description: A finicity consumer record
required:
- id
- firstName
- lastName
- customerId
- address
- city
- state
- zip
- phone
- ssn
- birthday
- email
- createdDate
type: object
properties:
id:
$ref: '#/components/schemas/ConsumerId'
firstName:
$ref: '#/components/schemas/FirstName'
lastName:
$ref: '#/components/schemas/LastName'
customerId:
$ref: '#/components/schemas/NumericCustomerId'
address:
$ref: '#/components/schemas/Address'
city:
$ref: '#/components/schemas/City'
state:
$ref: '#/components/schemas/State'
zip:
$ref: '#/components/schemas/ZipCode'
phone:
$ref: '#/components/schemas/PhoneNumber'
ssn:
$ref: '#/components/schemas/SocialSecurityNumberLastDigits'
birthday:
$ref: '#/components/schemas/Birthday'
email:
$ref: '#/components/schemas/EmailAddress'
createdDate:
$ref: '#/components/schemas/UnixDate'
suffix:
$ref: '#/components/schemas/Suffix'
AccountOwner:
required:
- ownerName
- ownerAddress
type: object
properties:
ownerName:
type: string
description:
The name of the account owner. Can be multiple account owners in one
string. This is how the source data is returned from the
institution.
example: John Smith
ownerAddress:
$ref: '#/components/schemas/Address'
asOfDate:
$ref: '#/components/schemas/UnixDate'
description: Owner of a customer account
CustomerAccounts:
description: A list of customer accounts
required:
- accounts
type: object
properties:
accounts:
type: array
items:
$ref: '#/components/schemas/CustomerAccount'
description: List of customer accounts
CustomerAccount:
description:
An account represents a bank account such as a checking or savings that
the customer has added via the Connect interface.
required:
- id
- accountNumberDisplay
- name
- balance
- type
- status
- customerId
- institutionId
- balanceDate
- createdDate
- currency
- oldestTransactionDate
- institutionLoginId
- displayPosition
type: object
properties:
id:
$ref: '#/components/schemas/AccountId'
number:
type: string
deprecated: true
description: >-
Use the `accountNumberDisplay` field. Starting July 1, 2021 the
`number` field will sunset with limited support until April 1, 2022,
at which time it will be deprecated (no longer available).
example: '2000004444'
accountNumberDisplay:
type: string
description: >-
The account number from a financial institution in truncated format:
* Last four digits: "1234"
* Last four digits with suffix: "1234-9"
* Full value for string accounts: "john@gmail.com"
example: '1234-9'
realAccountNumberLast4:
$ref: '#/components/schemas/AccountNumberLast4'
name:
type: string
description: The account name from the institution
example: Super Checking
balance:
type: number
description: The cleared balance of the account as of `balanceDate`
example: 401.26
type:
$ref: '#/components/schemas/AccountType'
aggregationStatusCode:
$ref: '#/components/schemas/AggregationStatusCode'
status:
type: string
description: >-
"pending" during account discovery, always "active" following
successful account activation
example: active
customerId:
$ref: '#/components/schemas/CustomerId'
institutionId:
$ref: '#/components/schemas/InstitutionId'
balanceDate:
# A timestamp showing when the balance was captured
$ref: '#/components/schemas/UnixDate'
aggregationSuccessDate:
# A timestamp showing the last successful aggregation of the account.
# This will not be present until you have run your first aggregation for the account.
$ref: '#/components/schemas/UnixDate'
aggregationAttemptDate:
# A timestamp showing the last aggregation attempt
# This will not be present until you have run your first aggregation for the account.
$ref: '#/components/schemas/UnixDate'
createdDate:
$ref: '#/components/schemas/UnixDate'
currency:
$ref: '#/components/schemas/Currency'
lastTransactionDate:
# The date of the latest transaction on the account.
# This will not be present until you have run your first aggregation for the account.
$ref: '#/components/schemas/UnixDate'
oldestTransactionDate:
# The date of the oldest transaction in the transactions for the account.
$ref: '#/components/schemas/UnixDate'
institutionLoginId:
$ref: '#/components/schemas/NumericInstitutionLoginId'
detail:
$ref: '#/components/schemas/CustomerAccountDetail'
position:
type: array
items:
$ref: '#/components/schemas/CustomerAccountPosition'
description: Investment holdings
displayPosition:
type: integer
description: >-
Display position of the account at the financial institution, "1"
being the top listed account
format: int32
example: 2
parentAccount:
# The assigned `accountId` for the account one level higher in the student loan account hierarchy.
$ref: '#/components/schemas/AccountId'
CustomerAccountPosition:
description: Details for investment account holdings
type: object
properties:
id:
type: integer
description: The id of the investment position
format: int64
example: 454678080
description:
type: string
description: The description of the holding
example: 'DELTA AIR LINES INC'
symbol:
type: string
description: The investment position's market ticker symbol
example: DAL
units:
type: number
description: The number of units of the holding
example: 6.537
currentPrice:
type: number
description: The current price of the investment holding
example: 41.585
securityName:
type: string
description: The security name for the investment holding
example: DELTA AIR LINES INC
transactionType:
type: string
description:
'The transaction type of the holding, such as cash, margin, and more'
example: Margin
marketValue:
type: number
description:
Market value of an investment position at the time of retrieval
example: 271.84
costBasis:
type: number
description: The total cost of acquiring the security
example: 190.01
status:
type: string
description: The status of the holding
example: A
currentPriceDate:
# The latest date the price date was updated
$ref: '#/components/schemas/UnixDate'
securityType:
type: string
description: Type of security for the investment position
example: Stock
mfType:
type: string
description: 'Type of mutual fund, such as open ended'
example: OPENEND
posType:
type: string
description: 'Fund type assigned by the FI (long or short)'
example: Long
totalGLDollar:
type: number
description:
'Total gain and loss of the position at the time of aggregation in
dollars'
example: 162742.9
totalGLPercent:
type: number
description:
'Total gain and loss of the position at the time of aggregation in
percentage'
example: 68.89
optionStrikePrice:
type: number
description: The strike price of the option contract
example: 50
optionType:
type: string
description: The type of option contract (PUT or CALL)
example: PUT
optionSharesPerContract:
type: number
description: The number of shares per option contract
example: 100
optionExpireDate:
type: string
description: Expiration date of option
format: date
example: '1644994800'
fiAssetClass:
type: string
description:
Financial Institution (FI) defined asset class (COMMON STOCK,
COMNEQTY, EQUITY/STOCK, CMA-ISA, CONVERTIBLE PREFERREDS, CORPORATE
BONDS, OTHER MONEY FUNDS, ALLOCATION FUNDS, CMA-TAXABLE,
FOREIGNEQUITYADRS, COMMONSTOCK, PREFERRED STOCKS, STABLE VALUE,
FOREIGN EQUITY ADRS)
example: COMNEQTY
assetClass:
type: string
description:
An asset class is a grouping of comparable financial securities.
These include equities (stocks), fixed income (bonds), and cash
equivalent or money market instruments. (DOMESTICBOND, LARGESTOCK,
INTLSTOCK, MONEYMRKT, OTHER)
example: INTLSTOCK
currencyRate:
type: number
description: Currency rate, ratio of currency to original currency
example: 1
securityId:
type: string
description: The security ID of the transaction
example: 25400W102
securityIdType:
$ref: '#/components/schemas/SecurityIdType'
costBasisPerShare:
type: number
description: The per share cost of acquiring the security
example: 13.38
subAccountType:
type: string
description: The subaccount's type, such as cash
example: CASH
securityCurrency:
type: string
description:
Symbol for the currency that the account is being converted into
example: USD
todayGLDollar:
type: number
description:
The current day's gain and loss of the position at the time of
aggregation in dollars
example: 16272.9
todayGLPercent:
type: number
description:
The current day's gain and loss of the position at the time of
aggregation in percentage
example: 18.89
CustomerAccountDetail:
description: >-
Additional customer account details. Not all data points will return for
each account type. You can see the account type that each data point
will return for in descriptions. The data point are also subject to
availability by the institution.
required:
- availableBalanceAmount
type: object
properties:
dateAsOf:
$ref: '#/components/schemas/DateAsOf'
availableBalanceAmount:
type: number
description: >-
(Checking/Savings/CD/MoneyMarket) and (Mortgage/Loan) The available
balance (typically the current balance with adjustments for any
pending transactions)
example: 5678.78
openDate:
$ref: '#/components/schemas/OpenDate'
periodStartDate:
$ref: '#/components/schemas/PeriodStartDate'
periodEndDate:
$ref: '#/components/schemas/PeriodEndDate'
periodInterestRate:
type: number
description: >-
(Checking/Savings/CD/MoneyMarket) The APY for the current period
interest rate
example: 13.245
periodDepositAmount:
type: number
description:
(Checking/Savings/CD/MoneyMarket) Amount deposited in period
example: 2356.56
periodInterestAmount:
type: number
description: >-
(Checking/Savings/CD/MoneyMarket) Interest accrued during the
current period
example: 1234.56
interestYtdAmount:
type: number
description:
(Checking/Savings/CD/MoneyMarket) Interest accrued year-to-date
example: 1056.67
interestPriorYtdAmount:
type: number
description:
(Checking/Savings/CD/MoneyMarket) Interest earned in prior year
example: 3056.79
maturityDate:
$ref: '#/components/schemas/MaturityDate'
interestRate:
type: string
description: >-
(Credit Card/Line Of Credit) and (Mortgage/Loan) The account's
current interest rate
example: '15.789'
creditAvailableAmount:
type: number
description: >-
(Credit Card/Line Of Credit) The available credit (typically the
credit limit minus the current balance)
example: 3000
creditMaxAmount:
type: number
description: (Credit Card/Line Of Credit) The account's credit limit
example: 7000
cashAdvanceAvailableAmount:
type: number
description:
(Credit Card/Line Of Credit) Currently available cash advance
example: 2000
cashAdvanceMaxAmount:
type: number
description: (Credit Card/Line Of Credit) Maximum cash advance amount
example: 3000
cashAdvanceBalance:
type: number
description:
(Credit Card/Line Of Credit) Balance of current cash advance
example: 1000
cashAdvanceInterestRate:
type: number
description:
(Credit Card/Line Of Credit) Interest rate for cash advances
example: 21.5
currentBalance:
type: number
description:
(Credit Card/Line Of Credit) and (Investment) Current balance
example: 5789.34
paymentMinAmount:
type: number
description:
(Credit Card/Line Of Credit) and (Mortgage/Loan) Minimum payment due
example: 456.78
paymentDueDate:
$ref: '#/components/schemas/PaymentDueDate'
previousBalance:
type: number
description:
(Credit Card/Line Of Credit) Prior balance in last statement
example: 1234.56
statementStartDate:
$ref: '#/components/schemas/StatementStartDate'
statementEndDate:
$ref: '#/components/schemas/StatementEndDate'
statementPurchaseAmount:
type: number
description:
(Credit Card/Line Of Credit) Purchase amount of statement period
example: 2345.9
statementFinanceAmount:
type: number
description:
(Credit Card/Line Of Credit) Finance amount of statement period
example: 156.78
statementCreditAmount:
type: number
description: >-
(Credit Card/Line Of Credit) Credit amount applied in statement
period
example: 345
rewardEarnedBalance:
type: integer
description: (Credit Card/Line Of Credit) Earned reward balance
format: int32
example: 500
pastDueAmount:
type: number
description: (Credit Card/Line Of Credit) Balance past due
example: 3688.99
lastPaymentAmount:
type: number
description: >-
(Credit Card/Line Of Credit) and (Mortgage/Loan) The amount received
in the last payment
example: 567.89
lastPaymentDate:
$ref: '#/components/schemas/LastPaymentDate'
statementCloseBalance:
type: number
description:
(Credit Card/Line Of Credit) Balance of statement at close
example: 2456.69
termOfMl:
type: string
description: (Mortgage/Loan) Length of loan in months
example: '36'
mlHolderName:
type: string
description: (Mortgage/Loan) Holder of the mortgage or loan
example: John Smith
description:
type: string
description: (Mortgage/Loan) Description of loan
example: a description
lateFeeAmount:
type: number
description: (Mortgage/Loan) Late fee charged
example: 35
payoffAmount:
type: number
description: (Mortgage/Loan) The amount required to payoff the loan
example: 45567.98
payoffAmountDate:
$ref: '#/components/schemas/PayoffAmountDate'
originalMaturityDate:
$ref: '#/components/schemas/OriginalMaturityDate'
principalBalance:
type: number
description: (Mortgage/Loan) The principal balance
example: 45056.7
escrowBalance:
type: number
description: (Mortgage/Loan) The escrow balance
example: 2345.01
interestPeriod:
type: string
description: (Mortgage/Loan) Period of interest
example: monthly
initialMlAmount:
type: number
description: (Mortgage/Loan) Original loan amount
example: 65000
initialMlDate:
$ref: '#/components/schemas/InitialMlDate'
nextPaymentPrincipalAmount:
type: number
description: (Mortgage/Loan) Amount towards principal in next payment
example: 1256.67
nextPaymentInterestAmount:
type: number
description: (Mortgage/Loan) Amount of interest in next payment
example: 234.56
nextPayment:
type: number
description: (Mortgage/Loan) Minimum payment due
example: 1578
nextPaymentDate:
$ref: '#/components/schemas/NextPaymentDate'
lastPaymentDueDate:
$ref: '#/components/schemas/LastPaymentDueDate'
lastPaymentReceiveDate:
$ref: '#/components/schemas/LastPaymentReceiveDate'
lastPaymentPrincipalAmount:
type: number
description: (Mortgage/Loan) Amount towards principal in last payment
example: 1256.67
lastPaymentInterestAmount:
type: number
description: (Mortgage/Loan) Amount of interest in last payment
example: 234.56
lastPaymentEscrowAmount:
type: number
description: (Mortgage/Loan) Amount towards escrow in last payment
example: 456.78
lastPaymentLastFeeAmount:
type: number
description: (Mortgage/Loan) Amount of last fee in last payment
example: 150
lastPaymentLateCharge:
type: number
description: (Mortgage/Loan) Amount of late charge in last payment
example: 50
ytdPrincipalPaid:
type: number
description: (Mortgage/Loan) Principal paid year-to-date
example: 5432.01
ytdInterestPaid:
type: number
description: (Mortgage/Loan) Interest paid year-to-date
example: 3948.56
ytdInsurancePaid:
type: number
description: (Mortgage/Loan) Insurance paid year-to-date
example: 1345.89
ytdTaxPaid:
type: number
description: (Mortgage/Loan) Tax paid year-to-date
example: 1489
autoPayEnrolled:
type: boolean
description: (Mortgage/Loan) Enrolled in autopay (F/Y)
example: true
collateral:
type: string
description: (Mortgage/Loan) Collateral on loan
example: nissan sentra
currentSchool:
type: string
description: (Mortgage/Loan) Current school
example: utah valley university
firstPaymentDate:
$ref: '#/components/schemas/FirstPaymentDate'
firstMortgage:
type: boolean
description: (Mortgage/Loan) First mortgage (F/Y)
example: true
loanPaymentFreq:
type: string
description: '(Mortgage/Loan) Frequency of payments (monthly, etc.)'
example: monthly
originalSchool:
type: string
description: (Mortgage/Loan) Original school
example: brigham young university
recurringPaymentAmount:
type: number
description: (Mortgage/Loan) Recurring payment amount
example: 456.23
lender:
type: string
description: (Mortgage/Loan) Owner of loan
example: utah community credit union
endingBalanceAmount:
type: number
description: (Mortgage/Loan) Ending balance
example: 234789.45
loanTermType:
type: string
description: (Mortgage/Loan) Type of loan term
example: fixed
paymentsMade:
type: integer
description: (Mortgage/Loan) Number of payments made
format: int32
example: 14
balloonAmount:
type: number
description: (Mortgage/Loan) Balloon payment amount
example: 1678.56
projectedInterest:
type: number
description: (Mortgage/Loan) Projected interest on the loan
example: 10456.78
interestPaidLtd:
type: number
description:
(Mortgage/Loan) Interest paid since inception of loan (life to date)
example: 56789.34
interestRateType:
type: string
description: (Mortgage/Loan) Type of interest rate
example: variable
loanPaymentType:
type: string
description: (Mortgage/Loan) Type of loan payment
example: principle
repaymentPlan:
type: string
description:
(Mortgage/Loan) Type of repayment plan for the student loan
example: 'Standard, Graduated, Extended, Pay As You Earn, and more.'
paymentsRemaining:
type: integer
description:
(Mortgage/Loan) Number of payments remaining before loan is paid off
format: int32
example: 45
marginBalance:
type: number
description:
(Investment) Net interest earned after deducting interest paid out
example: 456
shortBalance:
type: number
description: (Investment) Sum of short balance
example: 12456.89
availableCashBalance:
type: number
description: (Investment) Amount available for cash withdrawal
example: 3456.78
maturityValueAmount:
type: number
description: (Investment) amount payable to an investor at maturity
example: 34067.78
vestedBalance:
type: number
description: (Investment) Vested amount in account
example: 45000
empMatchAmount:
type: number
description: (Investment) Employer matched contributions
example: 256.99
empPretaxContribAmount:
type: number
description: (Investment) Employer pretax contribution amount
example: 450
empPretaxContribAmountYtd:
type: number
description:
(Investment) Employer pretax contribution amount year to date
example: 700
contribTotalYtd:
type: number
description: (Investment) Total year to date contributions
example: 2045
cashBalanceAmount:
type: number
description: (Investment) Cash balance of account
example: 2000
preTaxAmount:
type: number
description: (Investment) Pre tax amount of total balance
example: 78564.99
afterTaxAmount:
type: number
description: (Investment) Post tax amount of total balance
example: 68564.99
matchAmount:
type: number
description: (Investment) Amount matched
example: 378
profitSharingAmount:
type: number
description: (Investment) Amount of balance for profit sharing
example: 34678.89
rolloverAmount:
type: number
description: >-
(Investment) Amount of balance rolled over from original account
(401k, etc.)
example: 101234.67
otherVestAmount:
type: number
description: (Investment) Other vested amount
example: 34000
otherNonvestAmount:
type: number
description: (Investment) Other nonvested amount
example: 26000
currentLoanBalance:
type: number
description: (Investment) Current loan balance
example: 345789.23
loanRate:
type: number
description: (Investment) Interest rate of loan
example: 3.275
buyPower:
type: number
description: (Investment) Money available to buy securities
example: 34567.89
rolloverLtd:
type: number
description: (Investment) Life to date of money rolled over
example: 23456.78
loanAwardId:
type: string
description: (Student Loan) The federal unique loan identifying number
example: '1234568'
originalInterestRate:
type: number
description: >-
(Student Loan) The original interest rate to which the loan was
disbursed, in APY
example: 12
guarantor:
type: string
description: >-
(Student Loan) The financial institution guarantor of the loan (who
will pay the loan amount to the owner if the borrower defaults)
example: 'FinBank'
owner:
type: string
description: >-
(Student Loan) Owner of the loan
example: 'FinBank'
interestSubsidyType:
type: string
description: >-
(Student Loan) The indication of the presence of an interest subsidy
(i.e. subsidized)
example: Subsidy type
interestBalance:
type: number
description: (Student Loan) The total outstanding interest balance
example: 2000
remainingTermOfMl:
type: number
description:
(Student Loan) The number of months still outstanding on a loan
example: 2
initialInterestRate:
type: number
description: >-
(Student Loan) Initial interest rate of loan
example: 34567.89
feesBalance:
type: number
description: (Student Loan) The total outstanding fees balance
example: 150
loanYtdInterestPaid:
type: number
description: (Student Loan) Loan interest paid year-to-date
example: 5623.23
loanYtdFeesPaid:
type: number
description: (Student Loan) Loan fees paid year-to-date
example: 5621.23
loanYtdPrincipalPaid:
type: number
description: (Student Loan) Loan principal paid year-to-date
example: 5621.23
loanStatus:
type: string
description: >-
(Student Loan) The repayment status phase (i.e. In School, Grace,
Repayment, Deferment, Forbearance)
example: Deferment
loanStatusStartDate:
$ref: '#/components/schemas/LoanStatusStartDate'
loanStatusEndDate:
$ref: '#/components/schemas/LoanStatusEndDate'
weightedInterestRate:
type: number
description: >-
(Student Loan) The interest rate of multiple interest rates and
balances at the group level, in APY
example: 12
repaymentPlanStartDate:
$ref: '#/components/schemas/RepaymentPlanStartDate'
repaymentPlanEndDate:
$ref: '#/components/schemas/RepaymentPlanEndDate'
expectedPayoffDate:
$ref: '#/components/schemas/ExpectedPayoffDate'
outOfSchoolDate:
$ref: '#/components/schemas/OutOfSchoolDate'
convertToRepayment:
$ref: '#/components/schemas/ConvertToRepayment'
daysDelinquent:
type: integer
description: >-
(Student Loan) The number of days past a due date that a payment
should have been made
format: int32
example: 5
totalPrincipalPaid:
type: number
description:
(Student Loan) The total amount paid towards the principal balance
example: 15000
totalInterestPaid:
type: number
description: (Student Loan) The total amount paid towards interest
example: 1125
totalAmountPaid:
type: number
description: (Student Loan) The total amount paid
example: 16125
Application:
required:
- appDescription
- appName
- appUrl
- ownerAddressLine1
- ownerAddressLine2
- ownerCity
- ownerCountry
- ownerName
- ownerPostalCode
- ownerState
- image
type: object
properties:
appDescription:
type: string
description:
A short description of the app. This will be visible to end users in
the FI interface.
example: 'The app that makes your budgeting experience awesome'
appName:
$ref: '#/components/schemas/ApplicationName'
appUrl:
type: string
description:
An URL for the app. This will be visible to end users in the FI
interface.
example: 'https://www.finicity.com/'
ownerAddressLine1:
$ref: '#/components/schemas/AddressLine1'
ownerAddressLine2:
$ref: '#/components/schemas/AddressLine2'
ownerCity:
type: string
description: >-
City for the business entity that owns the app. Information for
registration purposes only and not given to the end user.
example: Murray
ownerCountry:
type: string
description: >-
Country for the business entity that owns the app. Information for
registration purposes only and not given to the end user.
example: USA
ownerName:
type: string
description: >-
Business name for the business entity that owns the app. Information
for registration purposes only and not given to the end user.
example: Finicity
ownerPostalCode:
type: string
description: >-
Zip code for the business entity that owns the app. Information for
registration purposes only and not given to the end user.
example: '84123'
ownerState:
type: string
description: >-
State for the business entity that owns the app. Information for
registration purposes only and not given to the end user.
example: UT
image:
type: string
description:
An app logo passed as a Base64 encoded image (1:1 SVG file, must be
less than 50KB)
example: 'PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+CjxzdmcgICAKICAgeG1sbnM6c3ZnPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIKICAgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIgogICB2ZXJzaW9uPSIxLjEiCiAgIHZpZXdCb3g9IjAgMCAwIDAiCiAgIGhlaWdodD0iMCIKICAgd2lkdGg9IjAiPgogICAgPGcvPgo8L3N2Zz4K'
RegisteredApplication:
required:
- preAppId
- status
type: object
properties:
preAppId:
$ref: '#/components/schemas/NumericPreAppId'
status:
$ref: '#/components/schemas/AppRegistrationStatus'
AppStatuses:
description:
The response for the Get App Registration Status API which returns an
array of status objects
required:
- totalRecords
- totalPages
- pageNumber
- numberOfRecordsPerPage
- applications
type: object
properties:
totalRecords:
type: integer
description: The total number of results
format: int64
example: 50
totalPages:
type: integer
description: The total number of pages
format: int64
example: 5
pageNumber:
type: integer
description: The current page number
format: int64
example: 2
numberOfRecordsPerPage:
type: integer
description: The number of results per page
format: int64
example: 10
applications:
description: A list of applications with their statuses
type: array
items:
$ref: '#/components/schemas/AppStatus'
AppRegistrationStatus:
description:
The status of an app registration request. "A" means approved. "P" means
pending which is the status when initially submitted or when the app is
modified and awaiting approval. "R" means rejected. If it is rejected
there will be a note with the rejected reason.
type: string
example: P
AppStatus:
description: Registration status details for the application
required:
- partnerId
- preAppId
- appName
- submittedDate
- modifiedDate
- status
type: object
properties:
partnerId:
$ref: '#/components/schemas/PartnerId'
preAppId:
$ref: '#/components/schemas/PreAppId'
note:
type: string
description:
A note on the registration. Typically used to indicate reasons for
rejected apps.
example: Approved
applicationId:
$ref: '#/components/schemas/ApplicationId'
appName:
$ref: '#/components/schemas/ApplicationName'
submittedDate:
$ref: '#/components/schemas/UnixDate'
modifiedDate:
$ref: '#/components/schemas/UnixDate'
status:
$ref: '#/components/schemas/AppRegistrationStatus'
scopes:
type: string
description: Indicates scopes of data accessible to the app
example: Account Info
institutionDetails:
type: array
items:
$ref: '#/components/schemas/AppFinancialInstitutionStatus'
description:
A list of the registration status for each FI for the application
AppFinancialInstitutionStatus:
description: >-
The registration status fields for each specific OAuth financial
institution
required:
- id
- decryptionKeyActivated
- createdDate
- lastModifiedDate
- status
type: object
properties:
id:
$ref: '#/components/schemas/NumericInstitutionId'
abbrvName:
type: string
description: The application's abbreviated name
example: VAEJ
logoUrl:
type: string
description: An URL to a logo file
example: >-
https://prod-direct-integration-client.s3.us-west-2.amazonaws.com/976521f99-7b36-4b3b-a3e0-faff9545836d/102224/90x90.png
decryptionKeyActivated:
type: boolean
description:
Status of decryption keys for financial institution app registration
example: false
createdDate:
$ref: '#/components/schemas/UnixDate'
lastModifiedDate:
$ref: '#/components/schemas/UnixDate'
status:
type: boolean
description: '"false" indicates registration is still pending'
example: true
Branding:
type: object
properties:
logo:
type: string
description: >-
File path of the institution's logo. For white backgrounds designed
at 375 x 72, has built in spacing around it to normalize brand
sizing.
example: >-
https://prod-carpintero-branding.s3.us-west-2.amazonaws.com/5/logo.svg
alternateLogo:
type: string
description: >-
File path of the institution's alternate logo. For colored
backgrounds designed at 375 x 72 has built in spacing around it to
normalize brand sizing.
example: >-
https://prod-carpintero-branding.s3.us-west-2.amazonaws.com/5/alternateLogo.svg
icon:
type: string
description: >-
File path of the institution's icon. For search results designed at
40 x 40.
example: >-
https://prod-carpintero-branding.s3.us-west-2.amazonaws.com/5/icon.svg
primaryColor:
type: string
description: Hex code for the institution's primary color
example: '#0167AE'
tile:
type: string
description: >-
File path of institution name logo. For popular banks designed at
160 x 72.
example: >-
https://prod-carpintero-branding.s3.us-west-2.amazonaws.com/5/tile.svg
description:
All assets are SVGs so can be slightly resized without any issues.
BrandingWrapper:
required:
- branding
type: object
properties:
branding:
$ref: '#/components/schemas/Branding'
InstitutionAddress:
type: object
description: The address of a financial institution
properties:
city:
$ref: '#/components/schemas/City'
state:
$ref: '#/components/schemas/State'
country:
$ref: '#/components/schemas/Country'
postalCode:
$ref: '#/components/schemas/ZipCode'
addressLine1:
$ref: '#/components/schemas/AddressLine1'
addressLine2:
$ref: '#/components/schemas/AddressLine2'
Institutions:
description:
A list of financial institutions from the Get Institutions API
required:
- found
- displaying
- moreAvailable
- createdDate
- institutions
type: object
properties:
found:
$ref: '#/components/schemas/FoundResults'
displaying:
$ref: '#/components/schemas/DisplayingResults'
moreAvailable:
$ref: '#/components/schemas/MoreResultsAvailable'
createdDate:
$ref: '#/components/schemas/UnixDate'
institutions:
description: A list of institutions
maxItems: 1000
minItems: 0
type: array
items:
$ref: '#/components/schemas/Institution'
InstitutionWrapper:
type: object
required:
- institution
properties:
institution:
$ref: '#/components/schemas/Institution'
Institution:
description: A financial institution
required:
- id
- transAgg
- ach
- stateAgg
- voi
- voa
- aha
- availBalance
- accountOwner
- oauthEnabled
- currency
- status
type: object
properties:
id:
$ref: '#/components/schemas/NumericInstitutionId'
name:
$ref: '#/components/schemas/InstitutionName'
transAgg:
$ref: '#/components/schemas/InstitutionTransAgg'
ach:
$ref: '#/components/schemas/InstitutionAch'
stateAgg:
$ref: '#/components/schemas/InstitutionStateAgg'
voi:
$ref: '#/components/schemas/InstitutionVoi'
voa:
$ref: '#/components/schemas/InstitutionVoa'
aha:
$ref: '#/components/schemas/InstitutionAha'
availBalance:
$ref: '#/components/schemas/InstitutionAvailableBalance'
accountOwner:
$ref: '#/components/schemas/InstitutionAccountOwner'
studentLoanData:
$ref: '#/components/schemas/StudentLoanDataCertification'
loanPaymentDetails:
$ref: '#/components/schemas/LoanPaymentDetailCertification'
accountTypeDescription:
type: string
description: >-
Values: Banking, Investments, Credit Cards/Accounts, Workplace
Retirement, Mortgages and Loans, Insurance
example: 'Workplace Retirement'
phone:
$ref: '#/components/schemas/PhoneNumber'
urlHomeApp:
type: string
description: The URL of the institution's primary home page
example: 'https://www.example.com/home'
urlLogonApp:
type: string
description: The URL of the institution's login page
example: 'https://www.example.com/login'
oauthEnabled:
type: boolean
description: >-
"true": The institution is an OAuth connection
"false": The institution isn't an OAuth connection
example: true
urlForgotPassword:
type: string
description: Institution's forgot password page
example: 'https://www.example.com/forgotPassword.do'
urlOnlineRegistration:
type: string
description: Institution's signup page
example: 'https://www.example.com/signup'
class:
type: string
description: Institution's class
example: 'retirement'
specialText:
type: string
description: Special instructions given to customers for login
example:
'Please enter your Principal Financial - Retirement (Personal)
Username and Password.'
timeZone:
type: string
description: The time zone of the institution.
example: America/Denver
specialInstructions:
type: array
items:
type: string
description: >-
Instructions given to the customer before they are sent to the
institution website to login for OAuth institutions.
Note: this helps the customer to provide the proper permission for
data needed for the application.
example:
- Account details
- Balances and transactions
- Personal and account ownership info
specialInstutionsTitle:
type: string
description:
The title of the special instructions, if one exists or is required.
example: Special OAuth Login Instructions
address:
$ref: '#/components/schemas/InstitutionAddress'
currency:
$ref: '#/components/schemas/Currency'
email:
$ref: '#/components/schemas/EmailAddress'
status:
type: string
description:
'Status for the institution: "online", "offline", "maintenance",
"testing"'
example: online
newInstitutionId:
$ref: '#/components/schemas/NumericInstitutionId'
# The new id for the financial institution's ID you are replacing. This is the same as the `oauthInstitutionId`
# field, which will eventually be replaced by this field.
branding:
$ref: '#/components/schemas/Branding'
oauthInstitutionId:
# The new ID for the OAuth institution's ID you are replacing.
$ref: '#/components/schemas/NumericInstitutionId'
CertifiedInstitutions:
description:
A list of financial institutions from the Get Certified Institutions API
required:
- found
- displaying
- moreAvailable
- requestedDate
- institutions
type: object
properties:
found:
$ref: '#/components/schemas/FoundResults'
displaying:
$ref: '#/components/schemas/DisplayingResults'
moreAvailable:
$ref: '#/components/schemas/MoreResultsAvailable'
requestedDate:
$ref: '#/components/schemas/UnixDate'
institutions:
description: A list of institutions
maxItems: 1000
minItems: 0
type: array
items:
$ref: '#/components/schemas/CertifiedInstitution'
CertifiedInstitution:
required:
- name
- id
- transAgg
- ach
- stateAgg
- voi
- voa
- aha
- availBalance
- accountOwner
- loanPaymentDetails
- studentLoanData
type: object
properties:
id:
$ref: '#/components/schemas/NumericInstitutionId'
rssd:
$ref: '#/components/schemas/Rssd'
name:
$ref: '#/components/schemas/InstitutionName'
transAgg:
$ref: '#/components/schemas/InstitutionTransAgg'
ach:
$ref: '#/components/schemas/InstitutionAch'
stateAgg:
$ref: '#/components/schemas/InstitutionStateAgg'
voi:
$ref: '#/components/schemas/InstitutionVoi'
voa:
$ref: '#/components/schemas/InstitutionVoa'
aha:
$ref: '#/components/schemas/InstitutionAha'
availBalance:
$ref: '#/components/schemas/InstitutionAvailableBalance'
accountOwner:
$ref: '#/components/schemas/InstitutionAccountOwner'
studentLoanData:
$ref: '#/components/schemas/StudentLoanDataCertification'
loanPaymentDetails:
$ref: '#/components/schemas/LoanPaymentDetailCertification'
childInstitutions:
description: An array of child financial institutions
minItems: 0
type: array
items:
$ref: '#/components/schemas/ChildInstitution'
ChildInstitution:
required:
- rssd
- parentRSSD
- name
- institutionId
type: object
properties:
rssd:
$ref: '#/components/schemas/Rssd'
parentRSSD:
$ref: '#/components/schemas/Rssd'
name:
$ref: '#/components/schemas/InstitutionName'
institutionId:
$ref: '#/components/schemas/NumericInstitutionId'
BaseReportAck:
description: Properties shared by all generated reports
type: object
properties:
id:
$ref: '#/components/schemas/ReportId'
customerType:
$ref: '#/components/schemas/CustomerType'
customerId:
$ref: '#/components/schemas/NumericCustomerId'
requestId:
$ref: '#/components/schemas/ReportRequestId'
requesterName:
$ref: '#/components/schemas/PartnerName'
createdDate:
$ref: '#/components/schemas/UnixDate'
title:
$ref: '#/components/schemas/ReportTitle'
consumerId:
$ref: '#/components/schemas/ConsumerId'
consumerSsn:
$ref: '#/components/schemas/SocialSecurityNumberLastDigits'
type:
$ref: '#/components/schemas/ReportType'
status:
$ref: '#/components/schemas/ReportStatus'
errors:
description: In case errors occurred during the report generation
type: array
items:
$ref: '#/components/schemas/ErrorMessage'
BaseReportAckWithPortfolioId:
description:
Properties shared by all generated reports having a portfolio ID
allOf:
- $ref: '#/components/schemas/BaseReportAck'
- type: object
properties:
portfolioId:
$ref: '#/components/schemas/PortfolioId'
VOAReportAck:
required:
- id
- portfolioId
- customerType
- customerId
- requestId
- requesterName
- createdDate
- title
- consumerId
- consumerSsn
- type
- status
- constraints
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
constraints:
$ref: '#/components/schemas/VOAReportConstraintsOut'
VOAWithIncomeReportAck:
required:
- id
- portfolioId
- customerType
- customerId
- requestId
- requesterName
- createdDate
- title
- consumerId
- consumerSsn
- type
- status
- constraints
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
constraints:
$ref: '#/components/schemas/VOAWithIncomeReportConstraintsOut'
PrequalificationReportAck:
required:
- id
- portfolioId
- customerType
- customerId
- requestId
- requesterName
- createdDate
- title
- consumerId
- consumerSsn
- type
- status
- constraints
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
constraints:
$ref: '#/components/schemas/PrequalificationReportConstraintsOut'
VOIReportAck:
required:
- id
- portfolioId
- customerType
- customerId
- requestId
- requesterName
- createdDate
- title
- consumerId
- consumerSsn
- type
- status
- constraints
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
constraints:
$ref: '#/components/schemas/VOIReportConstraintsOut'
PortfolioReport:
required:
- id
- portfolioId
- type
- status
- createdDate
type: object
properties:
id:
$ref: '#/components/schemas/ReportId'
portfolioId:
$ref: '#/components/schemas/PortfolioId'
type:
$ref: '#/components/schemas/ReportType'
status:
$ref: '#/components/schemas/ReportStatus'
createdDate:
$ref: '#/components/schemas/UnixDate'
Transaction:
required:
- id
- amount
- accountId
- customerId
- status
- description
- createdDate
- categorization
type: object
properties:
id:
$ref: '#/components/schemas/TransactionId'
amount:
type: number
description: >-
The total amount of the transaction. Transactions for deposits are
positive values, withdrawals and debits are negative values.
example: -828.9
accountId:
$ref: '#/components/schemas/NumericAccountId'
customerId:
$ref: '#/components/schemas/NumericCustomerId'
status:
type: string
description:
One of "active", "pending", or "shadow" (see [Pending and Shadow
Transactions](https://docs.finicity.com/pending-and-shadow-transactions/))
example: active
description:
type: string
description:
The description value is from the financial institution (FI), often
known as the payee. The value "No description provided by
institution" is returned when the FI doesn't provide one
example: Buy Stock
memo:
type: string
description:
The institution must provide either a description, a memo, or both.
We recommended concatenating the two fields into a single value.
example: UWM HOLDINGS CORPORATION - CLASS A COMMON STOCK
type:
$ref: '#/components/schemas/TransactionType'
transactionDate:
$ref: '#/components/schemas/UnixDate'
postedDate:
$ref: '#/components/schemas/TransactionPostedDate'
createdDate:
$ref: '#/components/schemas/TransactionCreatedDate'
firstEffectiveDate:
$ref: '#/components/schemas/TransactionFirstEffectiveDate'
effectiveDate:
$ref: '#/components/schemas/TransactionEffectiveDate'
checkNum:
type: integer
description: The check number of the transaction
format: int32
example: 299
escrowAmount:
type: number
description: The portion of the transaction allocated to escrow
example: 2534
feeAmount:
type: number
description:
The portion of the overall transaction amount applied to fees
example: 0.51
suspenseAmount:
type: number
description:
Temporarily hold funds if you overpay or underpay your monthly
payment
example: 0.25
interestAmount:
type: number
description: The portion of the transaction allocated to interest
example: 132
principalAmount:
type: number
description: The portion of the transaction allocated to principal
example: 32560
unitQuantity:
type: integer
description:
The number of units (individual shares) in the transaction
format: int32
example: 150
unitPrice:
type: number
description:
'Share price for the investment unit: stocks, mutual funds, ETFs'
example: 5.53
categorization:
$ref: '#/components/schemas/Categorization'
runningBalanceAmount:
description: The ending balance after the transaction was posted
type: number
example: 1000
subaccountSecurityType:
type: string
description: The type of sub account the funds came from
example: MARGIN
commissionAmount:
type: integer
description: Transaction commission
format: int32
example: 0
ticker:
type: string
description:
Ticker symbol for the investment related to the transaction
example: UWMC
investmentTransactionType:
$ref: '#/components/schemas/InvestmentTransactionTypes'
taxesAmount:
type: integer
description: Taxes applicable to the investment trade
format: int32
example: 0
currencySymbol:
type: string
description: >-
If the foreign amount value is present then this is the currency
code of that foreign amount
example: USD
incomeType:
type: string
description:
Capital gains applied in short, long, or miscellaneous terms for tax
purposes
example: DIV
splitDenominator:
type: number
description: Denominator of the stock split for the transaction
example: 152
splitNumerator:
type: number
description: Numerator of the stock split for the transaction
example: 20
sharesPerContract:
type: number
description: Shares per contract of the underlying stock option
example: 100
subAccountFund:
type: string
description: The sub account where the funds came from
example: MARGIN
securityId:
type: string
description: The security ID of the transaction
example: '91823B109'
securityIdType:
$ref: '#/components/schemas/SecurityIdType'
PortfolioSummary:
required:
- portfolioId
- reports
type: object
properties:
portfolioId:
$ref: '#/components/schemas/PortfolioId'
reports:
type: array
items:
$ref: '#/components/schemas/PortfolioReport'
description: A list of reports in the portfolio
PortfolioWithConsumerSummary:
required:
- portfolioId
- consumer
- reports
allOf:
- $ref: '#/components/schemas/PortfolioSummary'
- type: object
properties:
consumer:
$ref: '#/components/schemas/PortfolioConsumer'
ReportSummaries:
required:
- reports
type: object
properties:
reports:
type: array
items:
$ref: '#/components/schemas/ReportSummary'
description: Data pertaining to each report
TxVerifyInterview:
required:
- assetId
type: object
properties:
assetId:
$ref: '#/components/schemas/AssetId'
accounts:
$ref: '#/components/schemas/ReportAccountIds'
Categorization:
required:
- normalizedPayeeName
- category
- country
type: object
properties:
normalizedPayeeName:
type: string
description:
A normalized payee, derived from the transaction's description and
memo fields
example: Mad Science Research
category:
$ref: '#/components/schemas/Categories'
city:
$ref: '#/components/schemas/City'
state:
$ref: '#/components/schemas/State'
postalCode:
$ref: '#/components/schemas/ZipCode'
country:
$ref: '#/components/schemas/Country'
bestRepresentation:
description:
Combines the `description` and `memo` data together, removing
duplicated information and numbers and special characters
type: string
example: VERIZON WIRELESS PAYMENTS
description: Categorization Record
Birthday:
type: object
properties:
year:
type: integer
description: The birthday 4-digit year
format: int32
example: 1989
month:
type: integer
description: The birthday 2-digit month (1 is January)
format: int32
example: 8
dayOfMonth:
type: integer
description: The birthday 2-digit day-of-month
format: int32
example: 13
description: A birth date
ExtractEarnings:
type: boolean
description:
Field to indicate whether to extract the earnings on all pay statements
default: true
example: true
ExtractDeductions:
type: boolean
description:
Field to indicate whether to extract the deductions on all pay
statements
default: false
example: true
ExtractDirectDeposit:
type: boolean
description:
Field to indicate whether to extract the direct deposits on all pay
statements
default: true
example: true
TxPushCallbackUrl:
type: string
description: A callback URL where to receive TxPush notifications
example: 'https://www.mydomain.com/txpush/listener'
PayStatementData:
description: Data to be included within the pay statement report
required:
- assetIds
type: object
properties:
assetIds:
description: A list of pay statement asset IDs
type: array
items:
$ref: '#/components/schemas/AssetId'
extractEarnings:
$ref: '#/components/schemas/ExtractEarnings'
extractDeductions:
$ref: '#/components/schemas/ExtractDeductions'
extractDirectDeposit:
$ref: '#/components/schemas/ExtractDirectDeposit'
Report:
description: A report
type: object
required:
- id
- customerType
- customerId
- requestId
- requesterName
- createdDate
- title
- consumerId
- consumerSsn
- type
- status
allOf:
- $ref: '#/components/schemas/CashFlowReport'
- $ref: '#/components/schemas/PrequalificationReport'
- $ref: '#/components/schemas/PayStatementReport'
- $ref: '#/components/schemas/StatementReport'
- $ref: '#/components/schemas/TransactionsReport'
- $ref: '#/components/schemas/VOAReport'
- $ref: '#/components/schemas/VOAWithIncomeReport'
- $ref: '#/components/schemas/VOEPayrollReport'
- $ref: '#/components/schemas/VOETransactionsReport'
- $ref: '#/components/schemas/VOIReport'
- $ref: '#/components/schemas/VOIEPayrollReport'
- $ref: '#/components/schemas/VOIEPaystubReport'
- $ref: '#/components/schemas/VOIEPaystubWithTXVerifyReport'
CashFlowMonthlyCashFlowCredits:
required:
- month
- numberOfCredits
- totalCreditsAmount
- largestCredit
- numberOfCreditsLessTransfers
- totalCreditsAmountLessTransfers
- averageCreditAmount
- estimatedNumberOfLoanDeposits
- estimatedLoanDepositAmount
type: object
properties:
month:
type: integer
description:
One instance for each complete calendar month in the report
format: int64
example: 1512111600
numberOfCredits:
type: string
description: Number of credits by month
example: '3'
totalCreditsAmount:
type: number
description: Total amount of credits by month
example: 5000
largestCredit:
type: number
description: Largest credit by month
example: 2000
numberOfCreditsLessTransfers:
type: string
description: Number of credits by month (less transfers)
example: '2'
totalCreditsAmountLessTransfers:
type: number
description: Total amount of credits by month (less transfers)
example: 4000
averageCreditAmount:
type: number
description: The average credit amount
example: 500
estimatedNumberOfLoanDeposits:
type: string
description: The estimated number of loan deposits
example: '0'
estimatedLoanDepositAmount:
type: number
description: The estimated loan deposit amount
example: 0
CashFlowCashFlowCredit:
required:
- monthlyCashFlowCredits
- twelveMonthCreditTotal
- twelveMonthCreditTotalLessTransfers
- sixMonthCreditTotal
- sixMonthCreditTotalLessTransfers
- twoMonthCreditTotal
- twoMonthCreditTotalLessTransfers
type: object
properties:
monthlyCashFlowCredits:
type: array
items:
$ref: '#/components/schemas/CashFlowMonthlyCashFlowCredits'
description: List of attributes for each month
twelveMonthCreditTotal:
type: number
description: Sum of all credit transactions for each month by account
example: 1200
twelveMonthCreditTotalLessTransfers:
type: number
description:
Sum of all monthly credit transactions without transfers for the
account
example: 1000
sixMonthCreditTotal:
type: number
description: Sum of six month credit transactions
example: 750
sixMonthCreditTotalLessTransfers:
type: number
description: Sum of six month credit transactions without transfers
example: 500
twoMonthCreditTotal:
type: number
description: Sum of two month credit transactions
example: 150
twoMonthCreditTotalLessTransfers:
type: number
description: Sum of two month credit transactions without transfers
example: 100
TransactionsReportAccount:
type: object
properties:
id:
type: integer
description: The Finicity account ID
format: int64
example: 1000075473
name:
type: string
description: The account name from the financial institution.
example: Super Checking
number:
type: string
description:
The account number from the financial institution (obfuscated)
example: '5015'
type:
$ref: '#/components/schemas/AccountType'
aggregationStatusCode:
type: integer
description:
'The status of the most recent aggregation attempt for this account.
Note: non-zero means the account was not accessed successfully for
this report, and additional fields for this account may not be
reliable.'
format: int32
example: 0
balance:
type: number
description: The cleared balance of the account as-of `balanceDate`
example: 100000
balanceDate:
type: integer
description: A timestamp showing when the balance was captured
format: int64
example: 1594676289
transactions:
type: array
items:
$ref: '#/components/schemas/ReportTransaction'
description: a list of transaction records
description: Fields used for the Transaction History Report (CRA products)
VOAReportAccount:
type: object
properties:
id:
type: integer
description: The ID of the account
format: int64
example: 1000023996
number:
type: string
description:
The account number from the institution (all digits except the last
four are obfuscated)
example: '1111'
ownerName:
type: string
description:
The name(s) of the account owner(s). This field is optional. If no
owner information is available, this field will not appear in the
report.
example: JOHN DOE
ownerAddress:
type: string
description:
The mailing address of the account owner(s). This field is optional.
If no owner information is available, this field will not appear in
the report.
example: 924 GAINSVILLE HIGHWAY SUITE 130 BUFORD, GA 30518
name:
type: string
description: The account name from the institution
example: Checking
type:
type: string
description: One of the values from account types
example: checking
availableBalance:
type: number
description: The available balance for the account
example: 501.24
aggregationStatusCode:
type: integer
description: The status of the most recent aggregation attempt
format: int32
example: 0
balance:
type: number
description: The cleared balance of the account as-of balanceDate
example: 501.24
balanceDate:
type: integer
description: A timestamp showing when the balance was captured
format: int64
example: 1588350276
averageMonthlyBalance:
type: number
description: The average monthly balance of this account
example: 501.02
totNumberInsufficientFundsFeeDebitTxAccount:
type: integer
description:
The count for the total number of insufficient funds transactions,
based on the `fromDate` of the report.
format: int64
example: 0
totNumberInsufficientFundsFeeDebitTxOver2MonthsAccount:
type: integer
description:
The count for the total number of insufficient funds transactions
for the last two months, based on the `fromDate` of the report.
format: int64
example: 0
totNumberDaysSinceMostRecentInsufficientFundsFeeDebitTxAccount:
type: integer
description:
The number of days since the most recent insufficient funds
transaction, based on the `fromDate` of the report.
format: int64
example: 120
transactions:
type: array
items:
$ref: '#/components/schemas/ReportTransaction'
description: a list of transaction records
details:
$ref: '#/components/schemas/AccountDetails'
asset:
$ref: '#/components/schemas/PrequalificationReportAssetSummary'
VOAWithIncomeReportAccount:
type: object
allOf:
- $ref: '#/components/schemas/VOAReportAccount'
- type: object
properties:
incomeStreams:
type: array
items:
$ref: '#/components/schemas/VOAIReportIncomeStream'
description: A list of income stream records
VOETransactionsReportAccount:
type: object
properties:
id:
type: integer
description: The ID of the account
format: int64
example: 1000023996
number:
type: string
description:
The account number from the institution (all digits except the last
four are obfuscated)
example: '1111'
ownerName:
type: string
description:
The name(s) of the account owner(s). This field is optional. If no
owner information is available, this field will not appear in the
report.
example: JOHN DOE
ownerAddress:
type: string
description:
The mailing address of the account owner(s). This field is optional.
If no owner information is available, this field will not appear in
the report.
example: 924 GAINSVILLE HIGHWAY SUITE 130 BUFORD, GA 30518
name:
type: string
description: The account name from the institution
example: Checking
type:
type: string
description: One of the values from account types
example: checking
aggregationStatusCode:
type: integer
description: The status of the most recent aggregation attempt
format: int32
example: 0
incomeStreams:
type: array
items:
$ref: '#/components/schemas/VOETransactionsReportIncomeStream'
description: A list of income stream records
VOIETXVerifyReportAccount:
required:
- id
- ownerName
- ownerAddress
- name
- number
- type
- aggregationStatusCode
- incomeStreams
- balance
- averageMonthlyBalance
- transactions
- availableBalance
type: object
properties:
id:
type: integer
description: The ID of the account
format: int64
example: 1000023996
number:
type: string
description:
The account number from the institution (all digits except the last
four are obfuscated)
example: '1111'
ownerName:
type: string
description:
The name(s) of the account owner(s). This field is optional. If no
owner information is available, this field will not appear in the
report.
example: JOHN DOE
ownerAddress:
type: string
description:
The mailing address of the account owner(s). This field is optional.
If no owner information is available, this field will not appear in
the report.
example: 924 GAINSVILLE HIGHWAY SUITE 130 BUFORD, GA 30518
name:
type: string
description: The account name from the institution
example: Checking
type:
type: string
description: One of the values from account types
example: checking
aggregationStatusCode:
type: integer
description: The status of the most recent aggregation attempt
format: int32
incomeStreams:
type: array
items:
$ref: '#/components/schemas/VOIETXVerifyReportIncomeStream'
description: A list of income stream records
balance:
type: number
description: The cleared balance of the account as-of `balanceDate`
example: 123.45
averageMonthlyBalance:
type: number
description: The average monthly balance of this account
example: 301.45
transactions:
type: array
items:
$ref: '#/components/schemas/ReportTransaction'
description: a list of transaction records
availableBalance:
type: number
description: The available balance for the account
example: 123.45
VOIReportAccount:
type: object
properties:
id:
type: integer
description: The ID of the account
format: int64
example: 1000023996
number:
type: string
description:
The account number from the institution (all digits except the last
four are obfuscated)
example: '1111'
ownerName:
type: string
description:
The name(s) of the account owner(s). This field is optional. If no
owner information is available, this field will not appear in the
report.
example: JOHN DOE
ownerAddress:
type: string
description:
The mailing address of the account owner(s). This field is optional.
If no owner information is available, this field will not appear in
the report.
example: 924 GAINSVILLE HIGHWAY SUITE 130 BUFORD, GA 30518
name:
type: string
description: The account name from the institution
example: Checking
type:
type: string
description: One of the values from account types
example: checking
aggregationStatusCode:
type: integer
description: The status of the most recent aggregation attempt
format: int32
example: 0
incomeStreams:
type: array
items:
$ref: '#/components/schemas/VOIReportIncomeStream'
description: A list of income stream records
balance:
type: number
description: The cleared balance of the account as-of `balanceDate`
example: 714.16
averageMonthlyBalance:
type: number
description: The average monthly balance of this account
example: 720.75
transactions:
type: array
items:
$ref: '#/components/schemas/ReportTransaction'
description: a list of transaction records
availableBalance:
type: number
description: The available balance for the account
example: 714.16
currentBalance:
type: number
description: Current balance of the account
example: 714.16
beginningBalance:
type: number
description:
Beginning balance of account per the time period in the report
example: 714.77
miscDeposits:
maxItems: 100
minItems: 0
type: array
items:
$ref: '#/components/schemas/ReportTransaction'
description: A list of miscellaneous deposits
VOIReportIncomeStream:
type: object
required:
- id
- name
- status
- estimateInclusion
- confidence
- cadence
- netMonthly
- netAnnual
- projectedNetAnnual
- estimatedGrossAnnual
- projectedGrossAnnual
- averageMonthlyIncomeNet
- incomeStreamMonths
- transactions
properties:
id:
type: string
description: Income stream ID
example: dens28i3vsch-voi1
name:
type: string
description:
A human-readable name based on the `normalizedPayee` name of the
transactions for this income stream
example: none
status:
$ref: '#/components/schemas/ActiveStatus'
estimateInclusion:
$ref: '#/components/schemas/EstimateInclusion'
confidence:
type: integer
description:
'Level of confidence that the deposit stream represents income
(example: 85%)'
format: int32
example: 70
cadence:
$ref: '#/components/schemas/CadenceDetails'
netMonthly:
type: array
items:
$ref: '#/components/schemas/NetMonthly'
description:
A list of net monthly records. One instance for each complete
calendar month in the report.
netAnnual:
type: number
description:
Sum of all values in `netMonthlyIncome` over the previous 12 months
example: 110475.7
projectedNetAnnual:
type: number
description:
Projected net income over the next 12 months, across all income
streams, based on `netAnnualIncome`
example: 0
estimatedGrossAnnual:
type: number
description:
Before-tax gross annual income (estimated from `netAnnual`) across
all income stream in the past 12 months
projectedGrossAnnual:
type: number
description:
Projected gross income over the next 12 months, across all active
income streams, based on `projectedNetAnnual`
example: 151609
averageMonthlyIncomeNet:
type: number
description: Monthly average amount over the previous 24 months
example: 9206.31
incomeStreamMonths:
type: integer
description: The number of months the income transactions are observed
format: int32
example: 18
transactions:
type: array
items:
$ref: '#/components/schemas/ReportTransaction'
description: A list of transaction records
VOETransactionsReportIncomeStream:
type: object
required:
- id
- name
- status
- estimateInclusion
- confidence
- cadence
- daysSinceLastTransaction
- nextExpectedTransactionDate
- incomeStreamMonths
- transactions
properties:
id:
type: string
description: Income stream ID
example: dens28i3vsch-voah
name:
type: string
description:
A human-readable name based on the `normalizedPayee` name of the
transactions for this income stream
example: none
status:
$ref: '#/components/schemas/ActiveStatus'
estimateInclusion:
$ref: '#/components/schemas/EstimateInclusion'
confidence:
type: integer
description:
'Level of confidence that the deposit stream represents income
(example: 85%)'
format: int32
example: 70
cadence:
$ref: '#/components/schemas/CadenceDetails'
daysSinceLastTransaction:
type: integer
description:
The number of days since the last credit transaction for the
particular income stream
format: int32
example: 15
nextExpectedTransactionDate:
type: integer
description:
The next expected credit transaction date for the particular income
stream, based on the cadence
format: int64
example: 1572625469
incomeStreamMonths:
type: integer
description: The number of months the income transactions are observed
format: int32
example: 18
transactions:
type: array
items:
$ref: '#/components/schemas/ReportTransaction'
description: A list of transaction records
VOIETXVerifyReportIncomeStream:
required:
- id
- name
- status
- confidence
- cadence
- netMonthly
- netAnnual
- projectedNetAnnual
- estimatedGrossAnnual
- projectedGrossAnnual
- averageMonthlyIncomeNet
- incomeStreamMonths
- transactions
type: object
properties:
id:
type: string
description: Finicityβs income stream ID
example: dens28i3vsch-voietxverify
name:
type: string
description:
A human-readable name based on the `normalizedPayee` name of the
transactions for this income stream
example: none
status:
$ref: '#/components/schemas/ActiveStatus'
confidence:
type: integer
description:
'Level of confidence that the deposit stream represents income
(example: 85%)'
format: int32
example: 70
cadence:
$ref: '#/components/schemas/CadenceDetails'
netMonthly:
type: array
items:
$ref: '#/components/schemas/NetMonthly'
description:
A list of net monthly records. One instance for each complete
calendar month in the report.
netAnnual:
type: number
description:
Sum of all values in `netMonthlyIncome` over the previous 12 months
example: 110475.7
projectedNetAnnual:
type: number
description:
Projected net income over the next 12 months, across all income
streams, based on `netAnnualIncome`
example: 0
estimatedGrossAnnual:
type: number
description:
Before-tax gross annual income (estimated from `netAnnual`) across
all income stream in the past 12 months
example: 12321.1
projectedGrossAnnual:
type: number
description:
Projected gross income over the next 12 months, across all active
income streams, based on `projectedNetAnnual`
example: 151609
averageMonthlyIncomeNet:
type: number
description: Monthly average amount over the previous 24 months
example: 9206.31
incomeStreamMonths:
type: integer
description: The number of months the income transactions are observed
format: int32
example: 24
transactions:
type: array
items:
$ref: '#/components/schemas/ReportTransaction'
description: A list of transaction records
VOAIReportIncomeStream:
description: A report income stream record
required:
- id
- name
- status
- estimateInclusion
- confidence
- cadence
- netMonthly
- netAnnual
- projectedNetAnnual
- estimatedGrossAnnual
- projectedGrossAnnual
- averageMonthlyIncomeNet
- incomeStreamMonths
- transactions
type: object
properties:
id:
type: string
description: Income stream ID
example: dens28i3vsch-voah
name:
type: string
description:
A human-readable name based on the `normalizedPayee` name of the
transactions for this income stream
example: none
status:
$ref: '#/components/schemas/ActiveStatus'
estimateInclusion:
$ref: '#/components/schemas/EstimateInclusion'
confidence:
type: integer
description:
'Level of confidence that the deposit stream represents income
(example: 85%)'
format: int32
example: 70
cadence:
$ref: '#/components/schemas/CadenceDetails'
netMonthly:
type: array
items:
$ref: '#/components/schemas/NetMonthly'
description:
A list of net monthly records. One instance for each complete
calendar month in the report.
example:
- month: 1522562400
net: 2004.77
netAnnual:
type: number
description:
Sum of all values in `netMonthlyIncome` over the previous 12 months
example: 110475.7
projectedNetAnnual:
type: number
description:
Projected net income over the next 12 months, across all income
streams, based on `netAnnualIncome`
example: 0
estimatedGrossAnnual:
type: number
description:
Before-tax gross annual income (estimated from `netAnnual`) across
all income stream in the past 12 months
projectedGrossAnnual:
type: number
description:
Projected gross income over the next 12 months, across all active
income streams, based on `projectedNetAnnual`
example: 151609
averageMonthlyIncomeNet:
type: number
description: Monthly average amount over the previous 24 months
example: 9206.31
incomeStreamMonths:
type: integer
description: The number of months the income transactions are observed
format: int32
example: 18
transactions:
type: array
items:
$ref: '#/components/schemas/ReportTransaction'
description: A list of transaction records
ActiveStatus:
description: 'Possible values: "ACTIVE", "INACTIVE"'
type: string
EstimateInclusion:
description: 'Possible values: "HIGH", "MODERATE", "LOW", "NO"'
type: string
CadenceDetails:
type: object
properties:
startDate:
type: integer
description: '`postedDate` of the first deposit transaction'
format: int64
example: 1577986990
stopDate:
type: integer
description:
'`postedDate` of the final deposit transaction (omitted if status is
active)'
format: int64
example: 1587986990
days:
type: integer
description: Number of days between the recurring deposits
format: int32
example: 14
NetMonthly:
required:
- month
- net
type: object
properties:
month:
type: integer
description: Timestamp for the first day of this month
format: int64
example: 1522562400
net:
type: number
description:
Total income during the given month, across all income streams
example: 2004.77
CashFlowReportAccount:
type: object
properties:
id:
type: string
description: Finicity account ID
example: '6681984'
ownerName:
type: string
description:
The name(s) of the account owner(s), retrieved from the institution.
example: PATRICK & LORRAINE PURCHASER
ownerAddress:
type: string
description:
The mailing address of the account owner, retrieved from the
institution.
example: 7195 BELMONT ST. PARLIN, NJ 08859
name:
type: string
description: The account name from the institution
example: Checking
number:
type: string
description: The account number from the institution (obfuscated)
example: XX1111
type:
type: string
description:
'CFR: `ALL` (`checking` / `savings` / `loan` / `mortgage` / `credit
card` / `CD` / `MM` / `investment`...)'
example: checking
aggregationStatusCode:
type: string
description:
The status of the most recent aggregation attempt for this account
(non-zero means the account was not accessed successfully for this
report, and additional fields for this account may not be reliable)
example: '0'
currentBalance:
type: number
description: The cleared balance of the account as-of `balanceDate`
example: 100000
availableBalance:
type: number
description: Available balance
example: 1000
balanceDate:
type: integer
description: A timestamp showing when the `balance` was captured
format: int64
example: 1614880526
transactions:
type: array
items:
$ref: '#/components/schemas/ReportTransaction'
description: a list of transaction records
cashFlowBalance:
$ref: '#/components/schemas/CashFlowCashFlowBalance'
cashFlowCredit:
$ref: '#/components/schemas/CashFlowCashFlowCredit'
cashFlowDebit:
$ref: '#/components/schemas/CashFlowCashFlowDebit'
cashFlowCharacteristic:
$ref: '#/components/schemas/CashFlowCashFlowCharacteristic'
CashFlowMonthlyCashFlowCharacteristics:
required:
- month
- totalCreditsLessTotalDebits
- totalCreditsLessTotalDebitsLessTransfers
- averageTransactionAmount
type: object
properties:
month:
type: integer
description:
One instance for each complete calendar month in the report
format: int64
example: 1512111600
totalCreditsLessTotalDebits:
type: number
description: Total Credits - Total Debits by month
example: 15000
totalCreditsLessTotalDebitsLessTransfers:
type: number
description: Total Credits - Total Debits by month (Without Transfers)
example: 11000
averageTransactionAmount:
type: number
description: Average transaction amount by month
example: 10
CashFlowCashFlowCharacteristic:
required:
- monthlyCashFlowCharacteristics
- averageMonthlyNet
- averageMonthlyNetLessTransfers
- twelveMonthTotalNet
- twelveMonthTotalNetLessTransfers
- sixMonthAverageTotalCreditsLessTotalDebits
- sixMonthAverageTotalCreditsLessTotalDebitsLessTransfers
- twoMonthAverageTotalCreditsLessTotalDebits
- twoMonthAverageTotalCreditsLessTotalDebitsLessTransfers
type: object
properties:
monthlyCashFlowCharacteristics:
type: array
items:
$ref: '#/components/schemas/CashFlowMonthlyCashFlowCharacteristics'
description: List of attributes for each month
averageMonthlyNet:
type: number
description: Average (Total Credits - Total Debits) for the account
example: 2350
averageMonthlyNetLessTransfers:
type: number
description:
Average (Total Credits - Total Debits) without transfers for the
account
example: 1000
twelveMonthTotalNet:
type: number
description:
Sum of all monthly (Total Credits - Total Debits) each month for the
account
example: 12500
twelveMonthTotalNetLessTransfers:
type: number
description:
Sum of all monthly (Total Credits - Total Debits) without transfers
for the account
example: 12400
sixMonthAverageTotalCreditsLessTotalDebits:
type: number
description: 6 Month Average (Total Credits - Total Debits)
example: 55555
sixMonthAverageTotalCreditsLessTotalDebitsLessTransfers:
type: number
description:
6 Month Average (Total Credits - Total Debits) - (Without Transfers)
example: 55555
twoMonthAverageTotalCreditsLessTotalDebits:
type: number
description: 2 Month Average (Total Credits - Total Debits)
example: 55555
twoMonthAverageTotalCreditsLessTotalDebitsLessTransfers:
type: number
description:
2 Month Average (Total Credits - Total Debits) - (Without Transfers)
example: 55555
CashFlowMonthlyCashFlowBalances:
required:
- month
- minDailyBalance
- maxDailyBalance
- averageDailyBalance
- standardDeviationOfDailyBalance
- numberOfDaysNegativeBalance
- numberOfDaysPositiveBalance
type: object
properties:
month:
type: integer
description:
One instance for each complete calendar month in the report
format: int64
example: 1512111600
minDailyBalance:
type: number
description: Min Daily Balance for each month
example: 3479.39
maxDailyBalance:
type: number
description: Max Daily Balance for each month
example: 3479.39
averageDailyBalance:
type: number
description: Average Daily Balance for each month
example: 3479.39
standardDeviationOfDailyBalance:
type: string
description: Standard Deviation of Daily Balance for each month
example: '20'
numberOfDaysNegativeBalance:
type: string
description: Number of Days Negative Balance for each month
example: '6'
numberOfDaysPositiveBalance:
type: string
description: Number of Days positive balance for each month
example: '0'
CashFlowCashFlowBalance:
required:
- monthlyCashFlowBalances
- minDailyBalance
- maxDailyBalance
- twelveMonthAverageDailyBalance
- sixMonthAverageDailyBalance
- twoMonthAverageDailyBalance
- twelveMonthStandardDeviationOfDailyBalance
- sixMonthStandardDeviationOfDailyBalance
- twoMonthStandardDeviationOfDailyBalance
- numberDaysNegativeBalance
- numberOfDaysPositiveBalance
type: object
properties:
monthlyCashFlowBalances:
type: array
items:
$ref: '#/components/schemas/CashFlowMonthlyCashFlowBalances'
description: List of attributes for each month
minDailyBalance:
type: number
description: Min daily balance across entire transaction history
example: 3479.39
maxDailyBalance:
type: number
description: Max Daily Balance across entire transaction history
example: 3479.39
twelveMonthAverageDailyBalance:
type: number
description:
Average Daily Balance across twelve months for the account
example: 3479.39
sixMonthAverageDailyBalance:
type: number
description: Average Daily Balance across six months for the account
example: 3479.39
twoMonthAverageDailyBalance:
type: number
description: Average Daily Balance across two months for the account
example: 3479.39
twelveMonthStandardDeviationOfDailyBalance:
type: string
description:
Standard Deviation of Daily Balance across twelve months for the
account
example: '20'
sixMonthStandardDeviationOfDailyBalance:
type: string
description:
Standard Deviation of Daily Balance across six months for the
account
example: '20'
twoMonthStandardDeviationOfDailyBalance:
type: string
description:
Standard Deviation of Daily Balance across two months for the
account
example: '20'
numberDaysNegativeBalance:
type: string
description:
Number of Days Negative Balance over entire transaction history
example: '6'
numberOfDaysPositiveBalance:
type: string
description:
Number of Days positive balance over entire transaction history
example: '0'
ReportInstitution:
required:
- id
- name
- urlHomeApp
- accounts
type: object
properties:
id:
$ref: '#/components/schemas/NumericInstitutionId'
name:
type: string
description: Finicity institution name
example: FinBank Profiles
urlHomeApp:
type: string
description: The URL of the Financial Institution
example: http://www.finbank.com
accounts:
type: array
items:
$ref: '#/components/schemas/ReportInstitutionAccount'
description: A list of account records
ReportInstitutionAccount:
description: An account record
type: object
allOf:
- $ref: '#/components/schemas/CashFlowReportAccount'
- $ref: '#/components/schemas/PrequalificationReportAccount'
- $ref: '#/components/schemas/TransactionsReportAccount'
- $ref: '#/components/schemas/VOAReportAccount'
- $ref: '#/components/schemas/VOAWithIncomeReportAccount'
- $ref: '#/components/schemas/VOETransactionsReportAccount'
- $ref: '#/components/schemas/VOIReportAccount'
- $ref: '#/components/schemas/VOIETXVerifyReportAccount'
CashFlowReport:
description: A Cash Flow report
type: object
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
startDate:
$ref: '#/components/schemas/ReportStartDate'
endDate:
$ref: '#/components/schemas/ReportEndDate'
days:
type: integer
description: Number of days covered by the report
example: 730
seasoned:
type: boolean
description: '"true" if the report covers more than 365 days'
example: true
institutions:
type: array
items:
$ref: '#/components/schemas/ReportInstitution'
description:
A list of institution records, including information about the
individual accounts used in this report
cashFlowBalanceSummary:
$ref: '#/components/schemas/CashFlowCashFlowBalanceSummary'
cashFlowCreditSummary:
$ref: '#/components/schemas/CashFlowCashFlowCreditSummary'
cashFlowDebitSummary:
$ref: '#/components/schemas/CashFlowCashFlowDebitSummary'
cashFlowCharacteristicsSummary:
$ref: '#/components/schemas/CashFlowCashFlowCharacteristicsSummary'
possibleLoanDeposits:
type: array
items:
$ref: '#/components/schemas/CashFlowPossibleLoanDeposits'
description: A possible loan deposits record
CashFlowPossibleLoanDeposits:
required:
- id
- name
- urlHomeApp
- accounts
type: object
properties:
id:
type: string
description: Finicity institution ID
example: '102105'
name:
type: string
description: Finicity institution name
example: FinBank Profiles
urlHomeApp:
type: string
description: The URL of the Financial Institution
example: http://www.finbank.com
accounts:
type: array
items:
$ref: '#/components/schemas/CashFlowPossibleLoanDepositsAccount'
description: A list of account records
CashFlowPossibleLoanDepositsAccount:
required:
- id
- ownerName
- ownerAddress
- name
- number
- type
- aggregationStatusCode
- currentBalance
- availableBalance
- balanceDate
- transactions
type: object
properties:
id:
type: string
description: Finicity account ID
example: '6681984'
ownerName:
type: string
description:
The name(s) of the account owner(s), retrieved from the institution.
example: PATRICK & LORRAINE PURCHASER
ownerAddress:
type: string
description:
The mailing address of the account owner, retrieved from the
institution.
example: 7195 BELMONT ST. PARLIN, NJ 08859
name:
type: string
description: The account name from the institution
example: Checking
number:
type: string
description: The account number from the institution (obfuscated)
example: XX1111
type:
type: string
description:
'CFR: `ALL` (`checking` / `savings` / `loan` / `mortgage` / `credit
card` / `CD` / `MM` / `investment`...)'
example: checking
aggregationStatusCode:
type: string
description:
The status of the most recent aggregation attempt for this account
(non-zero means the account was not accessed successfully for this
report, and additional fields for this account may not be reliable)
example: '0'
currentBalance:
type: number
description: The cleared balance of the account as-of `balanceDate`
example: 100000
availableBalance:
type: number
description: Available balance
example: 1000
balanceDate:
type: integer
description: A timestamp showing when the `balance` was captured
format: int64
example: 1614880526
transactions:
type: array
items:
$ref: '#/components/schemas/ReportTransaction'
description: a list of transaction records
ReportTransaction:
required:
- id
- postedDate
- description
- normalizedPayee
- institutionTransactionId
- category
type: object
properties:
id:
$ref: '#/components/schemas/TransactionId'
amount:
type: number
description:
The total amount of the transaction. Transactions for deposits are
positive values, withdrawals and debits are negative values.
example: 100
postedDate:
type: integer
description:
A timestamp showing when the transaction was posted or cleared by
the institution
format: int64
example: 1571313600
description:
type: string
description:
The description of the transaction, as provided by the institution
(often known as `payee`). In the event that this field is left blank
by the institution, Finicity will pass a value of "No description
provided by institution". All other values are provided by the
institution.
example: ATM CHECK DEPOSIT mm/dd
memo:
type: string
description:
The memo field of the transaction, as provided by the institution.
The institution must provide either a description, a memo, or both.
It is recommended to concatenate the two fields into a single value.
example: Some St Somewhere City State
normalizedPayee:
type: string
description:
A normalized payee, derived from the transaction's `description` and
`memo` fields
example: T-Mobile
institutionTransactionId:
type: string
description:
The unique identifier given by the FI for each transaction
example: '0000000000'
category:
type: string
description:
One of the values from Categories (assigned based on the payee name)
example: Income
type:
type: string
description: One of the values from transaction types
example: debit
securityType:
type: string
description: The type of investment security (VOA only)
symbol:
type: string
description: Investment symbol (VOA only)
commission:
type: number
CashFlowMonthlyCashFlowDebitSummaries:
required:
- month
- numberOfDebits
- totalDebitsAmount
- largestDebit
- numberOfDebitsLessTransfers
- totalDebitsAmountLessTransfers
- averageDebitAmount
type: object
properties:
month:
type: integer
description:
One instance for each complete calendar month in the report
format: int64
example: 1512111600
numberOfDebits:
type: string
description: Number of Debits by month across all accounts
example: '1500'
totalDebitsAmount:
type: number
description: Total Amount of Debits by month across all accounts
example: -12345.46
largestDebit:
type: number
description: Largest Debit by month
example: -20000
numberOfDebitsLessTransfers:
type: string
description: Number of Debits by month (less transfers)
example: '5'
totalDebitsAmountLessTransfers:
type: number
description: Total amount of debits by month (less transfers)
example: -2000
averageDebitAmount:
type: number
description: The average debit amount
example: 500
CashFlowCashFlowDebitSummary:
required:
- monthlyCashFlowDebitSummaries
- twelveMonthDebitTotal
- twelveMonthDebitTotalLessTransfers
- sixMonthDebitTotal
- sixMonthDebitTotalLessTransfers
- twoMonthDebitTotal
- twoMonthDebitTotalLessTransfers
type: object
properties:
monthlyCashFlowDebitSummaries:
type: array
items:
$ref: '#/components/schemas/CashFlowMonthlyCashFlowDebitSummaries'
description: List of attributes for each month
twelveMonthDebitTotal:
type: number
description:
Sum of all monthly debit transactions for each month by account
example: -1200
twelveMonthDebitTotalLessTransfers:
type: number
description:
Sum of all monthly debit transactions without transfers for the
account
example: -1000
sixMonthDebitTotal:
type: number
description: Six month sum of all debit transactions by account
example: -750
sixMonthDebitTotalLessTransfers:
type: number
description:
Six month sum of all debit transactions without transfers for the
account
example: -500
twoMonthDebitTotal:
type: number
description: Two month sum of all debit transactions by account
example: -150
twoMonthDebitTotalLessTransfers:
type: number
description:
Two month sum of all debit transactions without transfers for the
account
example: -100
CashFlowMonthlyCashFlowCharacteristicSummaries:
required:
- month
- totalCreditsLessTotalDebits
- totalCreditsLessTotalDebitsLessTransfers
- averageTransactionAmount
type: object
properties:
month:
type: integer
description:
One instance for each complete calendar month in the report
format: int64
example: 1512111600
totalCreditsLessTotalDebits:
type: number
description: Total Credits - Total Debits by month across all accounts
example: 15000
totalCreditsLessTotalDebitsLessTransfers:
type: number
description:
Total Credits - Total Debits by month (Without Transfers) across all
accounts
example: 11000
averageTransactionAmount:
type: number
description: Average transaction amount across all accounts
example: 10
CashFlowCashFlowCharacteristicsSummary:
required:
- monthlyCashFlowCharacteristicSummaries
- averageMonthlyNet
- averageMonthlyNetLessTransfers
- twelveMonthTotalNet
- twelveMonthTotalNetLessTransfers
- sixMonthAverageTotalCreditsLessTotalDebits
- sixMonthAverageTotalCreditsLessTotalDebitsLessTransfers
- twoMonthAverageTotalCreditsLessTotalDebits
- twoMonthAverageTotalCreditsLessTotalDebitsLessTransfers
type: object
properties:
monthlyCashFlowCharacteristicSummaries:
type: array
items:
$ref: '#/components/schemas/CashFlowMonthlyCashFlowCharacteristicSummaries'
description: List of attributes for each month
averageMonthlyNet:
type: number
description: Average monthly net amount
example: 1250
averageMonthlyNetLessTransfers:
type: number
description: Average monthly net less transfers
example: 1000
twelveMonthTotalNet:
type: number
description:
Sum of all monthly (Total Credits - Total Debits) each month by the
account
example: 12500
twelveMonthTotalNetLessTransfers:
type: number
description:
Sum of all monthly (Total Credits - Total Debits) without transfers
by the account
example: 12400
sixMonthAverageTotalCreditsLessTotalDebits:
type: number
description:
6 Month Average (Total Credits - Total Debits) across all accounts
example: 55555
sixMonthAverageTotalCreditsLessTotalDebitsLessTransfers:
type: number
description:
6 Month Average (Total Credits - Total Debits) - (Without Transfers)
across all accounts
example: 55555
twoMonthAverageTotalCreditsLessTotalDebits:
type: number
description:
2 Month Average (Total Credits - Total Debits) across all accounts
example: 55555
twoMonthAverageTotalCreditsLessTotalDebitsLessTransfers:
type: number
description:
2 Month Average (Total Credits - Total Debits) - (Without Transfers)
across all accounts
example: 55555
CashFlowCashFlowCreditSummary:
required:
- monthlyCashFlowCreditSummaries
- twelveMonthCreditTotal
- twelveMonthCreditTotalLessTransfers
- sixMonthCreditTotal
- sixMonthCreditTotalLessTransfers
- twoMonthCreditTotal
- twoMonthCreditTotalLessTransfers
type: object
properties:
monthlyCashFlowCreditSummaries:
type: array
items:
$ref: '#/components/schemas/CashFlowMonthlyCashFlowCreditSummaries'
description: List of attributes for each month
twelveMonthCreditTotal:
type: number
description:
Sum of all credit transactions for each month for all accounts
example: 1200
twelveMonthCreditTotalLessTransfers:
type: number
description:
Sum of all monthly credit transactions without transfers for all
accounts
example: 1000
sixMonthCreditTotal:
type: number
description: Six month sum of all credit transactions
example: 750
sixMonthCreditTotalLessTransfers:
type: number
description:
Six month sum of all monthly credit transactions without transfers
for all accounts
example: 500
twoMonthCreditTotal:
type: number
description: Two month sum of all credit transactions
example: 150
twoMonthCreditTotalLessTransfers:
type: number
description:
Two month sum of all monthly credit transactions without transfers
for all accounts
example: 100
CashFlowMonthlycashflowDebits:
required:
- month
- numberOfDebits
- totalDebitsAmount
- largestDebit
- numberOfDebitsLessTransfers
- totalDebitsAmountLessTransfers
- averageDebitAmount
type: object
properties:
month:
type: integer
description:
One instance for each complete calendar month in the report
format: int64
example: 1512111600
numberOfDebits:
type: string
description: Number of Debits by month
example: '5'
totalDebitsAmount:
type: number
description: Total Amount of Debits by month
example: -12345
largestDebit:
type: number
description: Largest Debit by month
example: -2000
numberOfDebitsLessTransfers:
type: string
description: Number of Debits by month (less transfers)
example: '3'
totalDebitsAmountLessTransfers:
type: number
description: Total amount of debits by month (less transfers)
example: -2000
averageDebitAmount:
type: number
description: The average debit amount
example: 500
CashFlowCashFlowDebit:
required:
- monthlyCashFlowDebits
- twelveMonthDebitTotal
- twelveMonthDebitTotalLessTransfers
- sixMonthDebitTotal
- sixMonthDebitTotalLessTransfers
- twoMonthDebitTotal
- twoMonthDebitTotalLessTransfers
type: object
properties:
monthlyCashFlowDebits:
type: array
items:
$ref: '#/components/schemas/CashFlowMonthlycashflowDebits'
description: List of attributes for each month
twelveMonthDebitTotal:
type: number
description:
Sum of all monthly debit transactions for each month by account
example: 1200
twelveMonthDebitTotalLessTransfers:
type: number
description:
Sum of all monthly debit transactions without transfers for the
account
example: 1000
sixMonthDebitTotal:
type: number
description: Six month sum of all debit transactions
example: 750
sixMonthDebitTotalLessTransfers:
type: number
description:
Six month sum of all debit transactions without transfers for the
account
example: 500
twoMonthDebitTotal:
type: number
description: Two month sum of all debit transactions
example: 150
twoMonthDebitTotalLessTransfers:
type: number
description:
Two month sum of all debit transactions without transfers for the
account
example: 100
CashFlowCashFlowBalanceSummary:
required:
- monthlyCashFlowBalanceSummaries
- minDailyBalance
- maxDailyBalance
- twelveMonthAverageDailyBalance
- sixMonthAverageDailyBalance
- twoMonthAverageDailyBalance
- twelveMonthStandardDeviationOfDailyBalance
- sixMonthStandardDeviationOfDailyBalance
- twoMonthStandardDeviationOfDailyBalance
- numberOfDaysNegativeBalance
- numberOfDaysPositiveBalance
type: object
properties:
monthlyCashFlowBalanceSummaries:
type: array
items:
$ref: '#/components/schemas/CashFlowMonthlyCashFlowBalanceSummaries'
description: List of attributes for each month
minDailyBalance:
type: number
description:
Min Daily Balance across entire transaction history for all
accounts
example: 3479.39
maxDailyBalance:
type: number
description:
Max Daily Balance across entire transaction history for all accounts
example: 3479.39
twelveMonthAverageDailyBalance:
type: number
description:
Average Daily Balance across twelve months for all accounts
example: 3479.39
sixMonthAverageDailyBalance:
type: number
description: Average Daily Balance across six months for all accounts
example: 3479.39
twoMonthAverageDailyBalance:
type: number
description: Average Daily Balance across two months for all accounts
example: 3479.39
twelveMonthStandardDeviationOfDailyBalance:
type: string
description:
Standard Deviation of Daily Balance across twelve months for all
accounts
example: '20'
sixMonthStandardDeviationOfDailyBalance:
type: string
description:
Standard Deviation of Daily Balance across six months for all
accounts
example: '20'
twoMonthStandardDeviationOfDailyBalance:
type: string
description:
Standard Deviation of Daily Balance across two months for all
accounts
example: '20'
numberOfDaysNegativeBalance:
type: string
description:
Number of Days Negative Balance over entire transaction history for
all accounts
example: '6'
numberOfDaysPositiveBalance:
type: string
description:
Number of Days Positive Balance over entire transaction history for
all accounts
example: '11'
CashFlowMonthlyCashFlowBalanceSummaries:
required:
- month
- minDailyBalance
- maxDailyBalance
- averageDailyBalance
- standardDeviationOfDailyBalance
- numberOfDaysNegativeBalance
- numberOfDaysPositiveBalance
type: object
properties:
month:
type: integer
description:
One instance for each complete calendar month in the report
format: int64
example: 1512111600
minDailyBalance:
type: number
description: Min Daily Balance for each month for all accounts
example: 3479.39
maxDailyBalance:
type: number
description: Max Daily Balance for each month for all accounts
example: 3479.39
averageDailyBalance:
type: number
description: Average Daily Balance for each month for all accounts
example: 3479.39
standardDeviationOfDailyBalance:
type: string
description:
Standard Deviation of Daily Balance for each month for all accounts
example: '20.45454545'
numberOfDaysNegativeBalance:
type: string
description:
Number of Days Negative Balance for each month for all accounts
example: '6'
numberOfDaysPositiveBalance:
type: string
description:
Number of Days Positive Balance for each month for all accounts
example: '0'
CashFlowMonthlyCashFlowCreditSummaries:
required:
- month
- numberOfCredits
- totalCreditsAmount
- largestCredit
- numberOfCreditsLessTransfers
- totalCreditsAmountLessTransfers
- averageCreditAmount
- estimatedNumberOfLoanDeposits
- estimatedLoanDepositAmount
type: object
properties:
month:
type: integer
description:
One instance for each complete calendar month in the report
format: int64
example: 1512111600
numberOfCredits:
type: string
description: Number of credits by month across all accounts
example: '57'
totalCreditsAmount:
type: number
description: Total amount of credits by month across all accounts
example: 3479.39
largestCredit:
type: number
description: Largest credit by month across all accounts
example: 3000.49
numberOfCreditsLessTransfers:
type: string
description:
Number of credits by month (less transfers) across all accounts
example: '5'
totalCreditsAmountLessTransfers:
type: number
description:
Total amount of credits by month (less transfers) across all
accounts
example: 25.46
averageCreditAmount:
type: number
description: The average credit amount
example: 500
estimatedNumberOfLoanDeposits:
type: string
description: The estimated number of loan deposits by month
example: '0'
estimatedLoanDepositAmount:
type: number
description: The estimated loan deposit amount by month
example: 0
PrequalificationReport:
description: A Prequalification report
type: object
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
startDate:
$ref: '#/components/schemas/ReportStartDate'
endDate:
$ref: '#/components/schemas/ReportEndDate'
days:
type: integer
description: The number of days covered by the report
example: 230
seasoned:
type: boolean
description: '"true" if the report covers more than 180 days'
example: true
consolidatedAvailableBalance:
type: number
description:
The sum of available balance for all of the accounts included in
the report
example: 1929.57
institutions:
type: array
items:
$ref: '#/components/schemas/ReportInstitution'
description:
A list of institution records, including information about the
individual accounts in this report
assets:
$ref: '#/components/schemas/PrequalificationReportAssetSummary'
PrequalificationReportAccount:
type: object
properties:
id:
type: integer
description: The ID of the account
format: int64
example: 1000023996
number:
type: string
description:
The account number from the institution (all digits except the last
four are obfuscated)
example: '1111'
ownerName:
type: string
description:
The name of the account owner. If no owner information is available,
this field won't appear in the report.
example: JOHN DOE
ownerAddress:
type: string
description:
The mailing address of the account owner. If no owner information is
available, this field won't appear in the report.
example: 123 GAINSVILLE STREET BUFORD, GA 84937
name:
type: string
description: The account name from the institution
example: Checking
type:
type: string
description: One of the values from account types
example: checking
aggregationStatusCode:
type: integer
description: The status of the most recent aggregation attempt
format: int32
example: 0
balance:
type: number
description: The cleared balance of the account as-of `balanceDate`
example: 501.24
balanceDate:
type: integer
description: A timestamp of the balance
format: int64
example: 1588350276
availableBalance:
type: number
description: Available balance
example: 1000
averageMonthlyBalance:
type: number
description: The average monthly balance of the account
example: 501.02
totNumberInsufficientFundsFeeDebitTxAccount:
type: integer
description:
The count for the total number of insufficient funds transactions,
based on the `fromDate` of the report
format: int32
example: 0
totNumberInsufficientFundsFeeDebitTxOver6MonthsAccount:
type: integer
description:
The total number of insufficient funds fees for the account over
six months
format: int32
example: 0
totNumberDaysSinceMostRecentInsufficientFundsFeeDebitTxAccount:
type: integer
description:
The total number of days since the most recent insufficient funds
fee for the account
format: int64
example: 120
transactions:
type: array
items:
$ref: '#/components/schemas/ReportTransaction'
description: a list of transaction records
asset:
$ref: '#/components/schemas/PrequalificationReportAssetSummary'
details:
$ref: '#/components/schemas/AccountDetails'
PrequalificationReportAssetSummary:
required:
- currentBalance
- twoMonthAverage
- sixMonthAverage
- beginningBalance
type: object
properties:
type:
type: string
description:
'The asset type: "checking", "savings", "moneyMarket", "cd",
"investment"'
example: checking
availableBalance:
type: number
description: The available balance for the account
example: 1000
currentBalance:
type: number
description: The current balance of the account
example: 1000
twoMonthAverage:
type: number
description: The two month average daily balance of the account
example: -1865.96
sixMonthAverage:
type: number
description: The six month average daily balance of the account
example: -7616.01
beginningBalance:
type: number
description:
The beginning balance of the account per the time period of the
report
example: -17795.6
AccountDetails:
type: object
properties:
interestMarginBalance:
type: number
description:
Only available for investment accounts. Net interest earned after
deducting interest paid out.
example: -50000
availableCashBalance:
type: number
description:
Only available for investment accounts. Amount available for cash
withdrawal.
example: 1500
vestedBalance:
type: number
description:
Only available for investment accounts. Vested amount in account.
example: 300000
currentLoanBalance:
type: number
description:
Only available for investment accounts. Current loan balance.
example: 0
availableBalanceAmount:
type: number
description: The available balance for the account
example: 1000
PayStatementReport:
description: A Pay Statement report
type: object
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
startDate:
$ref: '#/components/schemas/ReportStartDate'
endDate:
$ref: '#/components/schemas/ReportEndDate'
reportStyle:
type: string
example: paystatement
numberOfBillableAssets:
type: integer
description:
Total number of billable pay statements included in the report
format: int32
example: 1
assetIds:
type: array
items:
$ref: '#/components/schemas/AssetId'
payStatements:
type: array
items:
$ref: '#/components/schemas/VOIEPayStatement'
description: Extracted pay statement details
VOIEPayStatement:
type: object
properties:
payPeriod:
type: string
description: The pay period of the pay statement
example: LastPayPeriod
billable:
type: boolean
description: Designates whether the pay statement is billable
example: true
assetId:
type: string
description: The asset ID of the stored pay statement
example: 6f8fb0a0-e882-4f57-b672-cf53f1397581
payDate:
type: integer
description: The listed pay date for the pay statement
format: int64
example: 1559241000
startDate:
type: integer
description: The beginning of the pay period
format: int64
example: 1557513000
endDate:
type: integer
description: The end of the pay period
format: int64
example: 1558722600
netPayCurrent:
type: number
description:
The total pay after deductions for the employee for the current pay
period
example: 1802.22
netPayYTD:
type: number
description:
The total accumulation of pay after deductions for the employee for
the current pay year
example: 36000
grossPayCurrent:
type: number
description:
The total pay before deductions for the employee for the current pay
period
example: 24200
grossPayYTD:
type: number
description:
The total accumulation of pay before deductions for the employee for
the current pay year
example: 72600
payrollProvider:
type: string
description: The company that provides the pay stub.
example: Finicity
employer:
$ref: '#/components/schemas/Employer'
employee:
$ref: '#/components/schemas/Employee'
payStat:
type: array
items:
$ref: '#/components/schemas/PayStat'
description:
Information pertaining to the earnings on the pay statement
deductions:
type: array
items:
$ref: '#/components/schemas/Deduction'
description: Information pertaining to deductions on the pay statement
directDeposits:
type: array
items:
$ref: '#/components/schemas/DirectDeposit'
description:
Information pertaining to direct deposits on the pay statement
Employer:
type: object
properties:
name:
type: string
description: The name of the employer
example: Rocket Surgery
Employee:
type: object
properties:
name:
type: string
description: The name of the employee
example: Patrick Purchaser
DirectDeposit:
type: object
properties:
amountCurrent:
type: number
description: The amount of the deposit
example: 1744.61
accountLastFour:
type: string
description:
The last four numbers of the account the deposit went into
example: '1234'
Deduction:
type: object
properties:
name:
type: string
description:
The normalized category of the deductions in the format
[type][number]. The number is the will be the iterating number of
the type's occurrence starting at one.
example: '401'
description:
type: string
description: The deduction line's deduction type description
example: 401k
amountCurrent:
type: number
description:
The amount for the deduction line deducted from employee's pay for
the specified pay period
example: 1744.61
amountYTD:
type: number
description:
The amount for the deduction line being deducted from the employee's
pay for the current pay year
example: 1744.6
type:
type: string
description: Categorization based on the deduction line's description
example: 401 Deductions
PayStat:
type: object
properties:
name:
type: string
description:
The normalized category of the earnings with a number appended. The
number is the will be the iterating number of the type's occurrence
starting at one.
example: regular 1
type:
$ref: '#/components/schemas/PayStatEarningsCategorizationType'
description:
type: string
description: The earnings line's pay type description
example: regular income
amountCurrent:
type: number
description:
The amount for the earning line paid out to the employee for the
specified pay period.
example: 6000
amountYTD:
type: number
description:
The amount for the earning line being paid out to the employee for
the current pay year.
example: 18000
PayStatEarningsCategorizationType:
type: string
description: >-
The categorization based on the earning line's description. Possible
values:
* "bereavement"
* "bonus"
* "commission"
* "holiday"
* "jury duty"
* "overtime"
* "pension"
* "pto"
* "regular"
* "sick"
* "tips"
* "unknown"
* "vacation"
* "reimbursement"
* "stock"
* "benefit"
StatementReport:
description: A Statement report
type: object
allOf:
- $ref: '#/components/schemas/BaseReportAck'
- type: object
properties:
assetId:
$ref: '#/components/schemas/AssetId'
TransactionsReport:
description: A Transactions report
type: object
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
startDate:
$ref: '#/components/schemas/ReportStartDate'
endDate:
$ref: '#/components/schemas/ReportEndDate'
days:
type: integer
description: Number of days covered by the report
format: int64
example: 174
seasoned:
type: boolean
description: '"true" if the report covers more than 365 days'
example: false
institutions:
type: array
items:
$ref: '#/components/schemas/ReportInstitution'
description: A list of institution records
VOAReport:
description: A VOA report
type: object
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
startDate:
$ref: '#/components/schemas/ReportStartDate'
endDate:
$ref: '#/components/schemas/ReportEndDate'
days:
type: integer
description: Number of days covered by the report
example: 180
seasoned:
type: boolean
description: '"true" if the report covers more than 180 days'
example: true
consolidatedAvailableBalance:
type: number
description:
The sum of available balance for all of the accounts included in
the report
example: 1929.57
institutions:
type: array
items:
$ref: '#/components/schemas/ReportInstitution'
description: A list of institution records
assets:
$ref: '#/components/schemas/PrequalificationReportAssetSummary'
VOAWithIncomeReport:
description: A VOA with income report
type: object
allOf:
- $ref: '#/components/schemas/VOAReport'
VOEPayrollReport:
description: A VOE Payroll report
type: object
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
employmentHistory:
type: array
items:
$ref: '#/components/schemas/PayrollEmploymentHistory'
description:
An array of employment histories, one for each of the consumer's
verified employers
PayrollEmploymentHistory:
required:
- asOfDate
- employerName
- payrollSource
- employee
- employment
- income
type: object
properties:
asOfDate:
type: integer
description:
The last time the payroll data was updated in the payroll provider's
system
format: int64
example: 1596175200
employerName:
type: string
description:
Name of the employer as stated by the employer in the payroll system
example: ACME INC
payrollSource:
type: string
description:
The name of the payroll source where the data was retrieved
example: finPayroll
employee:
$ref: '#/components/schemas/PayrollEmployeeRecord'
employment:
$ref: '#/components/schemas/PayrollEmploymentRecord'
income:
$ref: '#/components/schemas/PayrollVOEIncomeRecord'
PayrollVOEIncomeRecord:
required:
- payFrequency
type: object
properties:
payFrequency:
type: string
description:
'The current pay frequency:
* `Daily`
* `Weekly`
*
`Bi-Weekly`
* `Bi-Weekly Odd` (Bi-Weekly pay on odd weeks)
* `Bi-Weekly Even` (Bi-Weekly pay on even weeks)
*
`Semi-Monthly`
* `Monthly`
* `Quarterly`
*
`Semi-Annual`
* `Annual`
* `Every 2.6 wks`
* `Every
4 wks`
* `Every 5.2 wks`'
example: Weekly
PayrollEmployeeRecord:
required:
- name
- givenName
- familyName
type: object
properties:
name:
type: string
description:
'Full name of the employee: first, middle (if stated), and last name'
example: John Doe Smith
givenName:
type: string
description: First name of employee
example: John
middleName:
type: string
description: Middle name of employee, if stated
example: Doe
familyName:
type: string
description: Last name of employee
example: Smith
address:
type: array
items:
$ref: '#/components/schemas/PayrollEmployeeAddress'
description: Array of addresses
PayrollEmployerAddress:
type: object
properties:
address1:
type: string
description:
Employer address as stated by the employer in the payroll system
example: Address 1
city:
type: string
description:
Employer city as stated by the employer in the payroll system
example: City
state:
type: string
description:
Employer state as stated by the employer in the payroll system
example: TX
zip:
type: string
description:
Employer zip code as stated by the employer in the payroll system
example: '99999'
PayrollEmploymentRecord:
required:
- employerName
- latestPayDate
- daysSinceLastPay
- numberPayCadenceWithoutPay
- employmentStatusCode
- employmentStatusName
- workLevelStatus
type: object
properties:
employerName:
type: string
description:
Name of the employer as stated by the employer in the payroll system
example: ACME INC
legalEntityId:
type: string
description: Employer identification number (EIN)
example: '752760000'
originalHireDate:
type: integer
description: The original hired date of an employee at the company
format: int64
example: 1527832800
latestHireDate:
type: integer
description:
If an employee leaves the company and returns later, then the
employer states the latest hire date at the company
format: int64
example: 1527832800
latestPayDate:
type: integer
description: The most recent pay date from an employer
format: int64
example: 1596175200
daysSinceLastPay:
type: integer
description: The number of days since an employee was last paid
format: int32
example: 10
numberPayCadenceWithoutPay:
type: integer
description:
The number of pay cadences an employee has not been paid; determined
by the pay frequency
format: int32
example: 1
employmentEndDate:
type: integer
description:
The date an employee ended their employment at the company
format: int64
example: 1527832800
employmentDuration:
type: string
description:
The length of time an employee has been employed with that employer
in ISO 8601 format (eg P1Y6M0D)
example: P1Y6M0D
employerAddress:
type: array
items:
$ref: '#/components/schemas/PayrollEmployerAddress'
description: Array of addresses
employmentStatusCode:
type: string
description:
'Status codes: `A` - Active, `NLE` - No Longer Employed, `L` - Leave'
example: A
employmentStatusName:
type: string
description: 'Status name: `Active`, `No Longer Employed`, or `Leave`'
example: Active
workLevelCode:
type: string
description:
The abbreviate code for the employment level names (workLevelName)
that we receive from the employer
example: FT
workLevelName:
type: string
description:
The employment level name is whatever we receive from the employer,
such as full time, part time, temp, contractor, and more
example: Full Time-Regular
workLevelStatus:
type: string
description:
'The categorized work level status. Enumerations are:
*
`Temporary`
* `Seasonal`
* `Retired`
* `Student`
* `Full Time`
* `Part Time`
* `Unspecified`
This is a
new field, currently enabled only for testing reports. It will be
added for all reports in August 2021.'
example: Full Time
positionTitle:
type: string
description: Employee job title
example: Shift Supervisor
positionDuration:
type: string
description:
The length of time an employee has been employed at their current or
latest position for this employment in ISO 8601 format (eg P1Y6M0D)
example: P1Y6M0D
PayrollEmployeeAddress:
type: object
properties:
address1:
type: string
description:
Employee address as stated by the employer in the payroll system
example: Address 1
city:
type: string
description:
Employee city as stated by the employer in the payroll system
example: City
state:
type: string
description:
Employee state as stated by the employer in the payroll system
example: TX
zip:
type: string
description:
Employee zip code as stated by the employer in the payroll system
example: '99999'
VOETransactionsReport:
description: A VOE Transactions report
type: object
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
startDate:
$ref: '#/components/schemas/ReportStartDate'
endDate:
$ref: '#/components/schemas/ReportEndDate'
days:
type: integer
description: Number of days covered by the report
example: 120
seasoned:
type: boolean
description: '"true" if the report covers more than 180 days'
example: true
institutions:
type: array
items:
$ref: '#/components/schemas/ReportInstitution'
description:
A list of institution records, including information about the
individual accounts used in this report
VOIReport:
description: A VOI report
type: object
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
startDate:
$ref: '#/components/schemas/ReportStartDate'
endDate:
$ref: '#/components/schemas/ReportEndDate'
days:
type: integer
description: Number of days covered by the report
format: int64
example: 200
seasoned:
type: boolean
description: '"true" if the report covers more than 180 days'
example: true
institutions:
type: array
items:
$ref: '#/components/schemas/ReportInstitution'
description: A list of institution records
income:
type: array
items:
$ref: '#/components/schemas/ReportIncomeStreamSummary'
ReportIncomeStreamSummary:
required:
- confidenceType
- netMonthly
- incomeEstimate
type: object
properties:
confidenceType:
$ref: '#/components/schemas/EstimateInclusion'
netMonthly:
type: array
items:
$ref: '#/components/schemas/NetMonthly'
description: ''
incomeEstimate:
$ref: '#/components/schemas/ReportIncomeEstimate'
ReportIncomeEstimate:
required:
- netAnnual
- projectedNetAnnual
- estimatedGrossAnnual
- projectedGrossAnnual
type: object
properties:
netAnnual:
type: number
example: 1000.12
projectedNetAnnual:
type: number
example: 1500.23
estimatedGrossAnnual:
type: number
example: 2000.12
projectedGrossAnnual:
type: number
example: 2500.23
VOIEPayrollReport:
description: A VOIE Payroll report
type: object
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
employmentHistory:
type: array
items:
$ref: '#/components/schemas/PayrollEmploymentHistory'
description:
An array of employment histories, one for each of the consumer's
verified employers
VOIEPaystubReport:
description: A VOIE Paystub report
type: object
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
assetIds:
type: array
items:
$ref: '#/components/schemas/AssetId'
description: The pay statements included in the report
numberOfBillableAssets:
type: integer
description:
Total number of billable pay statements included in the report
format: int32
example: 1
payStatements:
type: array
items:
$ref: '#/components/schemas/VOIEPaystubWithStatementPayStatement'
description:
Extracted pay statement details, and the transaction matching
summary
VOIEPaystubWithStatementPayStatement:
required:
- payPeriod
- billable
- assetId
- payDate
- startDate
- endDate
- netPayCurrent
- netPayYTD
- grossPayCurrent
- grossPayYTD
- employer
- employee
- payStat
- directDeposits
- monthlyIncome
- institutions
type: object
properties:
payPeriod:
type: string
description: The pay period of the pay statement
example: LastPayPeriod
billable:
type: boolean
description:
This will display true if the pay statement is billable. If a pay
statement has been digitized previously, this will display as false
as it will not be billable.
example: true
assetId:
type: string
description: The asset ID of the stored pay statement
example: 6f8fb0a0-e882-4f57-b672-cf53f1397581
payDate:
type: integer
description: The listed pay date for the pay statement
format: int64
example: 1559241000
startDate:
type: integer
description: The beginning of the pay period
format: int64
example: 1557513000
endDate:
type: integer
description: The end of the pay period
format: int64
example: 1558722600
netPayCurrent:
type: number
description:
The total pay after deductions for the employee for the current pay
period
example: 1802.22
netPayYTD:
type: number
description:
The total accumulation of pay after deductions for the employee for
the current pay year
example: 36000
grossPayCurrent:
type: number
description:
The total pay before deductions for the employee for the current pay
period
example: 24200
grossPayYTD:
type: number
description:
The total accumulation of pay before deductions for the employee for
the current pay year
example: 72600
payrollProvider:
type: string
description: The payroll provider extracted from the pay statement
example: Finicity
employer:
$ref: '#/components/schemas/Employer'
employee:
$ref: '#/components/schemas/Employee'
payStat:
type: array
items:
$ref: '#/components/schemas/PayStat'
description:
Information pertaining to the earnings on the pay statement
directDeposits:
type: array
items:
$ref: '#/components/schemas/DirectDeposit'
description:
Information pertaining to the direct deposits on the pay statement
monthlyIncome:
$ref: '#/components/schemas/PaystubMonthlyIncomeRecord'
institutions:
type: array
items:
type: string
description:
Not populated for the voieWithStatement style of paystub report. For
the VOIE - Paystub (with TXVerify) reports this would include
details of the financial institution accounts and income streams
with matching transactions to the pay statement.
example: []
errorCode:
type: integer
description: Error code for the asset
format: int32
errorMessage:
type: string
description: Error message for the asset
PaystubMonthlyIncomeRecord:
type: object
properties:
estimatedMonthlyBasePay:
type: number
description:
The estimated monthly base pay amount for the employment from the
paystub, calculated by Finicity
example: 2000
estimatedMonthlyOvertimePay:
type: number
description:
The estimated monthly overtime pay amount for the employment from
the paystub, calculated by Finicity
example: 50
estimatedMonthlyBonusPay:
type: number
description:
The estimated monthly bonus pay amount for the employment from the
paystub, calculated by Finicity
example: 20
estimatedMonthlyCommissionPay:
type: number
description:
The estimated commission bonus pay amount for the employment from
the paystub, calculated by Finicity
example: 50
VOIEPaystubWithTXVerifyReport:
description: A VOIE Paystub With TXVerify report
type: object
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
assetIds:
type: array
items:
$ref: '#/components/schemas/AssetId'
description: The pay statements included in the report
numberOfBillableAssets:
type: integer
description:
Total number of billable pay statements included in the report
format: int32
example: 1
payStatements:
type: array
items:
$ref: '#/components/schemas/VOIEPaystubWithStatementPayStatement'
description:
Extracted pay statement details, and the transaction matching
summary
institutions:
type: array
items:
$ref: '#/components/schemas/ReportInstitution'
description:
The details of the financial institution accounts included in
the report.
ReportSummary:
required:
- id
- requestId
- requesterName
- createdDate
- consumerId
- consumerSsn
- type
- status
properties:
id:
$ref: '#/components/schemas/ReportId'
requestId:
$ref: '#/components/schemas/ReportRequestId'
requesterName:
$ref: '#/components/schemas/PartnerName'
createdDate:
$ref: '#/components/schemas/UnixDate'
consumerId:
$ref: '#/components/schemas/ConsumerId'
consumerSsn:
$ref: '#/components/schemas/SocialSecurityNumberLastDigits'
type:
$ref: '#/components/schemas/ReportType'
status:
$ref: '#/components/schemas/ReportStatus'
# constraints:
# oneOf:
# - $ref: '#/components/schemas/PayStatementReportConstraints'
# - $ref: '#/components/schemas/StatementReportConstraints'
# - $ref: '#/components/schemas/TransactionsReportConstraintsOut'
# - $ref: '#/components/schemas/VOAReportConstraintsOut'
# - $ref: '#/components/schemas/VOAWithIncomeReportConstraintsOut'
# - $ref: '#/components/schemas/PrequalificationReportConstraintsOut'
# - $ref: '#/components/schemas/VOIReportConstraintsOut'
# - $ref: '#/components/schemas/PayrollReportConstraintsOut'
# - $ref: '#/components/schemas/VOIEWithTXVerifyReportConstraintsOut'
# - $ref: '#/components/schemas/VOIEReportConstraints'
# - $ref: '#/components/schemas/VOETransactionsReportConstraintsOut'
# - $ref: '#/components/schemas/CashFlowReportConstraintsOut'
VOIEWithInterviewData:
required:
- txVerifyInterview
type: object
properties:
txVerifyInterview:
description: An array of `TxVerifyInterview` objects
type: array
items:
$ref: '#/components/schemas/TxVerifyInterview'
extractEarnings:
$ref: '#/components/schemas/ExtractEarnings'
extractDeductions:
$ref: '#/components/schemas/ExtractDeductions'
extractDirectDeposit:
$ref: '#/components/schemas/ExtractDirectDeposit'
TxPushSubscriptionParameters:
required:
- callbackUrl
type: object
properties:
callbackUrl:
$ref: '#/components/schemas/TxPushCallbackUrl'
TransactionType:
type: string
description: >-
If provided by the institution, the following values may be returned in
the field of a record:
* "atm"
* "cash"
* "check"
* "credit"
* "debit"
* "deposit"
* "directDebit"
* "directDeposit"
* "dividend"
* "fee"
* "interest"
* "other"
* "payment"
* "pointOfSale"
* "repeatPayment"
* "serviceCharge"
* "transfer"
example: atm
PayStatement:
description: A pay statement document and pay statement label
required:
- label
- statement
type: object
properties:
label:
type: string
description: >-
The label to be associated with the pay statement. This label will
allow the paystub to go through data extraction.
* `lastPayPeriod`: default label that should be used for the VOIE -
Paystub products
* `lastPayPeriodMinusOne`: the second most recent pay statement
* `lastPayPeriodMinusTwo`: the third most recent pay statement
* `previousYearLastPayPeriod` Last pay statement of the previous
calendar year
* `previousYear2LastPayPeriod`: last pay statement of the calendar
year 2 years prior
* `earliestPayPeriod`: the earliest pay statement
example: lastPayPeriod
statement:
type: string
description:
A Base64 encoded pay statement file. Finicity supports PDF, JPG, or
PNG files.
example: 'VGhpcyBtdXN0IGJlIGFuIGltYWdl'
ReportStatus:
type: string
description:
'A report generation status. Possible values: "inProgress", "success",
"failure".'
example: inProgress
ReportType:
description: >-
A report type. Possible values:
* "voi"
* "voa"
* "voaHistory"
* "history"
* "voieTxVerify"
* "voieWithReport"
* "voieWithInterview"
* "paystatement"
* "preQualVoa"
* "assetSummary"
* "voie"
* "transactions"
* "statement"
* "voiePayroll"
* "voeTransactions"
* "voePayroll"
* "cfrp"
* "cfrb"
type: string
example: voi
LoanPaymentDetails:
description: Loan payment details for a customer account
required:
- loanNumber
- loanPaymentNumber
- loanPaymentAddress
type: object
properties:
loanNumber:
type: string
description: The number of the specific loan under the account.
example: '123456789'
loanPaymentNumber:
type: string
description: >-
The payment number given by the institution. This number is
typically for manual payments. This is not an ACH payment number.
example: '5231123456789'
loanPaymentAddress:
type: string
description: The payment address to send manual payments to
example: Heartland ECSI PO Box 718 Wexford PA 15090
accountDetail:
$ref: '#/components/schemas/LoanPaymentDetailsAccount'
Asset:
description: An asset
required:
- assetId
type: object
properties:
assetId:
$ref: '#/components/schemas/AssetId'
TxPushSubscriptions:
required:
- subscriptions
type: object
properties:
subscriptions:
type: array
items:
$ref: '#/components/schemas/SubscriptionRecord'
SubscriptionRecord:
required:
- id
- accountId
- type
- callbackUrl
- signingKey
type: object
properties:
id:
$ref: '#/components/schemas/SubscriptionId'
accountId:
$ref: '#/components/schemas/NumericAccountId'
type:
$ref: '#/components/schemas/SubscriptionType'
callbackUrl:
$ref: '#/components/schemas/TxPushCallbackUrl'
signingKey:
type: string
description: Signing key for events
example: 'zg4U0v1IvTzFEHIXzJMxPHnfUwWZAMVpXrUuNuL9IvZI0QzkDdwp39IAKuNOFxOVqCOgHLMS1Zpe4ZL40NX83aJkqI6v0Ez5B7BLBtvr7Ag11kPH3uG1taTeOV0CTyI4LOg7ohSHn0DqaRu2aBq26KI90nYe0CecTCzzhu4yMXL43JV8YfydAexNdkzfg8tY44MlhBPUh2neHW2EFTT2ja4s4Ul10JgID03un8WBSrIm2adHw3QYJB4jk4k1e'
description: TxPush subscription details
CreatedTestTxPushTransaction:
required:
- id
- createdDate
type: object
properties:
id:
$ref: '#/components/schemas/TransactionId'
createdDate:
$ref: '#/components/schemas/UnixDate'
description: Response for TxPush test transaction
ACHDetails:
required:
- routingNumber
- realAccountNumber
type: object
properties:
routingNumber:
type: string
description: >-
The routing number of the financial institution for this specific
customers account
example: '123456789'
realAccountNumber:
type: string
description:
The account number for initiating ACH transfers for this account
example: '002345678901'
description:
The routing and account number information to initiate ACH transfers
PayStatementReportConstraints:
required:
- paystatementReport
type: object
properties:
paystatementReport:
$ref: '#/components/schemas/PayStatementData'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
CashFlowReportConstraints:
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIdsString'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
showNsf:
$ref: '#/components/schemas/ShowNsf'
fromDate:
# Without this parameter, the report defaults to 61 days if available
# If included, the epoch timestamp should be 10 digits long and be within
# two years of the present day
$ref: '#/components/schemas/UnixDate'
incomeStreamConfidenceMinimum:
$ref: '#/components/schemas/IncomeStreamConfidenceMinimum'
CashFlowReportConstraintsOut:
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIds'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
showNsf:
$ref: '#/components/schemas/ShowNsf'
fromDate:
# Without this parameter, the report defaults to 61 days if available
# If included, the epoch timestamp should be 10 digits long and be within
# two years of the present day
$ref: '#/components/schemas/UnixDate'
incomeStreamConfidenceMinimum:
$ref: '#/components/schemas/IncomeStreamConfidenceMinimum'
PayStatementReportAck:
required:
- id
- portfolioId
- customerType
- customerId
- requestId
- requesterName
- createdDate
- title
- consumerId
- consumerSsn
- type
- status
- constraints
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
constraints:
$ref: '#/components/schemas/PayStatementReportConstraints'
CashFlowReportAck:
required:
- id
- customerType
- customerId
- requestId
- requesterName
- createdDate
- title
- consumerId
- consumerSsn
- type
- status
- constraints
allOf:
- $ref: '#/components/schemas/BaseReportAck'
- type: object
properties:
constraints:
$ref: '#/components/schemas/CashFlowReportConstraintsOut'
VOIEWithTXVerifyReportConstraints:
required:
- voieWithInterviewData
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIdsString'
voieWithInterviewData:
$ref: '#/components/schemas/VOIEWithInterviewData'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
fromDate:
# Without this parameter, the report defaults to 61 days if available
# If included, the epoch timestamp should be 10 digits long and be within
# two years of the present day
$ref: '#/components/schemas/UnixDate'
incomeStreamConfidenceMinimum:
$ref: '#/components/schemas/IncomeStreamConfidenceMinimum'
VOIEWithTXVerifyReportConstraintsOut:
required:
- voieWithInterviewData
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIds'
voieWithInterviewData:
$ref: '#/components/schemas/VOIEWithInterviewData'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
fromDate:
$ref: '#/components/schemas/UnixDate'
incomeStreamConfidenceMinimum:
$ref: '#/components/schemas/IncomeStreamConfidenceMinimum'
VOIEPaystubWithTXVerifyReportAck:
required:
- id
- portfolioId
- customerType
- customerId
- requestId
- requesterName
- createdDate
- title
- consumerId
- consumerSsn
- type
- status
- constraints
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
constraints:
$ref: '#/components/schemas/VOIEWithTXVerifyReportConstraintsOut'
AggregationStatusCode:
type: integer
description:
The status of the most recent aggregation attempt (see [Aggregation
Status Codes](https://docs.finicity.com/aggregation-status-codes/)).
Won't be present until you have run your first aggregation for the
account.
AccountType:
type: string
description: >-
The list of supported account types.
* "checking": Standard checking
* "savings": Standard savings
* "cd": Certificates of deposit
* "moneyMarket": Money Market
* "creditCard": Standard credit cards
* "lineOfCredit": Home equity, line of credit
* "investment": Generic investment (no details)
* "investmentTaxDeferred": Generic tax-advantaged investment (no
details)
* "employeeStockPurchasePlan": ESPP, Employee Stock Ownership Plans
(ESOP), Stock Purchase Plans
* "ira": Individual Retirement Account (not Rollover or Roth)
* "401k": 401K Plan
* "roth": Roth IRA, Roth 401K
* "403b": 403B Plan
* "529plan": 529 Plan (True value is 529)
* "rollover": Rollover IRA
* "ugma": Uniform Gifts to Minors Act
* "utma": Uniform Transfers to Minors Act
* "keogh": Keogh Plan
* "457plan": 457 Plan (True value is 457)
* "401a": 401A Plan
* "brokerageAccount": Brokerage Account
* "educationSavings": Education Savings Account that is not a 529
* "healthSavingsAccount": HSA (Health Savings Accounts)
* "pension": Pension
* "profitSharingPlan": Profit Sharing Plan
* "roth401k": Roth 401K
* "sepIRA": Simplified Employee Pension IRA
* "simpleIRA": Simple IRA
* "thriftSavingsPlan": Thrift Savings Plan
* "variableAnnuity": Variable Annuity
* "cryptocurrency": Cryptocurrency Wallet, Cryptocurrency Account
* "mortgage": Standard Mortgages
* "loan": Auto loans, equity loans, other loans
* "studentLoan": Student Loan
* "studentLoanGroup": Student Loan Group
* "studentLoanAccount": Student Loan Account
example: checking
Transactions:
description: A list of transactions
required:
- found
- displaying
- moreAvailable
- fromDate
- toDate
- sort
- transactions
type: object
properties:
found:
$ref: '#/components/schemas/FoundResults'
displaying:
$ref: '#/components/schemas/DisplayingResults'
moreAvailable:
$ref: '#/components/schemas/MoreResultsAvailable'
fromDate:
$ref: '#/components/schemas/UnixDate'
toDate:
$ref: '#/components/schemas/UnixDate'
sort:
type: string
description:
Value of the sort request parameter that generated this response
example: desc
transactions:
description: The array of transactions
type: array
items:
$ref: '#/components/schemas/Transaction'
TestTxPushTransaction:
description: A fake transaction for TxPush testing
required:
- amount
- description
- transactionDate
type: object
properties:
amount:
type: number
description: The amount of the transaction
example: -4.25
description:
type: string
description: The description of the transaction
example: a testing transaction description
status:
type: string
description: '"active" or "pending" (optional)'
default: active
example: pending
postedDate:
# A timestamp for the transaction's posted date value for
# this transaction. Timestamp must be
# no more than 6 months from the current date.
$ref: '#/components/schemas/UnixDate'
transactionDate:
$ref: '#/components/schemas/UnixDate'
TransactionsReportAck:
required:
- id
- portfolioId
- customerType
- customerId
- requestId
- requesterName
- createdDate
- title
- consumerId
- consumerSsn
- type
- status
- constraints
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
constraints:
$ref: '#/components/schemas/TransactionsReportConstraintsOut'
TransactionsReportConstraints:
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIdsString'
fromDate:
# Without this parameter, the report defaults to 61 days if available
# If included, the epoch timestamp should be 10 digits long and be within
# two years of the present day
$ref: '#/components/schemas/UnixDate'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
TransactionsReportConstraintsOut:
type: object
properties:
accountIds:
$ref: '#/components/schemas/ReportAccountIds'
fromDate:
# Without this parameter, the report defaults to 61 days if available
# If included, the epoch timestamp should be 10 digits long and be within
# two years of the present day
$ref: '#/components/schemas/UnixDate'
toDate:
# The ending timestamp for the date range. The value must be greater than `fromDate`
$ref: '#/components/schemas/UnixDate'
includePending:
$ref: '#/components/schemas/IncludePending'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
PortfolioConsumer:
required:
- id
- firstName
- lastName
- customerId
- ssn
- birthday
type: object
properties:
id:
$ref: '#/components/schemas/ConsumerId'
firstName:
$ref: '#/components/schemas/FirstName'
lastName:
$ref: '#/components/schemas/LastName'
customerId:
$ref: '#/components/schemas/NumericCustomerId'
ssn:
$ref: '#/components/schemas/SocialSecurityNumber'
birthday:
$ref: '#/components/schemas/Birthday'
suffix:
$ref: '#/components/schemas/Suffix'
StatementReportConstraints:
required:
- statementReportData
type: object
properties:
statementReportData:
$ref: '#/components/schemas/StatementData'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
StatementData:
required:
- accountId
type: object
properties:
accountId:
# Account to retrieve the statement for and display in the report.
$ref: '#/components/schemas/NumericAccountId'
index:
type: integer
description: Index of the statement to retrieve
format: int32
example: 1
default: 1
maximum: 6
StatementReportAck:
required:
- id
- portfolioId
- customerType
- customerId
- requestId
- requesterName
- createdDate
- title
- consumerId
- consumerSsn
- type
- status
- constraints
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
constraints:
$ref: '#/components/schemas/StatementReportConstraints'
PayrollData:
required:
- ssn
- dob
type: object
properties:
ssn:
$ref: '#/components/schemas/SocialSecurityNumberNoHyphens'
dob:
$ref: '#/components/schemas/ConsumerDateOfBirth'
reportId:
# The Report Id of the original VOIE Payroll report
$ref: '#/components/schemas/ReportId'
PayrollReportAck:
required:
- id
- portfolioId
- customerType
- customerId
- requestId
- requesterName
- createdDate
- title
- consumerId
- consumerSsn
- type
- status
- constraints
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
constraints:
$ref: '#/components/schemas/PayrollReportConstraintsOut'
PayrollReportConstraintsOut:
required:
- payrollData
type: object
properties:
payrollData:
$ref: '#/components/schemas/PayrollDataOut'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
payStatementsFromDate:
$ref: '#/components/schemas/UnixDate'
PayrollDataOut:
required:
- payrollDataRetrievalId
- employerNames
type: object
properties:
payrollDataRetrievalId:
type: string
description: >-
An id to identify the data retrieved from the payroll providers for
the report.
example: hahvhe2k0000
employerNames:
type: array
items:
type: string
example: 'Enterprise One'
description: >-
An array of employer names that the consumer submitted after
completing the Connect application.
reportId:
# The Report Id of the original VOIE Payroll report
$ref: '#/components/schemas/ReportId'
PayrollReportConstraints:
required:
- payrollData
type: object
properties:
payrollData:
$ref: '#/components/schemas/PayrollData'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
payStatementsFromDate:
# Limits the pay statement history in the VOIE β Payroll
# report by entering a pay statement history start date.
# Pay statements are included if the `payDate` of the statement
# is equal to or greater than the start date
$ref: '#/components/schemas/UnixDate'
AvailableBalance:
required:
- id
- realAccountNumberLast4
- availableBalance
- availableBalanceDate
- clearedBalance
- clearedBalanceDate
- aggregationStatusCode
- currency
type: object
properties:
id:
$ref: '#/components/schemas/NumericCustomerId'
realAccountNumberLast4:
$ref: '#/components/schemas/AccountNumberLast4'
availableBalance:
type: number
description: The available balance of the account
example: 173.47
availableBalanceDate:
$ref: '#/components/schemas/UnixDate'
clearedBalance:
type: number
description: >-
The cleared balance of the account. Also referred as posted balance,
current balance, ledger balance
example: 222.25
clearedBalanceDate:
$ref: '#/components/schemas/UnixDate'
aggregationStatusCode:
$ref: '#/components/schemas/AggregationStatusCode'
currency:
# The currency of the account
$ref: '#/components/schemas/Currency'
VOIEWithStatementData:
required:
- assetIds
type: object
properties:
assetIds:
description: A list of pay statement asset IDs
type: array
items:
$ref: '#/components/schemas/AssetId'
extractEarnings:
$ref: '#/components/schemas/ExtractEarnings'
extractDeductions:
$ref: '#/components/schemas/ExtractDeductions'
extractDirectDeposit:
$ref: '#/components/schemas/ExtractDirectDeposit'
VOIEReportConstraints:
required:
- voieWithStatementData
type: object
properties:
voieWithStatementData:
$ref: '#/components/schemas/VOIEWithStatementData'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
description: >-
The request details from the report generation that were used to
generate the report
VOIEPaystubReportAck:
required:
- id
- portfolioId
- customerType
- customerId
- requestId
- requesterName
- createdDate
- title
- consumerId
- consumerSsn
- type
- status
- constraints
type: object
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
constraints:
$ref: '#/components/schemas/VOIEReportConstraints'
VOETransactionsReportConstraints:
type: object
properties:
reportId:
# The Report Id of the original VOAI report or VOIE - Paystub (with
# TXVerify) report. This is an optional field and if included only the
# accounts from the report would be included in the VOE - Transactions
# report, otherwise all accounts for the consumer would be considered.
$ref: '#/components/schemas/ReportId'
accountIds:
$ref: '#/components/schemas/ReportAccountIdsString'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
fromDate:
# Without this parameter, the report defaults to 61 days if available
# If included, the epoch timestamp should be 10 digits long and be within
# two years of the present day
$ref: '#/components/schemas/UnixDate'
incomeStreamConfidenceMinimum:
$ref: '#/components/schemas/IncomeStreamConfidenceMinimum'
VOETransactionsReportConstraintsOut:
type: object
properties:
reportId:
$ref: '#/components/schemas/ReportId'
accountIds:
$ref: '#/components/schemas/ReportAccountIds'
reportCustomFields:
$ref: '#/components/schemas/ReportCustomFields'
fromDate:
$ref: '#/components/schemas/UnixDate'
incomeStreamConfidenceMinimum:
$ref: '#/components/schemas/IncomeStreamConfidenceMinimum'
VOETransactionsReportAck:
required:
- id
- portfolioId
- customerType
- customerId
- requestId
- requesterName
- createdDate
- title
- consumerId
- consumerSsn
- type
- status
- constraints
allOf:
- $ref: '#/components/schemas/BaseReportAckWithPortfolioId'
- type: object
properties:
constraints:
$ref: '#/components/schemas/VOETransactionsReportConstraintsOut'
LoanPaymentDetailsAccount:
required:
- accountId
- accountNumber
- accountPaymentNumber
- accountPaymentAddress
type: object
properties:
accountId:
# ID of the Student Loan Account
$ref: '#/components/schemas/AccountId'
accountNumber:
type: string
description: Institution's ID of the Student Loan Account
example: '9876543210'
accountPaymentNumber:
type: string
description: >-
The payment number given by the institution. This number is
typically for manual payments. This is not an ACH payment number.
example: 00001234895413
accountPaymentAddress:
type: string
description:
The payment address to which send manual payments should be sent
example: 'P.O. Box 123 Sioux Falls, IA 51054'
accountFuturePayoffAmount:
type: number
description: The payoff amount for the account
example: 10000
accountFuturePayoffDate:
type: string
description: The date to which the "Future Payoff Amount" applies
format: date-time
example: '2022-01-01T00:00:00.000Z'
groupDetail:
description: Group details
type: array
items:
$ref: '#/components/schemas/LoanPaymentDetailsGroup'
loanDetail:
description: Loan details
type: array
items:
$ref: '#/components/schemas/LoanPaymentDetailsLoan'
LoanPaymentDetailsGroup:
description: Group details
required:
- accountId
- groupNumber
- groupPaymentNumber
- groupPaymentAddress
- groupLoanDetail
type: object
properties:
accountId:
# ID of the Student Loan Group
$ref: '#/components/schemas/AccountId'
groupNumber:
type: string
description: Institution's ID of the Student Loan Group
example: 3210-Group A
groupPaymentNumber:
type: string
description: >-
The payment number given by the institution. This number is
typically for manual payments. This is not an ACH payment number.
example: 00001234895413-A
groupPaymentAddress:
type: string
description:
The payment address to which send manual payments should be sent
example: 'P.O. Box 123 Sioux Falls, IA 51054'
groupFuturePayoffAmount:
type: number
description: The payoff amount for the group
example: 7500
groupFuturePayoffDate:
type: string
description: The date to which the "Future Payoff Amount" applies
format: date-time
example: '2022-01-01T00:00:00.000Z'
groupLoanDetail:
type: array
items:
$ref: '#/components/schemas/LoanPaymentDetailsLoan'
LoanPaymentDetailsLoan:
description: Loan details
required:
- accountId
- loanNumber
- loanPaymentNumber
- loanPaymentAddress
type: object
properties:
accountId:
# ID of the Student Loan
$ref: '#/components/schemas/AccountId'
loanNumber:
type: string
description: Institution's ID of the Student Loan
example: 3210-Group A-1
loanPaymentNumber:
type: string
description: >-
The payment number given by the institution. This number is
typically for manual payments. This is not an ACH payment number.
example: 00001234895413-A-1
loanPaymentAddress:
type: string
description:
The payment address to which send manual payments should be sent
example: 'P.O. Box 123 Sioux Falls, IA 51054'
loanFuturePayoffAmount:
type: number
description: The payoff amount for the loan
example: 5000
loanFuturePayoffDate:
type: string
description: The date to which the "Future Payoff Amount" applies
format: date-time
example: '2022-01-01T00:00:00.000Z'
ConsumerAttributesAnalyticId:
description: An analytic ID and a date
required:
- analytic_id
- created_date
type: object
properties:
analytic_id:
$ref: '#/components/schemas/AnalyticId'
created_date:
$ref: '#/components/schemas/NoZoneDateTime'
ConsumerAttributeList:
required:
- analytic_ids
type: object
properties:
analytic_ids:
description: A list of analytic IDs
type: array
items:
$ref: '#/components/schemas/ConsumerAttributesAnalyticId'
ConsumerAttributesDataDateRange:
required:
- From
- To
type: object
properties:
From:
# The "from" date of the date range for the report
$ref: '#/components/schemas/Date'
To:
# The "to" date of the date range for the report
$ref: '#/components/schemas/Date'
ConsumerAttributesData:
required:
- dateRange
- income
- expenses
- netAmount
- nsf
- assets
- liabilities
type: object
properties:
customerId:
$ref: '#/components/schemas/CustomerId'
accountIds:
type: array
items:
$ref: '#/components/schemas/NumericAccountId'
dateRange:
$ref: '#/components/schemas/ConsumerAttributesDataDateRange'
income:
$ref: '#/components/schemas/ConsumerAttributesDataIncome'
expenses:
$ref: '#/components/schemas/ConsumerAttributesDataExpenses'
netAmount:
$ref: '#/components/schemas/ConsumerAttributesDataNetAmount'
nsf:
$ref: '#/components/schemas/ConsumerAttributesDataNSF'
assets:
$ref: '#/components/schemas/ConsumerAttributesDataAssets'
liabilities:
$ref: '#/components/schemas/ConsumerAttributesDataLiabilities'
ConsumerAttributesDataIncome:
required:
- netAnnualIncome
- netAnnualIncomeByAccount
- monthlyNetIncome
- monthlyNetIncomeByAccount
type: object
properties:
netAnnualIncome:
type: number
description:
Net annual of all income by customer for the last 12 months
example: 68068.25
netAnnualIncomeByAccount:
type: object
description: Net annual of income by account for the last 12 months
example:
'5001861692': 229.28
'5001861693': 67838.97
monthlyNetIncome:
type: object
description: Net monthly income by customer for the last 12 months
example:
'2021-03-31': 2925.73
'2021-04-30': 2562.52
'2021-05-31': 2562.96
'2021-06-30': 2620.28
'2021-07-31': 2770.59
'2021-08-31': 2736.4
'2021-09-30': 2629.26
'2021-10-31': 2836.89
'2021-11-30': 1450.15
'2021-12-31': 1560.06
'2022-01-31': 3897.18
'2022-02-28': 2824.58
monthlyNetIncomeByAccount:
type: object
description: Net monthly income by account for the last 12 months
example:
'5001861692':
'2021-06-30': 57.32
'2021-07-31': 57.32
'2021-08-31': 57.32
'2021-11-30': 57.32
'5001861693':
'2021-03-31': 2925.73
'2021-04-30': 2562.52
'2021-05-31': 2562.96
'2021-06-30': 2620.28
'2021-07-31': 2770.59
'2021-08-31': 2736.4
'2021-09-30': 2629.26
'2021-10-31': 2836.89
'2021-11-30': 1450.15
'2021-12-31': 1560.06
'2022-01-31': 3897.18
'2022-02-28': 2824.58
ConsumerAttributesDataExpenses:
required:
- dwellingExpenseTotal
- dwellingExpensesByAccount
- monthlyDwellingExpenseByCustomer
- monthlyDwellingExpenseByAccount
- monthlyDebitAmountByCustomer
- monthlyExpenseAmountByCustomer
type: object
properties:
dwellingExpenseTotal:
type: number
description: >-
Total dwelling expenses for the last 12 months: rent, mortgage,
utilities, and insurance
example: 0
dwellingExpensesByAccount:
type: object
description: >-
Total dwelling expenses by account for the last 12 months: rent,
mortgage, utilities, and insurance
example:
'5001861693': -5856.07
monthlyDwellingExpenseByCustomer:
type: object
description: Monthly dwelling expenses by customer
example:
'2021-03-31': -217.37
'2021-04-30': -146.25
'2021-05-31': -205.86
'2021-06-30': -309.84
'2021-07-31': -593.07
'2021-08-31': -202.1
'2021-09-30': -243.55
'2021-10-31': -136.96
'2021-11-30': -145.37
'2021-12-31': -261.35
'2021-01-31': -172.99
'2021-02-28': -176.96
monthlyDwellingExpenseByAccount:
type: object
description: Monthly dwelling expenses by account
example:
'5001861693':
'2021-03-31': -217.37
'2021-04-30': -146.25
'2021-05-31': -205.86
'2021-06-30': -309.84
'2021-07-31': -593.07
'2021-08-31': -202.1
'2021-09-30': -243.55
'2021-10-31': -136.96
'2021-11-30': -145.37
'2021-12-31': -261.35
'2021-01-31': -172.99
'2021-02-28': -176.96
monthlyDebitAmountByCustomer:
type: object
description: Total monthly debit amounts by customer
example:
'2021-03-31': -7259.58
'2021-04-30': -15368.09
'2021-05-31': -11937.66
'2021-06-30': -12704.43
'2021-07-31': -9089.55
'2021-08-31': -4099.97
'2021-09-30': -19627.13
'2021-10-31': -9927.53
'2021-11-30': -7694.94
'2021-12-31': -37310.54
'2021-01-31': -25129.31
'2021-02-28': -9548.28
monthlyExpenseAmountByCustomer:
type: object
description: >-
Total monthly debit amounts, excluding transfers and credit card
payments
example:
'2021-03-31': -7259.58
'2021-04-30': -15368.09
'2021-05-31': -11937.66
'2021-06-30': -12704.43
'2021-07-31': -9089.55
'2021-08-31': -4099.97
'2021-09-30': -19627.13
'2021-10-31': -9927.53
'2021-11-30': -7694.94
'2021-12-31': -37310.54
'2021-01-31': -25129.31
'2021-02-28': -9548.28
ConsumerAttributesDataNSF:
required:
- monthlyNSFOccurrences
- monthlyLateFeeOccurrences
type: object
properties:
monthlyNSFOccurrences:
type: object
description:
The number of non-sufficient funds occurrences per calendar month
example:
'2021-04-30': 1
'2021-07-31': 1
monthlyLateFeeOccurrences:
type: object
description: The number of late fee occurrences
example: {}
ConsumerAttributesDataLiabilities:
required:
- monthlyLoanDeposits
- monthlyLoanWitdrawls
- monthlyNumberOfLoanDeposits
- monthlyNumberOfLoanWithdrawls
type: object
properties:
monthlyLoanDeposits:
type: object
description: Monthly loan deposits amount by account
example:
3-2021: 2799.08
4-2021: 2947.63
5-2021: 2863.37
monthlyLoanWitdrawls:
type: object
description: Monthly loan withdrawal amount by account
example:
3-2021: -150.17
4-2021: -95.03
5-2021: -341.26
monthlyNumberOfLoanDeposits:
type: object
description: Monthly count of the number of loan deposits by account
example:
3-2021: 1
4-2021: 1
5-2021: 1
monthlyNumberOfLoanWithdrawls:
type: object
description: Monthly amount of the number of loan deposits by account
example:
3-2021: 1
4-2021: 1
5-2021: 1
ConsumerAttributesAssetsCustomer:
required:
- monthlyMinimumBalance
- monthlyMaximumBalance
- monthlyAverageBalance
- monthlyStandardDeviationOfBalance
- monthlyDaysWithPositiveBalance
- monthlyDaysWithNegativeBalance
- monthlyTwoMonthAverageBalance
- monthlySixMonthAverageBalance
- twelveMonthAverageBalance
- twoMonthStandardDeviationOfBalance
- sixMonthStandardDeviationOfBalance
- twelveMonthStandardDeviationOfBalance
type: object
properties:
monthlyMinimumBalance:
type: object
description:
The minimum balance for the month across all customer accounts
example:
'2021-03-31': 20841.81
'2021-04-30': 16014.16
'2021-05-31': 16949.55
'2021-06-30': 645.01
'2021-07-31': 702.33
'2021-08-31': -18.89
'2021-09-30': -1346.13
'2021-10-31': -1288.81
'2021-11-30': -1231.49
'2021-12-31': -1952.71
'2022-01-31': 14614.31
'2022-02-28': 19705.31
monthlyMaximumBalance:
type: object
description:
The maximum balance for the month across all customer accounts
example:
'2021-03-31': 26321.24
'2021-04-30': 26528.01
'2021-05-31': 25110.12
'2021-06-30': 22676.89
'2021-07-31': 22889.45
'2021-08-31': 24431.44
'2021-09-30': 26144.03
'2021-10-31': 30679.71
'2021-11-30': 29099.98
'2021-12-31': 52998.24
'2022-01-31': 28163.22
'2022-02-28': 26827.62
monthlyAverageBalance:
type: object
description:
The average balance for the month across all customer accounts
example:
'2021-03-31': 23166.96
'2021-04-30': 21500.16
'2021-05-31': 21079.24
'2021-06-30': 17207.09
'2021-07-31': 17680.23
'2021-08-31': 20177.06
'2021-09-30': 21624.44
'2021-10-31': 23147.34
'2021-11-30': 23024.08
'2021-12-31': 23156.56
'2022-01-31': 20371.3
'2022-02-28': 22523.83
monthlyStandardDeviationOfBalance:
type: object
description: >-
The standard deviation for the month across all customer account
balances
example:
'2021-03-31': 1581.38
'2021-04-30': 3880.2
'2021-05-31': 2324.47
'2021-06-30': 4828.27
'2021-07-31': 5078.26
'2021-08-31': 5921.8
'2021-09-30': 6092.64
'2021-10-31': 7479.2
'2021-11-30': 6979.12
'2021-12-31': 10374.49
'2022-01-31': 3116.12
'2022-01-28': 2326.82
monthlyDaysWithPositiveBalance:
type: object
description: >-
The number of days in a month with a positive account balance across
all customer account balances
example:
'2021-03-31': 21
'2021-04-30': 21
'2021-05-31': 19
'2021-06-30': 17
'2021-07-31': 17
'2021-08-31': 14
'2021-09-30': 18
'2021-10-31': 13
'2021-11-30': 15
'2021-12-31': 16
'2022-01-31': 15
'2022-02-28': 22
monthlyDaysWithNegativeBalance:
type: object
description: >-
The number of days in a month with a negative account balance across
all customer account balances
example:
'2021-03-31': 0
'2021-04-30': 0
'2021-05-31': 0
'2021-06-30': 0
'2021-07-31': 0
'2021-08-31': 1
'2021-09-30': 1
'2021-10-31': 1
'2021-11-30': 1
'2021-12-31': 1
'2022-01-31': 0
'2022-02-28': 0
monthlyTwoMonthAverageBalance:
type: object
description: Customer average balance for two months
example:
'2021-03-31': 22845.4
'2021-04-30': 22333.56
'2021-05-31': 21289.7
'2021-06-30': 19143.17
'2021-07-31': 17443.66
'2021-08-31': 18928.64
'2021-09-30': 20900.75
'2021-10-31': 22385.89
'2021-11-30': 23085.71
'2021-12-31': 23090.32
'2022-01-31': 21763.93
'2022-02-28': 24573.46
monthlySixMonthAverageBalance:
type: object
description: Customer average balance for six months
example:
'2021-03-31': 28794.93
'2021-04-30': 25860.09
'2021-05-31': 23895.76
'2021-06-30': 22016.73
'2021-07-31': 20526.25
'2021-08-31': 20135.12
'2021-09-30': 19878.04
'2021-10-31': 20152.57
'2021-11-30': 20476.71
'2021-12-31': 21468.29
'2022-01-31': 21916.8
'2022-02-28': 32063.74
twelveMonthAverageBalance:
type: object
description: Customer average balance for twelve months
example:
'2021-03-31': 33677.33
'2021-04-30': 32656.57
'2021-05-31': 31325.31
'2021-06-30': 29758.99
'2021-07-31': 27896.6
'2021-08-31': 26099.43
'2021-09-30': 24336.49
'2021-10-31': 23006.33
'2021-11-30': 22186.24
'2021-12-31': 21742.51
'2022-01-31': 21221.53
'2022-02-28': 34637.95
twoMonthStandardDeviationOfBalance:
type: object
description: Two month standard deviation of customer balance
example:
'2021-03-31': 1954.1
'2021-04-30': 2730.79
'2021-05-30': 3102.33
'2021-06-31': 3576.37
'2021-07-31': 4953.27
'2021-08-31': 5500.03
'2021-09-30': 6007.22
'2021-10-31': 6785.92
'2021-11-30': 7229.16
'2021-12-31': 8676.8
'2022-01-31': 6745.3
'2022-02-28': 3236.86
sixMonthStandardDeviationOfBalance:
type: object
description: Six month standard deviation of customer balance
example:
'2021-03-31': 3004.4
'2021-04-30': 3010.97
'2021-05-31': 2975.17
'2021-06-30': 3181.34
'2021-07-31': 3336.57
'2021-08-31': 3935.73
'2021-09-30': 4687.61
'2021-10-31': 5287.44
'2021-11-30': 6063.22
'2021-12-31': 6987.58
'2022-01-31': 6660.56
'2022-02-28': 3023.26
twelveMonthStandardDeviationOfBalance:
type: object
description: Twelve month standard deviation of customer balance
example:
'2021-03-31': 2799.08
'2021-04-30': 2947.63
'2021-05-31': 2863.37
'2021-06-30': 3065.62
'2021-07-31': 3224.32
'2021-08-31': 3479.49
'2021-09-30': 3846
'2021-10-31': 4149.2
'2021-11-30': 4519.19
'2021-12-31': 5084.46
'2022-01-31': 4998.56
'2022-02-28': 2871.45
ConsumerAttributesAssetsAccount:
required:
- monthlyClosingBalance
- monthlyMinimumBalance
- monthlyMaximumBalance
- monthlyAverageBalance
- monthlyStandardDeviationOfBalance
- monthlyDaysWithPositiveBalance
- monthlyDaysWithNegativeBalance
- monthlyTwoMonthAverageBalance
- monthlySixMonthAverageBalance
- twelveMonthAverageBalance
- twoMonthStandardDeviationOfBalance
- sixMonthStandardDeviationOfBalance
- twelveMonthStandardDeviationOfBalance
type: object
properties:
monthlyClosingBalance:
type: object
description: Account closing balance by month
example:
'5001861693':
'2021-03-31': 20841.81
'2021-04-30': 16014.16
'2021-05-31': 16949.55
'2021-06-30': 645.01
'2021-07-31': 702.33
'2021-08-31': -18.89
'2021-09-30': -1346.13
'2021-10-31': -1288.81
'2021-11-30': -1231.49
'2021-12-31': -1952.71
'2022-01-31': 14614.31
'2022-02-28': 19705.31
monthlyMinimumBalance:
type: object
description: Account minimum balance by month
example:
'5001861693':
'2021-03-31': 20841.81
'2021-04-30': 16014.16
'2021-05-31': 16949.55
'2021-06-30': 645.01
'2021-07-31': 702.33
'2021-08-31': -18.89
'2021-09-30': -1346.13
'2021-10-31': -1288.81
'2021-11-30': -1231.49
'2021-12-31': -1952.71
'2022-01-31': 14614.31
'2022-02-28': 19705.31
monthlyMaximumBalance:
type: object
description: Account maximum balance by month
example:
'5001861693':
'2021-03-31': 26321.24
'2021-04-30': 26528.01
'2021-05-31': 25110.12
'2021-06-30': 22676.89
'2021-07-31': 22889.45
'2021-08-31': 24431.44
'2021-09-30': 26144.03
'2021-10-31': 30679.71
'2021-11-30': 29099.98
'2021-12-31': 52998.24
'2022-01-31': 28163.22
'2022-02-28': 26827.62
monthlyAverageBalance:
type: object
description: Account average balance by month
example:
'5001861693':
'2021-03-31': 23166.96
'2021-04-30': 21500.16
'2021-05-31': 21079.24
'2021-06-30': 17207.09
'2021-07-31': 17680.23
'2021-08-31': 20177.06
'2021-09-30': 21624.44
'2021-10-31': 23147.34
'2021-11-30': 23024.08
'2021-12-31': 23156.56
'2022-01-31': 20371.3
'2022-02-28': 22523.83
monthlyStandardDeviationOfBalance:
type: object
description: Standard deviation of balance by account
example:
'5001861693':
'2021-03-31': 1581.38
'2021-04-30': 3880.2
'2021-05-31': 2324.47
'2021-06-30': 4828.27
'2021-07-31': 5078.26
'2021-08-31': 5921.8
'2021-09-30': 6092.64
'2021-10-31': 7479.2
'2021-11-30': 6979.12
'2021-12-31': 10374.49
'2022-01-31': 3116.12
'2022-02-28': 2326.82
monthlyDaysWithPositiveBalance:
type: object
description: Number of days in a month with a positive account balance
example:
'5001861693':
'2021-03-31': 21
'2021-04-30': 21
'2021-05-31': 19
'2021-06-30': 17
'2021-07-31': 17
'2021-08-31': 14
'2021-09-30': 18
'2021-10-31': 13
'2021-11-30': 15
'2021-12-31': 16
'2022-01-31': 15
'2022-02-28': 22
monthlyDaysWithNegativeBalance:
type: object
description: Number of days in a month with a negative account balance
example:
'5001861693':
'2021-03-31': 0
'2021-04-30': 0
'2021-05-31': 0
'2021-06-30': 0
'2021-07-31': 0
'2021-08-31': 1
'2021-09-30': 1
'2021-10-31': 1
'2021-11-30': 1
'2021-12-31': 1
'2022-01-31': 0
'2022-02-28': 0
monthlyTwoMonthAverageBalance:
type: object
description: Two month average balance by account
example:
'5001861693':
'2021-03-31': 22845.4
'2021-04-30': 22333.56
'2021-05-31': 21289.7
'2021-06-30': 19143.17
'2021-07-31': 17443.66
'2021-08-31': 18928.64
'2021-09-30': 20900.75
'2021-10-31': 22385.89
'2021-11-30': 23085.71
'2021-12-31': 23090.32
'2022-01-31': 21763.93
'2022-02-28': 24573.46
monthlySixMonthAverageBalance:
type: object
description: Six month average balance by account
example:
'5001861693':
'2021-03-31': 28794.93
'2021-04-30': 25860.09
'2021-05-31': 23895.76
'2021-06-30': 22016.73
'2021-07-31': 20526.25
'2021-08-31': 20135.12
'2021-09-30': 19878.04
'2021-10-31': 20152.57
'2021-11-30': 20476.71
'2021-12-31': 21468.29
'2022-01-31': 21916.8
'2022-02-28': 32063.74
twelveMonthAverageBalance:
type: object
description: Twelve month average balance by account
example:
'5001861693':
'2021-03-31': 33677.33
'2021-04-30': 32656.57
'2021-05-31': 31325.31
'2021-06-30': 29758.99
'2021-07-31': 27896.6
'2021-08-31': 26099.43
'2021-09-30': 24336.49
'2021-10-31': 23006.33
'2021-11-30': 22186.24
'2021-12-31': 21742.51
'2022-01-31': 21221.53
'2022-02-28': 34637.95
twoMonthStandardDeviationOfBalance:
type: object
description: Standard deviation of account balance across two months
example:
'5001861693':
'2021-03-31': 1954.1
'2021-04-30': 2730.79
'2021-05-31': 3102.33
'2021-06-30': 3576.37
'2021-07-31': 4953.27
'2021-08-31': 5500.03
'2021-09-30': 6007.22
'2021-10-31': 6785.92
'2021-11-30': 7229.16
'2021-12-31': 8676.8
'2022-01-31': 6745.3
'2022-02-28': 3236.86
sixMonthStandardDeviationOfBalance:
type: object
description: Standard deviation of account balance across six months
example:
'5001861693':
'2021-03-31': 3004.4
'2021-04-30': 3010.97
'2021-05-31': 2975.17
'2021-06-30': 3181.34
'2021-07-31': 3336.57
'2021-08-31': 3935.73
'2021-09-30': 4687.61
'2021-10-31': 5287.44
'2021-11-30': 6063.22
'2021-12-31': 6987.58
'2022-01-31': 6660.56
'2022-02-28': 3023.26
twelveMonthStandardDeviationOfBalance:
type: object
description:
Standard deviation of account balance across twelve months
example:
'5001861693':
'2021-03-31': 2799.08
'2021-04-30': 2947.63
'2021-05-31': 2863.37
'2021-06-30': 3065.62
'2021-07-31': 3224.32
'2021-08-31': 3479.49
'2021-09-30': 3846
'2021-10-31': 4149.2
'2021-11-30': 4519.19
'2021-12-31': 5084.46
'2022-01-31': 4998.56
'2022-02-28': 2871.45
ConsumerAttributesDataAssets:
required:
- customer
- account
type: object
properties:
customer:
$ref: '#/components/schemas/ConsumerAttributesAssetsCustomer'
account:
$ref: '#/components/schemas/ConsumerAttributesAssetsAccount'
ConsumerAttributes:
required:
- analytics_id
- ca360_data
type: object
properties:
analytics_id:
$ref: '#/components/schemas/AnalyticId'
ca360_data:
$ref: '#/components/schemas/ConsumerAttributesData'
ConsumerAttributesDataNetAmount:
required:
- monthlyNetAmount
type: object
properties:
monthlyNetAmount:
$ref: '#/components/schemas/MonthlyNetAmount'
MonthlyNetAmount:
description: Monthly net amount
required:
- NetAmount
type: object
properties:
NetAmount:
description: Net amount per month
type: object
example:
'2021-03-31': -4333.85
'2021-04-30': -3605.57
'2021-05-31': -9374.7
'2021-06-30': -10084.15
'2021-07-31': -6318.96
'2021-08-31': -1363.57
'2021-09-30': -16997.87
'2021-10-31': -6870.64
'2021-11-30': -6244.79
'2021-12-31': -35750.48
'2021-01-31': -21232.13
'2021-02-28': -6723.7
ConsumerAttributeAccountIDs:
description: A list of account IDs
required:
- accountIds
type: object
properties:
accountIds:
description: The list of account IDs
type: array
items:
$ref: '#/components/schemas/AccountId'
ShowNsf:
type: boolean
description: >-
Include the non-sufficient funds (NSF) summary JSON and the NSF summary
PDF section in the report. Data included:
* Account
* Total number of NSF funds
* Days since the most recent NFS funds fee
example: false
Categories:
type: string
description: >-
The different categories for transactions.
* "ATM Fee"
* "Advertising"
* "Air Travel"
* "Alcohol & Bars"
* "Allowance"
* "Amusement"
* "Arts"
* "Auto & Transport"
* "Auto Insurance"
* "Auto Payment"
* "Baby Supplies"
* "Babysitter & Daycare"
* "Bank Fee"
* "Bills & Utilities"
* "Bonus"
* "Books"
* "Books & Supplies"
* "Business Services"
* "Buy"
* "Cash & ATM"
* "Charity"
* "Check"
* "Child Support"
* "Clothing"
* "Coffee Shops"
* "Credit Card Payment"
* "Dentist"
* "Deposit"
* "Dividend & Cap Gains"
* "Doctor"
* "Education"
* "Electronics & Software"
* "Entertainment"
* "Eyecare"
* "Fast Food"
* "Federal Tax"
* "Fees & Charges"
* "Finance Charge"
* "Financial"
* "Financial Advisor"
* "Food & Dining"
* "Furnishings"
* "Gas & Fuel"
* "Gift"
* "Gifts & Donations"
* "Groceries"
* "Gym"
* "Hair"
* "Health & Fitness"
* "Health Insurance"
* "Hobbies"
* "Home"
* "Home Improvement"
* "Home Insurance"
* "Home Phone"
* "Home Services"
* "Home Supplies"
* "Hotel"
* "Income"
* "Interest Income"
* "Internet"
* "Investments"
* "Kids"
* "Kids Activities"
* "Late Fee"
* "Laundry"
* "Lawn & Garden"
* "Legal"
* "Life Insurance"
* "Loan Fees and Charges"
* "Loan Insurance"
* "Loan Interest"
* "Loan Payment"
* "Loan Principal"
* "Loans"
* "Local Tax"
* "Low Balance"
* "Mobile Phone"
* "Mortgage & Rent"
* "Movies & DVDs"
* "Music"
* "Newspapers & Magazines"
* "Office Supplies"
* "Parking"
* "Paycheck"
* "Personal Care"
* "Pet Food & Supplies"
* "Pet Grooming"
* "Pets"
* "Pharmacy"
* "Printing"
* "Property Tax"
* "Public Transportation"
* "Reimbursement"
* "Rental Car & Taxi"
* "Restaurants"
* "Sales Tax"
* "Sell"
* "Services & Parts"
* "Service Fee"
* "Shipping"
* "Shopping"
* "Spa & Massage"
* "Sporting Goods"
* "Sports"
* "State Tax"
* "Streaming Services"
* "Student Loan"
* "Taxes"
* "Television"
* "Toys"
* "Trade Commissions"
* "Transfer"
* "Transfer for Cash Spending"
* "Travel"
* "Tuition"
* "Uncategorized"
* "Utilities"
* "Vacation"
* "Veterinary"
* "Internet / Broadband Charges"
example: 'ATM Fee'
InvestmentTransactionTypes:
type: string
description: >-
Keywords in the `description` and `memo` fields were used to translate
investment transactions into these types.
Possible values:
* "cancel"
* "purchaseToClose"
* "purchaseToCover"
* "contribution"
* "optionExercise"
* "optionExpiration"
* "fee"
* "soldToClose"
* "soldToOpen"
* "split"
* "transfer"
* "returnOfCapital"
* "income"
* "purchased"
* "sold"
* "dividendreInvest"
* "tax"
* "dividend"
* "reinvestOfIncome"
* "interest"
* "deposit"
* "otherInfo"
example: 'transfer'
LoanPaymentDetailCertification:
type: boolean
description: >-
"true": The institution is certified for the Loan Payment Detail product
"false": The institution is decertified for the Loan Payment Detail
product
example: true
StudentLoanDataCertification:
type: boolean
description: >-
"true": The institution is certified for the Student Loan Data product
"false": The institution is decertified for the Student Loan Data
product
example: true
SecurityIdType:
type: string
description: >-
The security type. This field is related to the `securityId` field.
Possible values:
* "CUSIP"
* "ISIN"
* "SEDOL"
* "SICC"
* "VALOR"
* "WKN"
example: 'CUSIP'