# List campaign recipients `GET /api/v1/campaigns/{id}/recipients` Lists recipient activity for a sent campaign. ## 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. ## Query parameters - `event` (string) — Use all, the default, or opened for tracked opens. - `start` (integer) — Zero-based offset. Defaults to 0. - `length` (integer) — Page size from 1 to 100. Defaults to 25. - `q` (string) — Search recipient name or email. ## 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/campaigns/${ID:?Set ID}/recipients" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "X-Sport-Id: ${SPORT_ID:?Set SPORT_ID}" \ --data-urlencode "event=all" \ --data-urlencode "length=25" ``` ## Response **200 OK** Returns matching recipients with send and open times in Unix seconds. The counts are before and after text search. Example with fictional data and selected fields. ```json { "status": "success", "data": [ { "id": 41, "recipient_name": null, "recipient_email": "reader@example.com", "status": "sent", "sent_at": 1794564000, "opened_at": null } ], "records_total": 1, "records_filtered": 1 } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks the required permission. - `404` — The requested record was not found. - `409` — The campaign has not been sent or open tracking is disabled for the opened filter. - `422` — One or more fields failed validation.