# List eligible athletes `GET /api/v1/athlete-equipment/athletes` Lists athletes eligible for an equipment loan in the selected sport. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Athlete equipment → Read**. ## 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 - `q` (string) — Search by given name or surname, up to 200 characters. - `page` (integer) — One-based page number. Defaults to 1. ## 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/athlete-equipment/athletes" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "X-Sport-Id: ${SPORT_ID:?Set SPORT_ID}" \ --data-urlencode "q=Example" \ --data-urlencode "page=1" ``` ## Response **200 OK** Returns athlete IDs and labels in `items`, with a page size of 20 and the total number of matches. Example with fictional data and selected fields. ```json { "items": [ { "id": 42, "label": "Example Alex" } ], "page": 1, "pageSize": 20, "total": 1 } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks the required permission. - `422` — One or more fields failed validation. - `503` — The equipment module is temporarily unavailable.