---
title: "Get publication status"
method: GET
path: "/publications/{publicationId}"
tags: ["Publishing"]
---

# Get publication status

`GET /publications/{publicationId}`

Returns the current status of a publication. Poll this after `POST /publications` to track progress.

**Status flow:** Immediate publishes typically move `exporting` -> `uploading` -> `published` (or `failed` at any stage).
Scheduled publishes may move into `scheduled` first, depending on platform behavior.

**Polling recommendation:** Check every 10-15 seconds until the upload reaches a stable state such as `published`, `scheduled`, or `failed`.

## Path parameters

- `publicationId` string, uuid, required — Publication ID from `POST /publications`.

## Response `200`

OK

- object
  - `id` string, uuid, required — Publication ID.
  - `videoId` string, uuid, required — The video ID being published.
  - `channelId` string, uuid, required — Target channel ID.
  - `title` string, required — Video title as published.
  - `description` string, nullable, required — Description/caption as published.
  - `status` 'draft' | 'scheduled' | 'exporting' | 'uploading' | 'published' | 'failed' | 'canceled', required — Current publication status. - `exporting`: Video MP4 is being rendered. - `uploading`: Uploading to the platform. - `scheduled`: The platform accepted a future publish time and is waiting. - `published`: Upload completed on the platform. If `scheduledAt` is in the future, the platform may still be waiting to make it public. - `failed`: Something went wrong. Check `errorMessage`. - `canceled`: The scheduled publication was canceled before going live.
  - `platformVideoId` string, nullable, required — Video ID on the platform (e.g. YouTube video ID). Available after publishing.
  - `platformVideoUrl` string, nullable, required — Direct URL to the published video. Available after publishing.
  - `errorMessage` string, nullable, required — Error details if status is `failed`.
  - `scheduledAt` string, date-time, nullable, required — When the video is scheduled to publish. Null if publishing immediately.
  - `publishedAt` string, date-time, nullable, required — When the video was actually published.
  - `createdAt` string, date-time, required — When the publication was created (ISO 8601).

## Other responses

- `401` — 401
- `402` — 402
- `403` — 403

---

[API](https://skmtc.net/aituber/apis/aituber-api.md) · [All operations](https://skmtc.net/aituber/apis/aituber-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aituber/aituber-api/revisions/35448566f143/schema)