Data Reference for Verification of Assets

View the reference data for verifying identity, accounts, and asset information.

Overview

The sections below cover each of the data values for borrower, accounts, and asset verification endpoints. Use the VOA Reports endpoints to collect the asset verification data.

Data structure

Example responses

The JSON samples below contain a set of comprehensive responses.

Accounts and balances for asset verification

These values contain information for the user's accounts and their balances for asset verification.

{
  "report_id": "7d4fcb86b81a4880955beea558092391",
  "created_at": "2022-05-04T11:30:00Z",
  "completed_at": "2022-05-04T12:00:00Z",
  "days_requested": 60,
  "large_deposit_threshold": 500,
  "is_voe": true,
  "borrower": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "external_user_id": "12345",
    "first_name": "John",
    "last_name": "Doe",
    "email": "[email protected]",
    "phone": "+14155554193",
    "ssn": "222233333",
    "created_at": "2022-05-04T11:30:00Z",
    "updated_at": "2022-05-04T12:00:00Z"
  },
  "links": [
    {
      "link_id": "150491a20bdb4292bb2a2ad8554fecba",
      "tracking_info": "string",
      "provider": "string",
      "provider_name": "string",
      "accounts": [
        {
          "id": "4d601895417c46ec99633978db12a866",
          "created_at": "2022-05-04T11:30:00Z",
          "updated_at": "2022-05-04T12:00:00Z",
          "type": "string",
          "subtype": "string",
          "mask": "string",
          "routing_number": "55999876",
          "nickname": "string",
          "days_available": 0,
          "balance_as_of": "2025-05-04T12:00:00Z",
          "balances": {
            "currency_code": "string",
            "balance": "string",
            "available_balance": "string",
            "credit_limit": "string"
          },
          "transactions": [
            {
              "id": "7d4fcb86b81a4880955beea558092391",
              "external_id": "string",
              "amount": "string",
              "currency_code": "string",
              "check_number": "string",
              "categories": [
                "string"
              ],
              "description": "string",
              "status": "POSTED",
              "type": "DEBIT",
              "posted_at": "2022-05-05T15:30:00Z",
              "transacted_at": "2022-05-04T12:00:00Z",
              "merchant_category_code": 0,
              "ending_daily_balance": 0,
              "is_direct_deposit": true,
              "is_subscription": true
            }
          ],
          "owners": [
            {
              "id": "2b623fa2fa9e49cea17d9692caa884c5",
              "full_name": "John Doe",
              "email": "[email protected]",
              "phone": "14155554193",
              "address": {
                "street": "1 Morgan Ave",
                "city": "Los Angeles",
                "state": "CA",
                "zip": "90210",
                "country": "US"
              },
              "relation_type": "PRIMARY"
            }
          ],
          "summary": {
            "avg_30": "string",
            "avg_60": "string",
            "avg_90": "string",
            "currency_code": "string",
            "balance": "string"
          },
          "same_owner_as_requested": true,
          "direct_deposit_from_employer": true,
          "nsf": 0
        }
      ]
    }
  ],
  "summary": {
    "avg_30": "string",
    "avg_60": "string",
    "avg_90": "string",
    "currency_code": "string",
    "balance": "string"
  }
}

Report-level data

The table below covers the main report information from VOA reports.

Name

Type

Description

report_id

string

Unique identifier of the report

created_at

string(date-time)

Timestamp when report was created

completed_at

string(date-time)

Timestamp when report was completed

days_requested

integer

Number of days for requested transactions

large_deposit_threshold

integer (nullable)

Amount that must be met or exceeded for deposits to be marked as large

is_voe

boolean

Indicates whether the report is a Deposit-based Verification of Employment (DVOE)

borrower

object

Borrower information, see Borrower data section

links

array of objects

List of assets links, see Links object

summary

object

Balance summary information for account, see Asset verification summary section

Borrower data

The table below covers borrower information from VOA reports.

NameTypeDescription
idstringUnique ID of user
external_user_idstringExternal user ID
first_namestringFirst name
last_namestringLast name
emailstringEmail address
phonestringPhone number
ssnstringSocial Security Number
created_atdate-timeTimestamp when user was created
updated_atdate-timeTimestamp when user was last updated

Links object

The information in this table is for values in the Links object.

AttributeTypeDescription
link_idstringUnique identifier of the link
tracking_infostringAdditional optional identifier passed by user
providerstringID of the financial institution
provider_namestringName of the financial institution
accountsarray of objectsList of assets accounts, see Accounts object

Accounts data

This field covers bank account information from connected bank accounts for asset verification.

Name

Type

Description

id

string

Unique ID for the account

created_at

string

Timestamp of when account data was pulled

updated_at

