# Retrieve a campaign `GET /api/v1/campaigns/{id}` Returns one campaign by ID. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Campaigns → Read**. ## Headers - `X-Sport-Id` (integer, required) — The sport ID from [List sports](/api/sports/list.md). Use the sport the record belongs to. ## Path parameters - `id` (integer, required) — ID of the campaign. ## Request Set ASDINCLOUD_API_KEY and any variables named in the example before running it. ```sh curl --request GET \ --url "https://api.asdincloud.com/api/v1/campaigns/${ID:?Set ID}" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "X-Sport-Id: ${SPORT_ID:?Set SPORT_ID}" ``` ## Response **200 OK** The campaign is returned in data. Example with fictional data and selected fields. ```json { "status": "success", "data": { "id": 24, "sport_id": 3, "name": "November club news", "subject": "News from the club", "body_html": "

Registration for the winter program opens this week.

", "track_opens": false, "template_id": null, "recipient_config": null, "status": "draft", "scheduled_at": null, "recipients": 0, "open_count": 0, "open_rate": 0 } } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks the required permission. - `404` — The requested record was not found.