Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.mytruv.com/llms.txt

Use this file to discover all available pages before exploring further.

The Spending Analysis response provides spending data grouped by category, merchant, or time period, along with summary statistics.

Summary attributes

AttributeTypeDescription
total_spendingstringTotal spending amount
average_daily_spendingstringAverage daily spending
average_monthly_spendingstringAverage monthly spending
total_transactionsintegerTotal number of transactions
unique_merchantsintegerNumber of unique merchants
top_categorystringHighest-spending category
top_merchantstringHighest-spending merchant

Spending data attributes

AttributeTypeDescription
by_categoryarray of objectsSpending grouped by category
by_merchantarray of objectsSpending grouped by merchant
by_time_periodarray of objectsSpending grouped by time period

Response attributes

AttributeTypeDescription
spendingobjectSpending data from MyTruv API
summaryobjectSummary statistics
request_idstringUnique request identifier
created_atstringAnalysis creation timestamp
by_time_periodarray of objectsTime periods with category/merchant breakdown (only when group_by=time_period and secondary_group_by is set)

Endpoints


Example response

{
  "spending": {
    "by_category": [
      {
        "category": "Food & Dining",
        "total": "1250.00",
        "count": 45
      }
    ],
    "by_merchant": [
      {
        "merchant": "Whole Foods",
        "total": "850.00",
        "count": 12
      }
    ]
  },
  "summary": {
    "total_spending": "5100.00",
    "average_daily_spending": "170.00",
    "average_monthly_spending": "5100.00",
    "total_transactions": 249,
    "unique_merchants": 3,
    "top_category": "Food & Dining",
    "top_merchant": "Whole Foods"
  },
  "request_id": "req_abc123",
  "created_at": "2025-03-15T10:00:00Z"
}