Attributes

The information in this table is for the top-level transactions response.

Attribute	Type	Description
count	integer	Total number of transactions
next	uri	URL of the next page of results, `null` if none
previous	uri	URL of the previous page of results, `null` if none
accounts	array of objects	List of accounts, see Accounts object
transactions	array of objects	List of transactions, see Transactions object

Accounts object

Use the table below for reference to the account object values.

Attribute	Type	Description
id	string	Unique identifier of account
created_at	date-time	Date and time account was created
updated_at	date-time	Date and time account was most recently updated
type	string	Parent type of the account
subtype	string	Account subtype
mask	string	Last 4 digits of account number
nickname	string	Alternate name for account
balances	object	Balance information, see Balances object

Balances object

Find information about the balances object values in the table below.

Attribute	Type	Description
currency_code	string	Currency
balance	string	Balance amount
available_balance	string	Available balance amount
credit_limit	string	Credit limit

Transactions object

The values in this table have information from the transactions object.

Attribute	Type	Description
id	string	Unique identifier of transaction
created_at	date-time	Timestamp when transaction was created in Truv
updated_at	date-time	Timestamp when transaction was last updated in Truv
account_id	string	account_id
external_id	string	External system transaction identifier
amount	string	Monetary amount of transaction
currency_code	string	Three-character ISO 4217 currency code
check_number	string	Check number for transaction
categories	array of strings	List of categories assigned to this transaction
description	string	Human-readable transaction description
status	string	Status of transaction, one of `POSTED`, `PENDING`, `AUTHORIZATION`, or `MEMO`
type	string	Type of transaction, one of `CREDIT`, `DEBIT`, or `MEMO`
posted_at	date-time	Timestamp for movement of funds
transacted_at	date-time	Timestamp when transaction occurred
memo	string	Additional descriptive information about transaction
merchant_name	string	Merchant name extracted from the transaction description (nullable)
merchant_category_code	number	ISO 18245 category code for transaction
location	object	Location, see Location object

Location object

The two values in this table are for the location object.

Attribute	Type	Description
latitude	float	Latitude
longitude	float	Longitude

Endpoints

Use the endpoint below for information about transactions in an account.

List all bank transactions

Example response

The sample below is a JSON response for the endpoint.

{
  "count": 0,
  "next": "string",
  "previous": "string",
  "accounts": [
    {
      "id": "24d7e80942ce4ad58a93f70ce4115f5c",
      "created_at": "2022-05-04T11:30:00Z",
      "updated_at": "2022-05-04T12:00:00Z",
      "type": "CHECKING",
      "subtype": "MONEY_MARKET",
      "mask": "6789",
      "nickname": "My account",
      "balances": {
        "currency_code": "USD",
        "balance": "100.00",
        "available_balance": "50.99",
        "credit_limit": "200.00"
      }
    }
  ],
  "transactions": [
    {
      "id": "24d7e80942ce4ad58a93f70ce4115f5c",
      "created_at": "2022-05-04T11:30:00Z",
      "updated_at": "2022-05-04T12:00:00Z",
      "account_id": "68a7e80942ce4ad58a93f70ce411549a",
      "external_id": "external_key_243901",
      "amount": "100.00",
      "currency_code": "USD",
      "check_number": "123456",
      "categories": [
        "Transfer"
      ],
      "description": "Some transaction",
      "status": "POSTED",
      "type": "DEBIT",
      "posted_at": "2022-05-04T11:30:00Z",
      "transacted_at": "2022-05-04T11:30:00Z",
      "memo": "",
      "merchant_name": "Starbucks",
      "merchant_category_code": 5967,
      "location": {
        "latitude": 40.730610,
        "longitude": -73.935242
      }
    }
  ]
}

Transaction categories

Category	Subcategories
Auto & Transport	Auto Insurance, Auto Payment, Gas, Parking, Public Transportation, Service & Parts
Bills & Utilities	Domain Names, Fraud Protection, Home Phone, Hosting, Internet, Mobile Phone, Television, Utilities
Business Services	Advertising, Legal, Office Supplies, Printing, Shipping
Education	Books & Supplies, Student Loan, Tuition
Entertainment	Amusement, Arts, Movies & DVDs, Music, Newspapers & Magazines
Fees & Charges	ATM Fee, Banking Fee, Finance Charge, Late Fee, Service Fee, Trade Commissions
Financial	Financial Advisor, Life Insurance, BNPL, Payday Loan, EWA Lender, Loan Disbursement
Food & Dining	Alcohol & Bars, Coffee Shops, Fast Food, Groceries, Restaurants
Gifts & Donations	Charity, Gift
Health & Fitness	Dentist, Doctor, Eyecare, Gym, Health Insurance, Pharmacy, Sports
Home	Furnishings, Home Improvement, Home Insurance, Home Services, Home Supplies, Lawn & Garden, Mortgage & Rent
Income	Bonus, Interest Income, Paycheck, Reimbursement, Rental Income, Returned Purchase, EWA Payroll, Retirement, Government Employment, Government Benefits, Private Benefits, Unemployment, Tax credits, Gig Economy
Investments	Buy, Deposit, Dividend & Cap Gains, Sell, Withdrawal
Kids	Allowance, Baby Supplies, Babysitter & Daycare, Child Support, Kids Activities, Toys
Personal Care	Hair, Laundry, Spa & Massage
Pets	Pet Food & Supplies, Pet Grooming, Veterinary
Shopping	Books, Clothing, Hobbies, Sporting Goods
Taxes	Federal Tax, Local Tax, Property Tax, Sales Tax, State Tax
Transfer	Credit Card Payment, Transfer for Cash Spending, Mortgage Payment, P2P
Travel	Air Travel, Hotel, Rental Car & Taxi, Vacation
Uncategorized	Cash, Check

​Attributes

​Accounts object

​Balances object

​Transactions object

​Location object

​Endpoints

​Example response

​Transaction categories