---
title: "Get post details and status"
method: GET
path: "/get-post/{postGroupId}"
tags: ["Posts"]
---

# Get post details and status

`GET /get-post/{postGroupId}`

Retrieve the details, platform statuses, and posted IDs for a post group.

## Path parameters

- `postGroupId` string, required

## Headers

- `x-publora-user-id` string

## Response `200`

Post details

- object
  - `success` boolean
  - `postGroupId` string
  - `status` 'draft' | 'scheduled' | 'published' | 'failed' | 'partially_published' — Post-group status. Always present.
  - `scheduledTime` string, date-time, nullable — The effective scheduled time stored for this post group. Always present; `null` for drafts and for groups that were never given a time.
  - `platformSettings` object — Per-platform settings currently stored on this post group, keyed by platform. Always present; `{}` when none are set. Mirrors the platformSettings accepted by /create-post and /update-post.
  - `platforms` string[] — Platform connection IDs targeted by this post group (format: platform-platformId). Always present; `[]` when none.
  - `posts` Post[]
    - `platform` 'twitter' | 'linkedin' | 'instagram' | 'threads' | 'tiktok' | 'youtube' | 'facebook' | 'bluesky' | 'mastodon' | 'telegram' | 'pinterest'
    - `platformId` string, nullable — Platform connection ID. Always present; null if the post has no connection resolved.
    - `content` string
    - `status` 'draft' | 'scheduled' | 'pending' | 'processing' | 'published' | 'failed'
    - `postedId` string, nullable — Platform-specific post ID. Always present; null until the post is published.
    - `permalink` string, nullable — Public URL of the published post. Always present; null until the post is published, and null for platforms that expose no permalink.
  - `media` object[] — Attached media inventory in post-group order. Always present; empty when none is attached.
    - `mediaId` string
    - `sourceFileName` string, nullable
    - `fileName` string, nullable
    - `type` string, nullable
    - `mimeType` string, nullable
    - `status` string
    - `failureReason` string, nullable
    - `url` string, nullable

## Other responses

- `404` — Post not found

---

[API](https://skmtc.dev/publora/apis/publora-api.md) · [All operations](https://skmtc.dev/publora/apis/publora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/publora/publora-api/revisions/a1534a88d80a/schema)