string

Date and time account was most recently updated

type

string (nullable)

General or parent type of the account, example CHECKING or SAVINGS

subtype

string (nullable)

Account's subtype, example PLAN_401_K, MONEY_MARKET, or HOME_EQUITY

mask

string

Last 4 digits of the account number associated with the account

routing_number

string (nullable)

Bank routing number associated with the account

nickname

string (nullable)

User friendly account name

balance_as_of

string(date-time) (nullable)

Timestamp for when balance was captured

balances

object

List of balance information from account, see Balances object

transactions

array of objects

List of transactions for account, see Transactions object

owners

array of objects

List of owners for account, see Owners object

summary

object

Balance summary information for account, see Asset verification summary section

same_owner_as_requested

boolean (nullable)

Whether account owner matches the requested user

direct_deposit_from_employer

boolean (nullable)

Whether account has direct deposit from employer

nsf

integer (nullable)

NSF (Non-sufficient funds) count

Balances object

The information in the table below refers to values in the balances object.

AttributeTypeDescription
currency_codestringThree-character ISO 4217 currency code
balancestringCurrent account balance
available_balancestringAvailable balance for use in checking and savings asset accounts, PENDING transactions may not reflect available balance
credit_limitstringCredit limit associated with account

Transactions data

The table below covers transaction information from connected bank accounts for asset verification.

Name

Type

Description

id

string

Unique identifier of transaction

external_id

string (nullable)

External system transaction identifier

amount

string

Monetary amount of transaction

currency_code

string (nullable)

Three-character ISO 4217 currency code

check_number

string (nullable)

Check number for transaction

categories

array of strings (nullable)

List of categories assigned to this transaction

description

string (nullable)

Human-readable transaction description

status

string

Status of transaction, either POSTED or PENDING

type

string

Type of transaction, either CREDIT or DEBIT

posted_at

string(date-time) (nullable)

Timestamp when transaction was posted

transacted_at

string(date-time) (nullable)

Timestamp when transaction took place

merchant_category_code

integer (nullable)

ISO 18245 category code for transaction

ending_daily_balance

number (nullable)

Daily ending balance for transaction

is_direct_deposit

boolean (nullable)

Whether transaction is direct deposit

is_subscription

boolean (nullable)

Whether transaction is subscription

Owners data

The table below covers account owner information from connected bank accounts for asset verification.

Name

Type

Description

id

string

ID of owner

full_name

string (nullable)

Full name

email

string (nullable)

Email address

phone

string (nullable)

Phone number

address

object (nullable)

Address object with street, city, state, zip, and country fields

relation_type

string (nullable)

Relationship type for account owner (e.g., PRIMARY)

Relation types

The table below contains valid relation types for account owners.

Relation TypeDescription
PRIMARYPrimary account holder
BUSINESSBusiness account relationship
JOINTJoint account holder
SECONDARYSecondary account holder
AUTHORIZED_USERAuthorized user on the account
FOR_BENEFIT_OFAccount held for benefit of another person

Asset verification summary

The table below covers asset verification summary data that aggregates balance information over different time periods.

NameTypeDescription
avg_30stringAverage balance over the last 30 days
avg_60stringAverage balance over the last 60 days
avg_90stringAverage balance over the last 90 days
currency_codestringThree-character ISO 4217 currency code

Account types and subtypes

The tables below contain valid fields and groups for the user's account.

