---
title: List Scheduled Posts - Fetch Your Content Calendar
description: Retrieve scheduled posts and drafts within a date range using the PostNitro Embed API. List planned social content across LinkedIn, Instagram, TikTok, and Threads.
canonical: https://postnitro.ai/docs/embed/api/schedule/list-scheduled-posts
---

# List scheduled posts

```
GET /schedule
```

Returns the scheduled posts (and drafts) for the workspace attached to your API
key whose `scheduledAt` falls within a date range.

## Authentication

`embed-api-key: <YOUR_EMBED_API_KEY>` header required. See [auth](https://postnitro.ai/docs/embed/api/schedule#authentication).

## Query parameters

| Param | Required | Description |
| --- | --- | --- |
| `fromDate` | yes | Start of range. Any value parseable by `Date` (ISO-8601 recommended). Matches `scheduledAt >= fromDate`. |
| `toDate` | yes | End of range. Matches `scheduledAt <= toDate`. |

> You do **not** send `workspaceId` — it's resolved from your API key.

## Example request

```bash
curl -G "https://embed-api.postnitro.ai/schedule" \
  -H "embed-api-key: $EMBED_API_KEY" \
  --data-urlencode "fromDate=2026-07-01T00:00:00Z" \
  --data-urlencode "toDate=2026-07-31T23:59:59Z"
```

## Response `200`

`data` is an array of [scheduled-post objects](https://postnitro.ai/docs/embed/api/schedule/scheduled-post-object). Each
includes its selected `socialAccounts`, persisted `postContents`, and a flattened
`designDetails` (or `null` when there's no attached design).

```jsonc
{
  "success": true,
  "data": [
    {
      "id": "cmqkvnhk50001v0qusiglvc8h",
      "designId": "gpmg7dl0t73tukqvbnrtoqw6",
      "labels": null,
      "status": "SCHEDULED",
      "scheduledFor": "2026-06-20T10:00:00.000Z",
      "publishedAt": null,
      "errorMessage": null,
      "postSettings": null,
      "instagramPostSettings": null,
      "linkedinPostSettings": { "postType": "document", "postTitle": "fsdfsdfds" },
      "tiktokPostSettings": null,
      "threadsPostSettings": null,
      "postContents": [
        { "platform": "common", "text": "My draft caption", "hashtags": [] }
      ],
      "designDetails": {
        "id": "gpmg7dl0t73tukqvbnrtoqw6",
        "name": "FIFA's 2026 World Cup Will Print $10.9 Billion — Here's Who Gets What",
        "designType": "carousel",
        "source": "editor"
      },
      "socialAccounts": [
        {
          "socialAccountId": "cmqi7jyir0003v0m91hxnyyaq",
          "liveLink": null,
          "errorMessage": null,
          "status": "PENDING",
          "publishedAt": null
        }
      ],
      "createdAt": "2026-06-19T12:00:38.309Z",
      "updatedAt": "2026-06-19T12:00:38.309Z"
    }
  ]
}
```

## Errors

| Status | Body | When |
| --- | --- | --- |
| `401` / `402` | see [auth](https://postnitro.ai/docs/embed/api/schedule#authentication) | Auth / plan failure |
| `422` | `{ "status": false, "message": "From date is required" }` | `fromDate` missing |
| `422` | `{ "status": false, "message": "From date is not a valid date" }` | `fromDate` unparseable |
| `422` | `{ "status": false, "message": "To date is required" }` | `toDate` missing |
| `422` | `{ "status": false, "message": "To date is not a valid date" }` | `toDate` unparseable |
| upstream | `{ "success": false, "message": "...", "error": ... }` | Processing failure relayed from PostNitro |