---
title: "Read the Calendar feed for a date range"
method: GET
path: "/v1/workspaces/{workspaceId}/calendar/feed"
tags: ["Calendar"]
---

# Read the Calendar feed for a date range

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

## 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/feed`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, uuid, required

## Query parameters

- `startDate` string, required
- `endDate` string, required
- `status` 'draft' | 'pending_approval' | 'rejected' | 'scheduled' | 'sent' | 'failed' | 'cancelled', nullable
- `statuses` string[]
- `workflowStatus` 'drafting' | 'review' | 'approved' | 'scheduled' | 'published', nullable
- `workflowStatuses` string[]
- `integrationId` string, uuid, nullable
- `campaignId` string, uuid, nullable
- `platforms` string[]
- `channels` string[]
- `labelIds` string[]
- `assignment` 'all' | 'assigned_to_me' | 'unassigned', nullable
- `includeSelectedChannels` boolean, nullable
- `includeTasks` boolean

## Response `200`

Calendar result

- object
  - `data` PublicCalendarFeedDto, required
    - `items` object[], required
      - `id` string, uuid, required
      - `itemKind` 'content' | 'plannedDraft', required
      - `postId` string, uuid, required
      - `title` string, nullable, required
      - `captionSummary` string, nullable, required
      - `status` 'draft' | 'pending_approval' | 'rejected' | 'scheduled' | 'sent' | 'failed' | 'cancelled', required
      - `workflowStatus` 'drafting' | 'review' | 'approved' | 'scheduled' | 'published', required
      - `plannedAt` string, date-time, nullable, required
      - `scheduledAt` string, date-time, nullable, required
      - `calendarAt` string, date-time, nullable, required
      - `sentAt` string, date-time, nullable, required
      - `integrationId` string, uuid, nullable, required
      - `platform` string, nullable, required
      - `accountLabel` string, nullable, required
      - `postType` string, nullable, required
      - `contentMedia` PublicContentMediaAttachmentDto[], required
        - `mediaId` string, uuid, required
        - `order` number, required
        - `type` string, nullable, required
        - `url` string, nullable, required
        - `thumbnailUrl` string, nullable, required
        - `filename` string, nullable, required
        - `crops` object, required
        - `userTags` object[], required
        - `productTags` object[], required
        - `cover` object, nullable, required
      - `labels` object[], required
        - `id` string, uuid, required
        - `name` string, required
        - `color` string, nullable, required
      - `pillars` PublicContentPillarDto[], required
        - `id` string, uuid, required
        - `name` string, required
        - `color` string, nullable, required
        - `description` string, nullable
        - `sortOrder` number, required
        - `archivedAt` string, nullable
      - `formats` PublicContentFormatDto[], required
        - `id` string, uuid, required
        - `name` string, required
        - `color` string, nullable, required
        - `description` string, nullable
        - `sortOrder` number, required
        - `isSeeded` boolean
        - `archivedAt` string, nullable
      - `campaignId` string, uuid, nullable, required
      - `priority` string, nullable, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `tasks` object[], required
      - `id` string, uuid, required
      - `title` string, required
      - `dueDate` string, required
      - `state` 'open' | 'overdue' | 'completed', required
      - `priority` 'urgent' | 'high' | 'medium' | 'low', nullable, required
      - `column` object, required
        - `id` string, uuid, required
        - `name` string, required
        - `systemKey` 'backlog' | 'in_progress' | 'review' | 'done', nullable, required
      - `labels` object[], required
        - `id` string, uuid, required
        - `name` string, required
        - `color` string, nullable, required
        - `groupId` string, uuid, nullable, required
      - `checklist` object, required
        - `completed` number, required
        - `total` number, required
      - `linkedContent` object, nullable, required
        - `postId` string, uuid, required
        - `title` string, nullable, required
        - `snippet` string, required
        - `stage` 'idea' | 'drafting', required
        - `effectiveStage` 'idea' | 'drafting' | 'review' | 'scheduled' | 'published', required
        - `boardAddedAt` string, date-time, nullable, required
        - `updatedAt` string, date-time, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `pagination` object, required
      - `total` number, required
      - `limit` number, required
      - `offset` number, required
      - `hasMore` boolean, required
      - `taskTotal` number
      - `tasksTruncated` boolean
  - `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)