Concept2-logbook

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  --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

| Endpoint | Description | |----------|-------------| | GET /api/users/me | Get authenticated user info | | GET /api/users/me/results | Get workouts (paginated) | | GET /api/users/me/results/{id} | Get specific workout | | GET /api/users/me/results/{id}/strokes | Get stroke-level data |

Query Parameters for Results

| Param | Type | Description | |-------|------|-------------| | from | date | Start date (YYYY-MM-DD) | | to | date | End date (YYYY-MM-DD) | | type | string | Workout type: rower, skierg, bike, etc. | | per_page | integer | Results per page (max 250) |

Workout Types

| Type | Description | |------|-------------| | JustRow | Free rowing | | FixedDistanceSplits | Fixed distance with splits | | FixedTimeSplits | Fixed time with splits | | FixedCalorie | Fixed calorie target | | FixedWattMinute | Fixed watt-minute target | | FixedTimeInterval | Time-based intervals | | FixedDistanceInterval | Distance-based intervals | | FixedCalorieInterval | Calorie intervals | | FixedWattMinuteInterval | Watt-minute intervals | | VariableInterval | Variable intervals | | VariableIntervalUndefinedRest | Variable with undefined rest |

Equipment Types

| Type | Description | |------|-------------| | rower | RowErg | | skierg | SkiErg | | bike | BikeErg | | dynamic | Dynamic RowErg | | slides | RowErg with slides | | paddle | PaddleErg | | water | WaterRower | | snow | Snow (Nordic skiing) | | rollerski | Roller skiing | | multierg | MultiErg |

Script Usage

Basic Usage - Summary with Pulse Zones

# Auto-detect max HR from birthdate in profile
python3 scripts/fetch_workouts.py --token  --from-date 2026-03-01
Specify max HR manually
python3 scripts/fetch_workouts.py --token  --max-hr 165 --from-date 2026-02-01
Estimate max HR from age
python3 scripts/fetch_workouts.py --token  --age 59 --from-date 2026-02-01

Trend Analysis (8 weeks)

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

Other Formats

# Simple table
python3 scripts/fetch_workouts.py --token  --format table
JSON export
python3 scripts/fetch_workouts.py --token  --format json > workouts.json
Filter by equipment type
python3 scripts/fetch_workouts.py --token  --type skierg

Pulse Zone Analysis (5-Zone Model)

Zones based on percentage of maximum HR:

| Zone | Name | Range | Purpose | |------|------|-------|---------| | 🟢 1 | Restitusjon | 0-60% | Recovery, warmup | | 🔵 2 | Aerob kapasitet | 60-70% | Base building | | 🟡 3 | Aerob effekt | 70-80% | Tempo training | | 🟠 4 | Anaerob terskel | 80-90% | Threshold/intervals | | 🔴 5 | Maks kapasitet | 90-100% | VO2max/sprints |

Max HR Calculation

Trend Analysis

Weekly aggregation of:

Workout Quality Metrics

Pace Consistency

Stroke Rate (SPM) Assessment

Training Recommendations

The script provides personalized tips:

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

Stroke Data

Error Codes

| Code | Meaning | Resolution | |------|---------|------------| | 200 | OK | Success | | 201 | Created | Resource created successfully | | 400 | Bad Request | Check request format | | 401 | Unauthorized | Invalid or expired token | | 403 | Forbidden | User hasn't authorized app | | 404 | Not Found | Resource doesn't exist | | 409 | Conflict | Duplicate entry | | 422 | Unprocessable | Validation error | | 500 | Server Error | Try again later | | 503 | Service Unavailable | API temporarily down |

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

Use the provided script to fetch workouts:

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