Get video

Retrieves a single video by its ID, including the full list of scenes with their captions, media, audio, and generation state. Use this endpoint to inspect a video after drafting or to poll its rendering progress.

Get video

get

Authorizations

bearerAuth

AuthorizationstringRequired

Your ShortGenius API token

Path parameters

idstring · uuidRequired

The unique ID of the video to retrieve.

Responses

200

Successful response

application/json

Details about the created or retrieved video, including scenes and their media.

idstring · uuidRequired

titlestring · max: 100 · nullableOptional

captionstring · max: 4000 · nullableOptional

created_atstringRequired

Date and time (ISO 8601) when the video was created.

updated_atstring · nullableOptional

Date and time (ISO 8601) when the video was last updated.

series_idstring · uuidRequired

ID of the associated series.

publishing_statestring · enumRequired

Upload status of the video.

Possible values:

publish_atstring · nullableRequired

Date and time (ISO 8601) when the video was fully uploaded.

400

Invalid request

application/json

get

/videos/{id}

HTTPcURLJavaScriptPython

GET /v1/videos/{id} HTTP/1.1
Host: api.shortgenius.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": null,
  "caption": null,
  "created_at": "text",
  "updated_at": null,
  "series_id": "123e4567-e89b-12d3-a456-426614174000",
  "publishing_state": "pending",
  "publish_at": null
}