Skip to main content
GET
/
v1
/
users
/
{user_id}
/
transactions
/
recurring
Retrieve recurring transactions (inflows and outflows) for a user
curl --request GET \
  --url https://prod.truv.com/v1/users/{user_id}/transactions/recurring/ \
  --header 'X-Access-Client-Id: <api-key>' \
  --header 'X-Access-Secret: <api-key>'
{
  "recurring_transactions": {
    "outflows": [
      {
        "source_id": "68a7e80942ce4ad58a93f70ce411549a",
        "source_name": "Netflix",
        "account_id": "68a7e80942ce4ad58a93f70ce411549a",
        "categories": [
          "Entertainment",
          "Subscriptions"
        ],
        "description": "NETFLIX.COM",
        "merchant_category_code": "5968",
        "frequency": "M",
        "status": "active",
        "average_amount": "15.99",
        "median_amount": "15.99",
        "last_amount": "15.99",
        "first_detected": "2024-01-15",
        "last_transaction_date": "2024-11-15",
        "next_expected_date": "2024-12-15",
        "logo_url": "https://example.com/logos/company.png",
        "historical_transactions": [
          {
            "transaction_id": "24d7e80942ce4ad58a93f70ce4115f5c",
            "date": "2025-05-04",
            "amount": "200.31",
            "description": "NETFLIX.COM"
          }
        ]
      }
    ],
    "inflows": [
      {
        "source_id": "68a7e80942ce4ad58a93f70ce411549a",
        "source_name": "Acme Corp",
        "account_id": "68a7e80942ce4ad58a93f70ce411549a",
        "description": "Salary",
        "frequency": "BW",
        "average_amount": "3500.00",
        "median_amount": "3500.00",
        "last_amount": "3500.00",
        "status": "active",
        "first_detected": "2024-01-01",
        "last_transaction_date": "2024-11-15",
        "next_expected_date": "2024-11-29",
        "logo_url": "https://example.com/logos/company.png",
        "historical_transactions": [
          {
            "transaction_id": "24d7e80942ce4ad58a93f70ce4115f5c",
            "date": "2025-05-04",
            "amount": "200.31",
            "description": "NETFLIX.COM"
          }
        ],
        "income_type": "PAYCHECK"
      }
    ]
  }
}

Authorizations

​
X-Access-Client-Id
string
header
required

Client ID

​
X-Access-Secret
string
header
required

Client Access Key

Path Parameters

​
user_id
string
required

Query Parameters

​
status
enum<string>
default:active

Filter by recurring source status. Defaults to active. Use all to return sources in any state.

Available options:
active,
inactive,
irregular,
all
​
link_id
string

Filter to a specific link ID. Defaults to all of the user's links.

Response

Recurring transactions for a user, split into recurring outflows (expenses) and recurring inflows (income sources).

​
recurring_transactions
object