> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mosaic.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Social Post

> Get social post status, destination results, links, and available analytics.

Returns the current state for a social post.

Use the `post_id` returned by `POST /social/post`.

For scheduled posts, this endpoint returns `scheduled` while the post is waiting or still processing. After publishing succeeds, the same `post_id` returns `posted` with native destination IDs and URLs when available.

## Request

```bash theme={null}
curl -X GET "https://api.mosaic.so/social/post/[post_id]" \
  -H "Authorization: Bearer mk_your_api_key"
```

## Query Parameters

| Field                  | Type          | Required | Description                                                                                                             |
| ---------------------- | ------------- | -------- | ----------------------------------------------------------------------------------------------------------------------- |
| `social_connection_id` | string (uuid) | No       | Return details using one specific connected account. Useful when a post targets multiple accounts on the same platform. |

## Scheduled Response

```json theme={null}
{
  "post_id": "2d8ca860-f8e0-4f3f-9f2c-337ead6ed91e",
  "status": "scheduled",
  "description": "Launch day recap from the Mosaic team.",
  "thumbnail_url": "https://cdn.yourdomain.com/media/launch-thumbnail.jpg",
  "scheduled_at": "2026-03-10T16:00:00Z",
  "platforms": ["linkedin"],
  "destinations": [
    {
      "social_connection_id": "7f9388af-26e8-4e68-a52b-6b9a0ef3a017",
      "platform": "linkedin",
      "account_name": "Mosaic",
      "account_username": "mosaic-so",
      "profile_url": "https://www.linkedin.com/company/mosaic-so"
    }
  ],
  "links": [],
  "results": [
    {
      "social_connection_id": "7f9388af-26e8-4e68-a52b-6b9a0ef3a017",
      "platform": "linkedin",
      "status": "scheduled",
      "platform_post_id": null,
      "post_url": null,
      "message": null
    }
  ],
  "destination_results": [
    {
      "social_connection_id": "7f9388af-26e8-4e68-a52b-6b9a0ef3a017",
      "platform": "linkedin",
      "status": "scheduled",
      "platform_post_id": null,
      "post_url": null,
      "message": null
    }
  ],
  "analytics": null,
  "stats": null,
  "error": null,
  "created_at": "2026-03-10T15:00:00.000Z",
  "updated_at": "2026-03-10T15:00:01.000Z"
}
```

## Posted Response

```json theme={null}
{
  "post_id": "2d8ca860-f8e0-4f3f-9f2c-337ead6ed91e",
  "status": "posted",
  "description": "Launch day recap from the Mosaic team.",
  "thumbnail_url": "https://cdn.yourdomain.com/media/launch-thumbnail.jpg",
  "scheduled_at": "2026-03-10T16:00:00Z",
  "platforms": ["linkedin"],
  "destinations": [
    {
      "social_connection_id": "7f9388af-26e8-4e68-a52b-6b9a0ef3a017",
      "platform": "linkedin",
      "account_name": "Mosaic",
      "account_username": "mosaic-so",
      "profile_url": "https://www.linkedin.com/company/mosaic-so"
    }
  ],
  "links": [
    {
      "platform": "linkedin",
      "post_url": "https://www.linkedin.com/company/mosaic-so/posts/...",
      "social_connection_id": "7f9388af-26e8-4e68-a52b-6b9a0ef3a017"
    }
  ],
  "results": [
    {
      "social_connection_id": "7f9388af-26e8-4e68-a52b-6b9a0ef3a017",
      "platform": "linkedin",
      "status": "success",
      "platform_post_id": "7351291821454032896",
      "post_url": "https://www.linkedin.com/company/mosaic-so/posts/...",
      "message": null
    }
  ],
  "destination_results": [
    {
      "social_connection_id": "7f9388af-26e8-4e68-a52b-6b9a0ef3a017",
      "platform": "linkedin",
      "status": "success",
      "platform_post_id": "7351291821454032896",
      "post_url": "https://www.linkedin.com/company/mosaic-so/posts/...",
      "message": null
    }
  ],
  "analytics": {
    "status": "success",
    "totals": {
      "likes": 12,
      "comments": 3,
      "shares": null,
      "impressions": 820,
      "views": null,
      "video_views": null,
      "video_viewers": null,
      "video_watch_time_ms": null,
      "engagement": null,
      "clicks": null,
      "saves": null,
      "bookmarks": null,
      "quotes": null
    },
    "platforms": [
      {
        "platform": "linkedin",
        "platform_post_id": "7351291821454032896",
        "post_url": "https://www.linkedin.com/company/mosaic-so/posts/...",
        "metrics": {
          "likes": 12,
          "comments": 3,
          "shares": null,
          "impressions": 820,
          "views": null,
          "video_views": null,
          "video_viewers": null,
          "video_watch_time_ms": null,
          "engagement": null,
          "clicks": null,
          "saves": null,
          "bookmarks": null,
          "quotes": null
        },
        "raw_metrics": {
          "likeCount": 12,
          "commentCount": 3,
          "impressionCount": 820
        }
      }
    ],
    "metadata": {}
  },
  "stats": {
    "status": "success"
  },
  "error": null,
  "created_at": "2026-03-10T16:00:00.000Z",
  "updated_at": "2026-03-10T16:00:09.000Z"
}
```

## Response Details

* `status` is the aggregate post status across destinations.
* `description` and `thumbnail_url` are `null` when unavailable.
* `analytics` can be `null` when analytics is unavailable. `stats` is retained for backward compatibility.
* `destination_results` is the canonical per-destination result list. Use it when a post targets multiple connected accounts on the same platform.
* `platform_post_id` is the native post ID from the destination platform. It can be `null` before a scheduled post publishes.
* For analytics-only reads, use `GET /social/post/{post_id}/analytics`.