Concept2 Logbook API Skill

Fetch and analyze workout data from Concept2 Logbook with advanced pulse zone and trend analysis.

Quick Start

Use the provided script to fetch workouts:

python3 scripts/fetch_workouts.py --token <API_TOKEN> --from-date 2026-03-01 --format table

API Authentication

Requires a Concept2 API access token. Get one from:

https://log.concept2.com/developers/keys

Token must be passed with Authorization: Bearer header.

Main Endpoints

Query Parameters for Results

Workout Types

Equipment Types

Script Usage

Basic Usage - Summary with Pulse Zones

# Auto-detect max HR from birthdate in profile
python3 scripts/fetch_workouts.py --token <TOKEN> --from-date 2026-03-01

# Specify max HR manually
python3 scripts/fetch_workouts.py --token <TOKEN> --max-hr 165 --from-date 2026-02-01

# Estimate max HR from age
python3 scripts/fetch_workouts.py --token <TOKEN> --age 59 --from-date 2026-02-01

Trend Analysis (8 weeks)

python3 scripts/fetch_workouts.py --token <TOKEN> --trends 8 --from-date 2026-01-01

Other Formats

# Simple table
python3 scripts/fetch_workouts.py --token <TOKEN> --format table

# JSON export
python3 scripts/fetch_workouts.py --token <TOKEN> --format json > workouts.json

# Filter by equipment type
python3 scripts/fetch_workouts.py --token <TOKEN> --type skierg

Pulse Zone Analysis (5-Zone Model)

Zones based on percentage of maximum HR:

Max HR Calculation

• Manual: --max-hr 165
• From age: --age 59 (uses Tanaka formula: 208 - 0.7×age)
• From profile: reads birthdate from user data

Trend Analysis

Weekly aggregation of:

• Total distance
• Total time
• Number of workouts
• Average pace
• Improvement rate (pace change %)

Workout Quality Metrics

Pace Consistency

• Calculated from split data if available
• Standard deviation / average pace
• Rating: 🟢 Jevn | 🟡 OK | 🔴 Ujevn

Stroke Rate (SPM) Assessment

• 🟢 18-22: Efficient, strong drive
• 🔵 <18: Fast recovery phase
• 🟡 24-28: Tempo pace
• 🟠 >30: High rate, check technique

Training Recommendations

The script provides personalized tips:

• Training frequency assessment
• High intensity balance (20% rule for zones 4-5)
• Long workout suggestions
• Interval training reminders

Common Calculations

Calculate Pace

pace_tenths = (time_tenths / distance_m) * 500

Format Time

total_seconds = time_tenths / 10
minutes = int(total_seconds // 60)
seconds = total_seconds % 60
formatted = f"{minutes}:{seconds:04.1f}"

Distance Format

• Stored in meters
• 5000 = 5km

Stroke Data

• Distance in decimeters (incremental)
• Time in tenths of seconds (incremental)
• Pace in tenths of sec per 500m (rower) or 1000m (bike)

Error Codes

Pagination

Paginated responses include a meta.pagination object:

{
  "meta": {
    "pagination": {
      "total": 150,
      "count": 50,
      "per_page": 50,
      "current_page": 1,
      "total_pages": 3,
      "links": {
        "next": "https://log.concept2.com/api/users/me/results?page=2"
      }
    }
  }
}

Default per_page is 50, maximum is 250.

See Also

• Full API docs: https://log.concept2.com/developers/documentation/
• API keys: https://log.concept2.com/developers/keys
• Online validator: https://log.concept2.com/developers/validator