Skip to main content
GET
/
v1
/
users
/
transactions
Get User Bank Transactions Endpoint
curl --request GET \
  --url https://api.mytruv.com/v1/users/transactions \
  --header 'Authorization: Basic <encoded-value>'
{
  "count": 123,
  "accounts": [
    {
      "type": "CHECKING",
      "balances": {
        "currency_code": "USD",
        "balance": "100.00",
        "available_balance": "50.99",
        "credit_limit": "200.00"
      },
      "id": "24d7e80942ce4ad58a93f70ce4115f5c",
      "created_at": "2022-05-04T11:30:00Z",
      "updated_at": "2022-05-04T12:00:00Z",
      "subtype": "MONEY_MARKET",
      "mask": "6789",
      "nickname": "My account"
    }
  ],
  "transactions": [
    {
      "external_id": "external_key_243901",
      "description": "Some transaction",
      "status": "POSTED",
      "type": "DEBIT",
      "transacted_at": "2022-05-04T11:30:00Z",
      "location": {
        "latitude": "40.730610",
        "longitude": "-73.935242"
      },
      "id": "24d7e80942ce4ad58a93f70ce4115f5c",
      "created_at": "2022-05-04T11:30:00Z",
      "updated_at": "2022-05-04T12:00:00Z",
      "account_id": "68a7e80942ce4ad58a93f70ce411549a",
      "amount": "100.00",
      "currency_code": "USD",
      "check_number": "123456",
      "categories": [
        "Transfer"
      ],
      "posted_at": "2022-05-04T11:30:00Z",
      "memo": "",
      "merchant_name": "Starbucks",
      "merchant_category_code": 5814
    }
  ],
  "daily_totals": [
    {
      "date": "<string>",
      "net_total": "<string>",
      "transaction_count": 123
    }
  ],
  "next": "<string>",
  "previous": "<string>"
}

Authorizations

​
Authorization
string
header
required

Use user_id as username and access_token as password.

Query Parameters

​
transacted_at_from
string
required

Start date for the transaction window (inclusive, YYYY-MM-DD).

Example:

"2025-01-01"

​
transacted_at_to
string

End date for the transaction window (inclusive, YYYY-MM-DD). Defaults to today.

Example:

"2025-12-31"

​
categories
string | null

Comma-separated category filter (e.g. 'Income,Transfer'). Omit to include all categories.

Maximum string length: 1000
Example:

"Income,Transfer"

​
transaction_type
enum<string> | null

Filter by transaction type. Omit to include both debits and credits.

Available options:
DEBIT,
CREDIT
Example:

"DEBIT"

​
account_ids
string | null

Comma-separated account IDs to include. Omit to include all accounts.

Example:

"acc_001,acc_002"

​
min_amount
number | null

Minimum transaction amount (absolute value). Inclusive.

Example:

"10.00"

​
max_amount
number | null

Maximum transaction amount (absolute value). Inclusive.

Example:

"500.00"

​
merchant
string | null

Case-insensitive substring match on merchant name or description.

Example:

"starbucks"

​
sort_by
enum<string>
default:date

Sort transactions by date or absolute amount.

Available options:
date,
amount
Example:

"date"

​
sort_order
enum<string>
default:desc

Sort direction: ascending or descending.

Available options:
asc,
desc
Example:

"desc"

​
page
integer | null

Page number for paginated results (1-based). Omit to fetch all transactions at once.

Required range: x >= 1
Example:

1

​
page_size
integer
default:500

Number of transactions per page. Min 10, max 500.

Required range: 10 <= x <= 500
Example:

100

Response

Successful Response

​
count
integer
required
​
accounts
Account1 · object[]
required
​
transactions
Transaction1 · object[]
required
​
daily_totals
DailyTotal · object[]
​
next
string | null
​
previous
string | null