Activity
1 route
GET /coaching-timeline
Coaching phases of each student (cutting, bulking…). A deleted phase leaves no tombstone: resync the student's phases when one is missing. include_deleted has no effect.
- Scope activity:read
- 1 credit
- Read
- Stable
Parameters
| Name | Type | Description |
|---|---|---|
limitquery | integer1–200, default 50 | |
cursorquery | string | Opaque cursor: next_cursor of the previous page. |
sincequery | date-time | ISO 8601. Returns the objects with updated_at >= since. |
include_deletedquery | booleandefault false | |
student_idquery | integer≥ 1 |
curl "https://api.fitdistance.io/api/partner/v1/coaching-timeline?limit=50" \
-H "Authorization: Bearer fd_live_xxxxxxxx"200 · a page of CoachingPhase
{
"data": [
{
"id": 4821,
"student_id": 4821,
"coach_id": 4821,
"phase": "cutting",
"start_date": "2026-10-24",
"end_date": "2026-10-24",
"description": "string",
"color": "string",
"order": 1,
"is_active": true,
"updated_at": "2026-10-24T09:12:00Z"
}
],
"next_cursor": null,
"has_more": false
}403 · SCOPE_MISSING
{
"error": {
"name": "PARTNER_API",
"message": "SCOPE_MISSING"
}
}200 · a page of CoachingPhase
| Name | Type | Description |
|---|---|---|
id required | integer | |
student_id required | integer | |
coach_id required | integer | null | The coach who set the phase, not necessarily the student's current coach. |
phase required | stringone of cutting, bulking, maintenance, recomposition, preparation, recovery, custom | |
start_date required | date | |
end_date required | date | |
description required | string | null | |
color required | string | Hexadecimal color, for example #3f48b7. |
order required | integer | |
is_active required | boolean | |
updated_at required | date-time | The latest change of the phase. |
Errors
| Status | Code | When |
|---|---|---|
400 | VALIDATION | Invalid parameters or body.billed |
401 | UNAUTHORIZED | Key missing, unknown or revoked.not billed |
402 | CREDITS_EXHAUSTED | No credits left this month and no reserve.not billed |
403 | SCOPE_MISSING | The key doesn't have the required scope.not billed |
403 | PLAN_NOT_ELIGIBLE | Your plan doesn't include the API.not billed |
429 | RATE_LIMITED | Too many calls: 10 per second, 300 per minute, 60 writes and 20 deletes per minute.not billed |