---
title: "Recipients of a campaign and their status"
method: GET
path: "/api/v1/workspaces/{workspaceId}/campaigns/{campaignId}/recipients"
tags: ["Campaigns"]
---

# Recipients of a campaign and their status

`GET /api/v1/workspaces/{workspaceId}/campaigns/{campaignId}/recipients`

## Request

- Base URL: `https://otprun.com`
- URL: `https://otprun.com/api/v1/workspaces/{workspaceId}/campaigns/{campaignId}/recipients`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` integer, required
- `campaignId` integer, required

## Query parameters

- `status` 'pending' | 'queued' | 'skipped' | 'failed' | ''
- `after` integer: Return recipients with a larger id, for paging

## Response `200`

OK

- RecipientsOutputBody
  - `items` RecipientBody[], nullable, required
    - `error` string, required
    - `id` integer, required
    - `message_status` string, required
    - `name` string, required
    - `phone` string, required
    - `status` 'pending' | 'queued' | 'skipped' | 'failed', required
    - `updated_at` string, date-time, required

## Other responses

- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/otprun/apis/otp-run-api.md) · [All operations](https://skmtc.dev/otprun/apis/otp-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/otprun/apis/otp-run-api/revisions/43d40d5f4050?raw)