Parent types
ANY (not provided by data partner or invalid number provided)
CHECKING
SAVINGS
LOAN
CREDIT_CARD
INVESTMENT
LINE_OF_CREDIT
MORTGAGE
PROPERTY
CASH
INSURANCE
PREPAID
CHECKING_LINE_OF_CREDIT
SubtypeParent type
MONEY_MARKETSAVINGS
CERTIFICATE_OF_DEPOSITSAVINGS
AUTOLOAN
STUDENTLOAN
SMALL_BUSINESSLOAN
PERSONALLOAN
PERSONAL_WITH_COLLATERALLOAN
HOME_EQUITYLOAN
PLAN_401_KINVESTMENT
PLAN_403_BINVESTMENT
PLAN_529INVESTMENT
IRAINVESTMENT
ROLLOVER_IRAINVESTMENT
ROTH_IRAINVESTMENT
TAXABLEINVESTMENT
NON_TAXABLEINVESTMENT
BROKERAGEINVESTMENT
TRUSTINVESTMENT
UNIFORM_GIFTS_TO_MINORS_ACTINVESTMENT
PLAN_457INVESTMENT
PENSIONINVESTMENT
EMPLOYEE_STOCK_OWNERSHIP_PLANINVESTMENT
SIMPLIFIED_EMPLOYEE_PENSIONINVESTMENT
SIMPLE_IRAINVESTMENT
BOATLOAN
POWERSPORTSLOAN
RVLOAN
HELOCLOAN
PLAN_ROTH_401_KINVESTMENT
FIXED_ANNUITYINVESTMENT
VARIABLE_ANNUITYINVESTMENT
VEHICLE_INSURANCEINSURANCE
DISABILITYINSURANCE
HEALTHINSURANCE
LONG_TERM_CAREINSURANCE
PROPERTY_AND_CASUALTYINSURANCE
UNIVERSAL_LIFEINSURANCE
TERM_LIFEINSURANCE
WHOLE_LIFEINSURANCE
ACCIDENTAL_DEATH_AND_DISMEMBERMENTINSURANCE
VARIABLE_UNIVERSAL_LIFEINSURANCE
HSAINVESTMENT
TAX_FREE_SAVINGS_ACCOUNTINVESTMENT
INDIVIDUALINVESTMENT
REGISTERED_RETIREMENT_INCOME_FUNDINVESTMENT
CASH_MANAGEMENT_ACCOUNTINVESTMENT
EMPLOYEE_STOCK_PURCHASE_PLANINVESTMENT
REGISTERED_EDUCATION_SAVINGS_PLANINVESTMENT
PROFIT_SHARING_PLANINVESTMENT
UNIFORM_TRANSFER_TO_MINORS_ACTINVESTMENT
PLAN_401_AINVESTMENT
SARSEP_IRAINVESTMENT
FIXED_ANNUITY_TRADITIONAL_IRAINVESTMENT
VARIABLE_ANNUITY_TRADITIONAL_IRAINVESTMENT
SEPP_IRAINVESTMENT
INHERITED_TRADITIONAL_IRAINVESTMENT
FIXED_ANNUITY_ROTH_IRAINVESTMENT
VARIABLE_ANNUITY_ROTH_IRAINVESTMENT
INHERITED_ROTH_IRAINVESTMENT
COVERDELLINVESTMENT
ADVISORY_ACCOUNTINVESTMENT
BROKERAGE_MARGININVESTMENT
CHARITABLE_GIFT_ACCOUNTINVESTMENT
CHURCH_ACCOUNTINVESTMENT
CONSERVATORSHIPINVESTMENT
CUSTODIALINVESTMENT
DEFINED_BENEFIT_PLANINVESTMENT
DEFINED_CONTRIBUTION_PLANINVESTMENT
EDUCATIONALINVESTMENT
ESTATEINVESTMENT
EXECUTORINVESTMENT
GROUP_RETIREMENT_SAVINGS_PLANINVESTMENT
GUARANTEED_INVESTMENT_CERTIFICATEINVESTMENT
HRAINVESTMENT
INDEXED_ANNUITYINVESTMENT
INVESTMENT_CLUBINVESTMENT
IRREVOCABLE_TRUSTINVESTMENT
JOINT_TENANTS_BY_ENTIRITYINVESTMENT
JOINT_TENANTS_COMMUNITY_PROPERTYINVESTMENT
JOINT_TENANTS_IN_COMMONINVESTMENT
JOINT_TENANTS_WITH_RIGHTS_OF_SURVIVORSHIPINVESTMENT
KEOUGH_PLANINVESTMENT
LIFE_INCOME_FUNDINVESTMENT
LIVING_TRUSTINVESTMENT
LOCKED_IN_RETIREMENT_ACCOUNTINVESTMENT
LOCKED_IN_RETIREMENT_INVESTMENT_FUNDINVESTMENT
LOCKED_IN_RETIREMENT_SAVINGS_ACCOUNTINVESTMENT
MONEY_PURCHASE_PLANINVESTMENT
PARTNERSHIPINVESTMENT
PLAN_409_AINVESTMENT
PLAN_ROTH_403_BINVESTMENT
REGISTERED_DISABILITY_SAVINGS_PLANINVESTMENT
REGISTERED_LOCKED_IN_SAVINGS_PLANINVESTMENT
REGISTERED_PENSION_PLANINVESTMENT
REGISTERED_RETIREMENT_SAVINGS_PLANINVESTMENT
REVOCABLE_TRUSTINVESTMENT
ROTH_CONVERSIONINVESTMENT
SOLE_PROPRIETORSHIPINVESTMENT
SPOUSAL_IRAINVESTMENT
SPOUSAL_ROTH_IRAINVESTMENT
TESTAMENTARY_TRUSTINVESTMENT
THRIFT_SAVINGS_PLANINVESTMENT
INHERITED_ANNUITYINVESTMENT
CORPORATE_ACCOUNTINVESTMENT
LIMITED_LIABILITY_ACCOUNTINVESTMENT