Skip to main content
GET
/
api
/
partner
/
v1
/
posts
/
{id}
curl --request GET \
  --url https://www.genviral.io/api/partner/v1/posts/11111111-1111-1111-1111-111111111111 \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "code": 200,
  "message": "Post retrieved",
  "data": {
    "id": "11111111-1111-1111-1111-111111111111",
    "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,
    "tiktok": null,
    "pinterest": {
      "board_id": "123456789012345678",
      "title": "Dinner board",
      "link": "https://example.com/recipes",
      "tags": ["Italian recipes", "easy dinner"]
    },
    "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
        }
      ]
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.genviral.io/llms.txt

Use this file to discover all available pages before exploring further.

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

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

​
Response

​
id
string
Post ID.
​
caption
string
Post caption.
​
status
string
Overall status of the post.
​
media
object
Returned in the same shape as create/update payloads.
​
music_url
string | null
TikTok post URL when music is applied; null otherwise.
​
tiktok
object | null
Optional TikTok settings when present on the post; otherwise null.
​
pinterest
object | null
Optional Pinterest settings (board_id, link, title, tags) when present on the post; otherwise null.
​
accounts
object
curl --request GET \
  --url https://www.genviral.io/api/partner/v1/posts/11111111-1111-1111-1111-111111111111 \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "code": 200,
  "message": "Post retrieved",
  "data": {
    "id": "11111111-1111-1111-1111-111111111111",
    "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,
    "tiktok": null,
    "pinterest": {
      "board_id": "123456789012345678",
      "title": "Dinner board",
      "link": "https://example.com/recipes",
      "tags": ["Italian recipes", "easy dinner"]
    },
    "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 - 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