Skip to main content
GET
Return the canonical status for a single post, including every account’s state (pending, posted, failed, retry metadata, published URLs, etc.) plus normalized media metadata. Media mirrors the create payload (type + url/urls) or returns null for text-only posts, and surfaces music_url alongside it.

Path Parameters

string
required
The UUID of the post to retrieve (e.g., 11111111-1111-1111-1111-111111111111).

Response

string
Post ID.
string
Post caption.
string
Overall status of the post.
object | null
Returned in the same shape as create/update payloads, or null for text-only posts.
string | null
TikTok post URL when music is applied; null otherwise.
object | null
Optional TikTok settings when present on the post; otherwise null.
object | null
Optional Pinterest settings (board_id, link, title, tags) when present on the post; otherwise null.
object

Error Responses

  • 401 - authentication failed (missing/invalid/revoked token)
  • 402 subscription_required - active Creator/Professional/Business plan required
  • 403 tier_not_allowed - Scheduler tier cannot use Partner API
  • 404 not_found - post does not exist in the authenticated key scope
  • 500 get_failed - unexpected database/serialization error