Get Post - Genviral

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": null,
    "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
        }
      ]
    }
  }
}

GET

api

partner

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": null,
    "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
        }
      ]
    }
  }
}

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.

caption

string

Post caption.

status

string

Overall status of the post.

media

object | null

Returned in the same shape as create/update payloads, or null for text-only posts.

Show Media object

type

string

video or slideshow.

url

string

Present for video.

urls

string[]

Present for slideshow.

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.

object | null

Optional Pinterest settings (board_id, link, title, tags) when present on the post; otherwise null.

accounts

object

Show Accounts Detail

total

number

states

array

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/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": null,
    "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

List Posts Update Post

​Path Parameters

​Response

​Error Responses

Path Parameters

Response

Error Responses