Skip to main content
GET
Read the outcome of a post

Authorizations

Authorization
string
header
required

Your API key, sent as Authorization: Bearer <key>. One key manages every profile on the account.

Query Parameters

request_id
string

Id of a published (or in-flight) post, returned by the publish call.

job_id
string

Id of a scheduled or queued job, returned by the publish call.

Response

Success.

status
enum<string>

processing and scheduled are not outcomes yet — poll GET /v1/posts/status. draft: no channel refused, but at least one holds the post as a draft (see results.<channel>.draft); it is final. canceled comes from a status poll only: a scheduled post that was cancelled before it ran. unknown: the publish call stopped waiting before the channels answered (502 upstream_timeout) and their side has not picked the post up yet; keep polling.

Available options:
completed,
draft,
partial,
failed,
processing,
scheduled,
canceled,
unknown
profile_id
string
platforms
string[]
failed_platforms
string[]

Present only when at least one channel refused.

request_id
string | null
job_id
string | null
truncated
object[]

Present only when the shared caption was cut to fit a channel. One entry per channel and text: text is title, caption or description, field the channel field the cut text went in, length the caption's length and limit the cap, both in unit (utf16 characters, or utf8 bytes for YouTube's description). Every channel not listed received the full caption.

results
object | null

Keyed by channel.

warnings
object[]

Present only when a channel published the post but not exactly as asked — for example a TikTok photo that went out without the requested music. status is not changed by a warning: the post is live, so do not retry it. On an async post warnings appear on GET /v1/posts/status, not on the first publish response. A warning a platform returns only with the first answer of a post is on the publish response only.