---
title: "List public Calendar snapshots"
method: GET
path: "/v1/workspaces/{workspaceId}/calendar/snapshots"
tags: ["Calendar"]
---

# List public Calendar snapshots

`GET /v1/workspaces/{workspaceId}/calendar/snapshots`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/calendar/snapshots`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, uuid, required

## Query parameters

- `status` 'active' | 'expired' | 'revoked' | 'all', nullable

## Response `200`

Calendar result

- object
  - `data` PublicCalendarShareLinksDto, required
    - `links` PublicCalendarShareLinkDto[], required
      - `id` string, uuid, required
      - `title` string, required
      - `status` 'active' | 'expired' | 'revoked', required
      - `currentVersion` number, required
      - `settings` object, required
        - `version` 1, required
        - `title` string, required
        - `dateRange` object, required
          - `start` string, date-time, required
          - `end` string, date-time, required
        - `filters` object, required
          - `integrationIds` string[]
          - `platforms` string[]
          - `statuses` string[], required
          - `campaignIds` string[]
          - `labelIds` string[]
          - `pillarIds` string[]
          - `formatIds` string[]
          - `includePostedHistory` boolean, required
          - `includeScheduledFuture` boolean, required
          - `includeReviewItems` boolean, required
          - `includeDrafts` boolean, required
          - `includeCalendarNotes` boolean, required
        - `include` object, required
          - `captions` boolean, required
          - `media` boolean, required
          - `postTitles` boolean, required
          - `firstComments` boolean, required
          - `threadPosts` boolean, required
          - `accountNames` boolean, required
          - `accountAvatars` boolean, required
          - `highLevelApprovalState` boolean, required
          - `exactPublishTimes` boolean, required
          - `labels` boolean, required
          - `pillars` boolean, required
          - `formats` boolean, required
      - `dateRange` object, nullable, required
        - `start` string, date-time, required
        - `end` string, date-time, required
      - `expiresAt` string, date-time, required
      - `revokedAt` string, date-time, nullable, required
      - `viewCount` number, required
      - `lastViewedAt` string, date-time, nullable, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `latestGeneratedAt` string, date-time, nullable, required
  - `meta` unknown, required

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)