# List the exercises the coach has configured

`GET https://api.coach-platform.com/api/public/exercises/settings`

List the exercises the coach has configured: coach notes, demonstration video, media display, 1RM tracking, favorite and the default alternatives trainees may swap to. These settings are global: they apply to every training plan and every trainee that uses the exercise.

- Resource: Exercises
- Authentication: API key in the `Authorization: Bearer cp_live_...` header
- HTML version: https://www.coach-platform.com/docs/api/reference/get-exercises-settings
- OpenAPI spec: https://www.coach-platform.com/openapi.json

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `page` | integer | No | Page number (1-based, default 1) Minimum: `1`. |
| `limit` | integer | No | Number of items to return (default 25, max 500) Minimum: `1`. Maximum: `500`. |
| `favoritesOnly` | string | No | Only favorite exercises. Allowed values: `true`, `false`. |
| `withAlternativesOnly` | string | No | Only exercises that have default alternatives. Allowed values: `true`, `false`. |

## Responses

| Status | Description |
|---|---|
| `200` OK | Successful response |
| `400` Bad Request |  |
| `401` Unauthorized |  |
| `403` Forbidden |  |
| `429` Too Many Requests |  |
| `500` Internal Server Error |  |

### 200 OK

Content type: `application/json`

| Field | Type | Description |
|---|---|---|
| `data` | object[] |   |
| `data[].exerciseId` | string |   |
| `data[].name` | string \| null |   |
| `data[].nameHebrew` | string \| null |   |
| `data[].isCustom` | boolean | True for an exercise the coach added to their own catalog. |
| `data[].notes` | string \| null | Coach notes shown to trainees on this exercise. |
| `data[].videoLink` | string \| null | Coach demonstration video URL. |
| `data[].mediaDisplay` | string | How the exercise is shown to trainees: "gif" shows the GIF (tapping it opens the video), "thumbnail" shows the YouTube video thumbnail instead of the GIF. Allowed values: `gif`, `thumbnail`. |
| `data[].trackRm1` | boolean | Track an estimated 1RM (Brzycki) for this exercise. |
| `data[].isFavorite` | boolean | Marked as a coach favorite. |
| `data[].alternativeExercises` | object[] | Default alternatives trainees may swap this exercise for, in every plan. |
| `data[].alternativeExercises[].exerciseId` | string |   |
| `data[].alternativeExercises[].name` | string \| null |   |
| `data[].alternativeExercises[].nameHebrew` | string \| null |   |
| `pagination` | object |   |
| `pagination.page` | number |   |
| `pagination.limit` | number |   |
| `pagination.total` | number \| null | Total number of matching items. null when the underlying source cannot report an exact count for this page; use hasMore to keep paging. |
| `pagination.hasMore` | boolean |   |
| `pagination.truncated` | boolean | Present and true when the result set exceeded the in-memory scan cap and was truncated. Narrow your filters to page through all items. |

Example:

```json
{
  "data": [
    {
      "exerciseId": "<string>",
      "name": "<string>",
      "nameHebrew": "<string>",
      "isCustom": true,
      "notes": "<string>",
      "videoLink": "<string>",
      "mediaDisplay": "gif",
      "trackRm1": true,
      "isFavorite": true,
      "alternativeExercises": [
        {
          "exerciseId": "<string>",
          "name": "<string>",
          "nameHebrew": "<string>"
        }
      ]
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "hasMore": true,
    "truncated": true
  }
}
```

### Error responses 400, 401, 403, 429, 500

Content type: `application/json`

| Field | Type | Description |
|---|---|---|
| `error` | object |   |
| `error.code` | string |   |
| `error.message` | string |   |
| `error.fix` | string \| null |   |
| `error.details` | object \| null |   |
| `error.retryAfterMs` | number \| null |   |

Example:

```json
{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "fix": "<string>",
    "details": {},
    "retryAfterMs": 123
  }
}
```

## Examples

### cURL

```bash
curl --request GET \
  --url 'https://api.coach-platform.com/api/public/exercises/settings' \
  --header 'Authorization: Bearer cp_live_...'
```

### JavaScript (fetch)

```js
const response = await fetch('https://api.coach-platform.com/api/public/exercises/settings', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer cp_live_...',
  },
});

const data = await response.json();
```

## Related endpoints

- [Search the exercise catalog](https://www.coach-platform.com/docs/api/reference/get-exercises/index.md): `GET /api/public/exercises`. Search the exercises catalog (name, muscle group).
- [The coach's global settings for one exercise](https://www.coach-platform.com/docs/api/reference/get-exercises-exercise-id-settings/index.md): `GET /api/public/exercises/{exerciseId}/settings`. The coach's global settings for one exercise.
- [Change the coach's global settings for one exercise, the same…](https://www.coach-platform.com/docs/api/reference/patch-exercises-exercise-id-settings/index.md): `PATCH /api/public/exercises/{exerciseId}/settings`. Change the coach's global settings for one exercise, the same settings as the exercise library in the dashboard.
- Previous: [Search the exercise catalog](https://www.coach-platform.com/docs/api/reference/get-exercises/index.md): `GET /api/public/exercises`. Search the exercises catalog (name, muscle group).
- Next: [The coach's global settings for one exercise](https://www.coach-platform.com/docs/api/reference/get-exercises-exercise-id-settings/index.md): `GET /api/public/exercises/{exerciseId}/settings`. The coach's global settings for one exercise.
