Get a scheduled post


GET /schedule/:id

Fetches a single scheduled post by id from the workspace attached to your API key.

Authentication

embed-api-key: <YOUR_EMBED_API_KEY> header required. See auth.

Path parameters

Param	Required	Description
`id`	yes	Scheduled post id

Example request


curl "https://embed-api.postnitro.ai/schedule/post_123" \
  -H "embed-api-key: $EMBED_API_KEY"

Response `200`

data is a single scheduled-post object — with its postContents, socialAccounts, and flattened designDetails (or null when no design is attached).


{
  "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": "Post id is required" }`	`id` missing
`404`	`{ "success": false, "message": "Post details not found.", "error": ... }`	No matching post in your workspace