Skip to main content
GET
Get a video

Authorizations

X-Auth-Token
string
header
required

API key created in the dashboard or via POST /v1/api/api-keys. Keys are prefixed pn_ and do not expire until revoked.

Path Parameters

videoId
string
required

Video ID (GUID)

Example:

"657bb740-a71b-4529-a012-528021c31a92"

Response

Video details

videoId
string
title
string
availableResolutions
string

Comma-separated encoded resolutions

Example:

"360p,720p,1080p"

length
number

Duration in seconds

status
integer

See VideoSummary.status

encodeProgress
number
storageSize
integer

Size in bytes

captions
object[]
streamUrl
string<uri>

Base CDN URL for the account

chaptersUrl
string<uri>

WebVTT chapters file

hlsUrl
string<uri>
preview
string<uri>

Animated preview (WebP)

thumbnail
string<uri>

Poster image (JPEG)

tags
object[]
metaTags
object[]
audioStatus
enum<string> | null

Standalone audio extraction state

Available options:
pending,
ready,
failed,
null
audioUrl
string<uri> | null

M4A audio URL, present when audioStatus is ready

alignStatus
enum<string> | null

Karaoke alignment job state

Available options:
pending,
ready,
failed,
null