> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truv.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Transactions object

> Transaction history from connected financial accounts.

# 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](#accounts-object)             |
| transactions | array of objects | List of transactions, see [Transactions object](#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) |

### 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)                             |

### 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](/api-reference/transactions/link-bank-data-transactions)

# Example response

The sample below is a JSON response for the endpoint.

```json theme={null}
{
  "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                                                                                                                                                                                                      |
