Overview

The sections below cover each of the data values for identity and transactions endpoints. Use the transactions endpoint and identity endpoint to collect the data.

Data structure

• Identity
• Accounts data
• Transactions data

Example responses

The JSON samples below contain a set of comprehensive responses.

Identity

The response below covers identification values.

{
  "id": "383cac95017d451ba0e353684c521c66",
  "first_name": "John",
  "last_name": "Doe",
  "full_name": "John Doe",
  "middle_initials": null,
  "email": "[email protected]",
  "ssn": null,
  "date_of_birth": null,
  "home_address": {
    "zip": "94062",
    "city": "Redwood City",
    "state": "CA",
    "street": "35 Dry Ridge Rd",
    "country": "US"
  }
}

Accounts and transactions

These values contain information for the user's accounts and transactions.

{
  "count": 10,
  "next": "https://prod.truv.com/v1/link/0000000000/transactions?page=2",
  "previous": "https://prod.truv.com/v1/link/0000000000/transactions?page=1",
  "accounts": [
    {
      "id": "24d7e80942ce4ad58a93f70ce4115f5c",
      "created_at": "2022-05-04T11:30:00Z",
      "updated_at": "2022-05-04T12:00:00Z",
      "type": "CHECKING",
      "subtype": "",
      "mask": "6789",
      "nickname": "My account",
      "balances": {
        "currency_code": "USD",
        "balance": "100.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_category_code": 5967,
      "location": {
        "latitude": "13.45",
        "longitude": "12.34"
      }
    }
  ]
}

Identity data

The table below is a summary of personal employee information from the payroll provider.

Accounts data

This field covers bank account information from connected bank accounts.

Account types and subtypes

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

Transactions

The table below covers transaction history for the connected bank accounts.

Transaction categories

The list below contains all valid transaction categories.

• 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
• 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
• 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
• Travel
  • Air Travel
  • Hotel
  • Rental Car & Taxi
  • Vacation
• Uncategorized
  • Cash
  • Check