# Suunto 247 Data API - Documentation

## Endpoints

### 1. Daily Activity Samples
Provides daily steps, energy consumption (in joules), HR data and SpO2.

- **Endpoint:** `https://cloudapi.suunto.com/247samples/activity?from={from}&to={to}`
- **Time format:** EPOCH milliseconds
- **Max interval:** 28 days
- **Example:** `/247samples/activity?from=1672524000000&to=1690837200000`

---

### 2. Daily Activity Statistics
Aggregated daily steps and energy consumption data.

- **Endpoint:** `https://cloudapi.suunto.com/247samples/daily-activity-statistics?startdate={startdate}&enddate={enddate}`
- **Time format:** ISO 8601 (e.g., 2019-02-11T02:00:00)
- **Max interval:** 28 days

---

### 3. Recovery Data
Recovery data based on sample values from the watches.

- **Endpoint:** `https://cloudapi.suunto.com/247samples/recovery?from={from}&to={to}`
- **Time format:** EPOCH milliseconds
- **Max interval:** 28 days

---

### 4. Sleep Data
Sleep data based on sample values from the watches.

- **Endpoint:** `https://cloudapi.suunto.com/247samples/sleep?from={from}&to={to}`
- **Time format:** EPOCH milliseconds
- **Max interval:** 28 days

---

## Authentication Required
- **Authorization:** JWT token (from OAuth)
- **Ocp-Apim-Subscription-Key:** Subscription key from Suunto API Zone

---

## To Do
- [ ] Get OAuth credentials (Client ID, Client Secret)
- [ ] Get Subscription Key
- [ ] Authorize user and get JWT token
- [ ] Test API calls
- [ ] Integrate with FuelTrack

---

## Notes
- Data stored/fetched in UTC time
- Recommend fetching every 24 hours
- Maximum 28 days per request