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.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 |