---
title: Get a Scheduled Post - Retrieve Post Details
description: Fetch a single scheduled post by ID with the PostNitro Embed API. Get its captions, social accounts, design details, and publishing status.
canonical: https://postnitro.ai/docs/embed/api/schedule/get-scheduled-post
---

# 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](https://postnitro.ai/docs/embed/api/schedule#authentication).

## Path parameters

| Param | Required | Description |
| --- | --- | --- |
| `id` | yes | Scheduled post id |

## Example request

```bash
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](https://postnitro.ai/docs/embed/api/schedule/scheduled-post-object) — with its
`postContents`, `socialAccounts`, and flattened `designDetails` (or `null` when no
design is attached).

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