> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendify.dingstore.cn/llms.txt
> Use this file to discover all available pages before exploring further.
# 查询营销活动收件人列表
> 分页查询普通批量活动的收件人追踪记录
分页查询当前 API Key 所属用户创建的普通批量活动的收件人追踪记录。不同筛选条件之间取交集，结果按记录 ID 倒序返回。
```http theme={null}
GET https://api.sendify.dingstore.cn/dmx/v2/campaigns/{campaignId}/recipients
```
数据异步更新。尚未生成追踪记录的计划收件人不会出现在列表中，因此 `totalCount` 不保证等于活动统计中的 `recipientCount`。此接口不支持管理员代查、A/B 测试和持续投递活动。
## 认证
```http theme={null}
Authorization: Bearer YOUR_API_KEY
```
## 路径参数
| 参数 | 类型 | 必填 | 说明 |
| - | - | - | - |
| `campaignId` | `string` | 是 | 活动唯一标识，来自营销活动列表的 `id` |
## 查询参数
| 参数 | 类型 | 必填 | 说明 |
| - | - | - | - |
| `pageNo` | `number` | 是 | 页码，从 `1` 开始。页码与每页数量计算出的偏移量不得超过 `2147483647` |
| `pageSize` | `number` | 是 | 每页记录数，取值范围为 `1`～`100` |
| `opened` | `boolean` | 否 | 仅支持 `true` 或不传。`true` 表示筛选已记录打开事件的收件人 |
| `clicked` | `boolean` | 否 | 仅支持 `true` 或不传。`true` 表示筛选已记录跟踪链接点击事件的收件人；点击独立于打开 |
| `dataType` | `enum` | 否 | 主筛选类型，见下表 |
| `filterCode` | `enum` | 否 | 子筛选类型，见下表 |
### `dataType`
| 值 | 说明 |
| - | - |
| `ALL` | 全部，默认值 |
| `POSTED` | 已发送 |
| `DELIVERED` | 已送达 |
| `OPENED` | 已打开 |
| `CLICKED` | 已点击 |
| `UNSUBSCRIBE` | 退订；当前暂不支持此筛选 |
### `filterCode`
| 值 | 说明 |
| - | - |
| `ALL_CONTACT` | 全部，默认值 |
| `POST_FAIL` | 发送失败；包含发送前失败但排除取消 |
| `INVALID_ADDRESS` | 无效收件人 |
| `SENDING` | 发送中 |
| `CANCEL_SEND` | 取消发送 |
| `NOT_SEND` | 未发送；包含发送前失败和取消发送 |
| `COMPLAINT` | 投诉；当前暂不支持此筛选 |
非 `ALL_CONTACT` 子筛选仅可与 `ALL` 或 `POSTED` 组合。`POST_FAIL` 与 `NOT_SEND` 的范围可能重叠，不能将筛选值直接等同于每行的 `postResult`。
## 请求示例
```bash theme={null}
curl -G \
"https://api.sendify.dingstore.cn/dmx/v2/campaigns/campaign-123/recipients" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json" \
--data-urlencode "pageNo=1" \
--data-urlencode "pageSize=50" \
--data-urlencode "dataType=POSTED" \
--data-urlencode "filterCode=ALL_CONTACT"
```
## 成功响应
| 字段 | 类型 | 说明 |
| - | - | - |
| `recipients` | `array