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.

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


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. Each includes its selected socialAccounts, persisted postContents, and a flattened designDetails (or null when there’s no attached design).


{
  "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	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