# List broadcast recipients

> List per-recipient delivery rows in queue order.

Source: https://sndr.sh/docs/api/broadcasts/list-broadcast-recipients

`GET https://api.sndr.sh/v1/broadcasts/{id}/recipients`

List per-recipient delivery rows in queue order. Offset-paginated; status is pending, sending, sent or failed, and email_id links to GET /emails/{id}. An unknown broadcast returns an empty list.

Scope: `read`

**Path parameters**

- `id` (string, required): Broadcast ID (bca_...).

**Query parameters**

- `limit` (integer): Page size. Default 50, max 500 (larger values fall back to 50).
- `offset` (integer): Number of rows to skip. Default 0.

**Request**

```bash
curl 'https://api.sndr.sh/v1/broadcasts/bca_9b3e6d12-a40/recipients?limit=50&offset=0' \
  -H "Authorization: Bearer $SNDR_API_KEY"
```

**Response** (200)

```json
{
  "data": [
    {
      "id":           "br_7f2c9a41e8d0",
      "broadcast_id": "bca_9b3e6d12-a40",
      "contact_id":   "con_0e6b7f21-c58",
      "email":        "jane@example.com",
      "variables":    {},
      "email_id":     "em_d2a8f6c1-3b9",
      "status":       "sent",
      "sent_at":      "2026-06-01T09:01:12Z",
      "created_at":   "2026-06-01T09:00:00Z"
    }
  ],
  "total": 4200
}
```

**Errors**

- `unauthenticated` (401): Missing or invalid API key.
- `insufficient_scope` (403): The API key is missing the read scope.
