---
title: "List subscribers"
method: GET
path: "/api/calendars/{calendar_public_id}/subscribers"
tags: ["Calendars > Subscribers"]
---

# List subscribers

`GET /api/calendars/{calendar_public_id}/subscribers`

## Request

- Base URL: `https://addcal.co`
- URL: `https://addcal.co/api/calendars/{calendar_public_id}/subscribers`
- Auth: none required

## Query parameters

- `external_id` string: Only return subscribers carrying this external id.
- `per_page` integer: Number of results per page (1-100)

## Request body

- object
  - `external_id` string: Must match the regex /^[A-Za-z0-9._:-]+$/. Must not be greater than 191 characters.
  - `per_page` integer: Must be at least 1. Must not be greater than 100.

## Response `200`

- object
  - `data` object[]
    - `uid` string
    - `public_id` string
    - `service` string
    - `name` string, nullable
    - `email` string, nullable
    - `data` string, nullable
    - `status` string
    - `created_at` string
    - `updated_at` string

---

[API](https://skmtc.dev/addcal/apis/addcal-api-documentation.md) · [All operations](https://skmtc.dev/addcal/apis/addcal-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/addcal/apis/addcal-api-documentation/revisions/addd0607e492?raw)