---
title: "Get Calendar V2"
method: GET
path: "/calendar/v2/"
---

# Get Calendar V2

`GET /calendar/v2/`

## Query parameters

- `account_ids` string, required — Comma-separated account IDs
- `start_date` string, date, required — Start date (YYYY-MM-DD)
- `end_date` string, date, required — End date (YYYY-MM-DD)

## Response `200`

OK

- CalendarV2Response
  - `drafts` CalendarDraftResponse[], required
    - `id` integer, required
    - `social_set_id` integer, required
    - `preview` string, nullable
    - `draft_title` string, nullable
    - `status` string, required
    - `tags` string[]
    - `num_tweets` integer
    - `errors` string[]
    - `scheduled_date` string, date-time, nullable
    - `scheduled_natural_posting_time_enabled` boolean
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, nullable
    - `published_at` string, date-time, nullable
    - `x_post_enabled` boolean
    - `linkedin_post_enabled` boolean
    - `mastodon_post_enabled` boolean
    - `threads_post_enabled` boolean
    - `bluesky_post_enabled` boolean
    - `substack_post_enabled` boolean
    - `x_post_published_at` string, date-time, nullable
    - `linkedin_post_published_at` string, date-time, nullable
    - `mastodon_post_published_at` string, date-time, nullable
    - `threads_post_published_at` string, date-time, nullable
    - `bluesky_post_published_at` string, date-time, nullable
    - `substack_post_published_at` string, date-time, nullable
    - `x_published_url` string, nullable
    - `linkedin_published_url` string, nullable
    - `mastodon_published_url` string, nullable
    - `threads_published_url` string, nullable
    - `bluesky_published_url` string, nullable
    - `substack_published_url` string, nullable
    - `x_post_status` integer, nullable
    - `linkedin_post_status` integer, nullable
    - `mastodon_post_status` integer, nullable
    - `threads_post_status` integer, nullable
    - `bluesky_post_status` integer, nullable
    - `substack_post_status` integer, nullable
    - `pinned` boolean
    - `is_publicly_shared` boolean

## Changes

- **2026-07-26** `86b66d1742c2` — 4 info
  - added the optional property `drafts/items/substack_post_enabled` to the response with the `200` status
  - added the optional property `drafts/items/substack_post_published_at` to the response with the `200` status
  - added the optional property `drafts/items/substack_post_status` to the response with the `200` status
  - added the optional property `drafts/items/substack_published_url` to the response with the `200` status

[Change history](https://skmtc.dev/typefully/apis/ninjaapi/changes/calendar/v2/get.md)

---

[API](https://skmtc.dev/typefully/apis/ninjaapi.md) · [All operations](https://skmtc.dev/typefully/apis/ninjaapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/typefully/ninjaapi/revisions/86b66d1742c2/schema)