get_grouped_activities
Fetch and group fitness activities by sport, day, week, or month to analyze training patterns and create summarized reports from Intervals.icu data.
Instructions
Tool for fetching and grouping activities to reduce data volume and show patterns.
Best for: Analyzing training patterns, summarizing activity by sport/time period, creating training reports, reducing data volume for large date ranges. Not recommended for: Getting individual activity details; real-time tracking. Common mistakes: Using invalid group_by value; requesting details for large datasets. Prompt Example: "Group my activities by sport from January" or "Show me weekly activity summary for last month" Usage Example:
Tool Relationships: Use after get_activities to analyze patterns, or directly for summarized data when individual activities aren't needed. Returns: Grouped activity data with summaries (count, duration, distance) per group.
Parameters
oldest_date : str The oldest date to fetch activities from (format: YYYY-MM-DD). This parameter is required. newest_date : str, optional The newest date to fetch activities from (format: YYYY-MM-DD). If not provided, no upper date limit is applied. group_by : str, optional How to group activities. Options: "sport", "day", "week", "month". Default: "sport" include_details : bool, optional Whether to include filtered activity details in each group. Default: False
Returns
dict Dictionary containing: - groups: Dictionary of groups with summaries - total_activities: Total number of activities - Additional metadata based on grouping type
Raises
ValidationError: If parameters are invalid. IntervalsError: If the API request fails.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| oldest_date | Yes | ||
| newest_date | No | ||
| group_by | No | sport | |
| include_details | No |