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) and surfaces music_url alongside it.
Path Parameters The ID of the post to retrieve (e.g., post_789).
Response Overall status of the post.
Returned in the same shape as create/update payloads. TikTok post URL when music is applied; null otherwise.
List of per-account status objects including status, error_message,
published_at, last_attempted_at, and published_url.
curl --request GET \ --url https://www.genviral.io/api/partner/v1/posts/post_789 \ --header 'Authorization: Bearer <token>' { "ok" : true , "code" : 200 , "message" : "Post retrieved" , "data" : { "id" : "post_789" , "caption" : "Holiday drops start Monday!" , "status" : "scheduled" , "scheduled_at" : "2025-02-01T15:00:00Z" , "created_at" : "2025-01-20T12:05:11.205Z" , "media" : { "type" : "video" , "url" : "https://cdn.example.com/video.mp4" }, "music_url" : null , "accounts" : { "total" : 2 , "states" : [ { "account_id" : "0f4f54d4-8cce-4fb7-8c7b-befbcb8af812" , "status" : "scheduled" , "published_at" : null , "error_message" : null , "last_attempted_at" : null , "published_url" : null }, { "account_id" : "6b0c8c9c-55ac-4fcb-85ec-70b5a8b0d089" , "status" : "scheduled" , "published_at" : null , "error_message" : null , "last_attempted_at" : null , "published_url" : null } ] } } } Error Responses
401/403 — authentication failed or key lacks workspace access404 not_found — post does not exist under the workspace scope500 get_failed — unexpected database/serialization error 