# Get the season enrollment report `GET /api/v1/athletes/season-enrollments` Lists athlete enrollment progress for one season. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Read on Athletes, Presubscriptions, Subscriptions, and Memberships**. ## Headers - `X-Sport-Id` (integer, required) — The sport ID from [List sports](/api/sports/list.md). Use the sport the record belongs to. ## Query parameters - `season` (string) — Season label, for example 2026/2027. Defaults to the workspace target season. - `cohort` (string) — Use all, previous, or new. - `status` (string) — Use all, to_contact, needs_subscription, needs_membership, or complete. - `q` (string) — Search the athlete's name. - `athlete_id` (integer) — Filter by athlete ID. - `include_retired` (integer) — Use 1 to include retired athletes. - `include_contacts` (integer) — Use 1 to include parent and athlete contacts. Requires Parents → Read. - `start` (integer) — Zero-based result offset. - `length` (integer) — Page size from 1 to 100. Defaults to 25. ## Request Set ASDINCLOUD_API_KEY and any variables named in the example before running it. ```sh curl --get \ --url "https://api.asdincloud.com/api/v1/athletes/season-enrollments" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "X-Sport-Id: ${SPORT_ID:?Set SPORT_ID}" \ --data-urlencode "season=2026/2027" \ --data-urlencode "length=25" ``` ## Response **200 OK** Returns enrollment states, counts, season settings and dates, and any warnings. When contacts are requested, the response also includes grouped family contacts. Example with fictional data and selected fields. ```json { "status": "success", "season": "2026/2027", "previous_season": "2025/2026", "counts": { "to_contact": 1, "needs_subscription": 0, "needs_membership": 0, "complete": 0 }, "records_total": 1, "records_filtered": 1, "data": [ { "id": 42, "firstname": "Alex", "surname": "Example", "is_retired": false, "previous_season": true, "previous_subscription": true, "previous_membership": false, "request": null, "subscription": null, "membership": null, "membership_required": false, "direct_enrollment": false, "status": "to_contact" } ] } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks the required permission. - `422` — One or more fields failed validation.