Authentication Errors
Missing Authentication
{
"detail": "Authentication required: provide JWT token or API key"
}
-H "X-Open-Wearables-API-Key: YOUR_API_KEY"
Use X-Open-Wearables-API-Key header, not Authorization: Bearer.
Invalid API Key
{
"detail": "Invalid or missing API key"
}
Protected Endpoint
{
"detail": "Could not validate credentials"
}
Provider Errors
User Not Connected
{
"detail": "User not connected to garmin"
}
GET /api/v1/oauth/garmin/authorize?user_id={user_id}
Token Expired
{
"detail": "Token expired and no refresh token available for garmin"
}
{
"detail": "Garmin authorization expired. Please re-authorize."
}
GET /api/v1/oauth/garmin/authorize?user_id={user_id}
Provider Doesn’t Support OAuth
{
"detail": "Provider 'apple' does not support OAuth"
}
Invalid Provider Name
{
"detail": "Input should be 'apple', 'garmin', 'polar' or 'suunto'"
}
garmin, polar, suunto, apple.
Validation Errors
Missing Required Field
{
"detail": "Field required"
}
start_time and end_time for timeseries endpointsstart_date and end_date for event endpointsuser_id for OAuth authorization
{
"detail": "Input should be a valid UUID, invalid character: expected an optional prefix of `urn:uuid:` followed by [0-9a-fA-F-], found `n` at 1"
}
user_id) has an invalid format.
Solution: Ensure UUIDs are in the correct format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Resource Errors
Resource Not Found
{
"detail": "User with ID: {id} not found."
}
HTTP Status Code Reference
| Status | Meaning | Common Causes |
|---|
| 200 | Success | Request completed successfully |
| 201 | Created | Resource created successfully |
| 400 | Bad Request | Invalid parameters, validation errors |
| 401 | Unauthorized | Missing or invalid authentication |
| 404 | Not Found | Resource doesn’t exist |
| 422 | Unprocessable | Request body validation failed |
| 500 | Server Error | Internal error (please report) |
