Get Transcoding

Retrieve the accepted settings, published files and current state of one Transcoding.

GET

/transcodings/{transcodingId}

Authorization

header

string

required

Enter the project access token with the Bearer prefix, e.g. "Bearer project_access_token"

Path Parameters

transcodingId

string

required

TranscodingId identifies a Transcoding in the authenticated Project.

Responses

application/json

data

object

required

Data contains the Transcoding.

created_at

string

date-time

required

CreatedAt specifies when the request was accepted.

files

object[]

required

Files contains the published output files and their measured properties, ordered by creation time. Empty until publication. Presigned URLs are refreshed on each read and included in lifecycle webhooks when available.

created_at

string

date-time

required

CreatedAt records when the validated file was published.

duration

number

required

Duration specifies the measured output duration in seconds.

string

required

Id identifies this published Transcoding file.

mime_type

string

required

MimeType specifies the media content type.

path

string

required

Path specifies the output path relative to the Storage base_prefix saved when the Transcoding was created. Later Storage prefix changes do not move this file.

size

integer

required

Size specifies the measured file size in bytes.

Required range: x >= 1

storage_id

string

required

StorageId identifies the output Storage.

thumbnails

object[]

required

Thumbnails contains available dashboard preview images. Empty for audio-only files, failed previews or expired files.

transcoding_id

string

required

TranscodingId identifies the Transcoding that produced this file.

audio_bitrate

integer

AudioBitrate specifies measured audio bits per second, or zero when unavailable. Omitted without audio.

audio_codec

string

AudioCodec specifies the measured audio codec. Omitted without audio.

audio_samplerate

integer

AudioSamplerate specifies measured audio samples per second. Omitted without audio.

cdn_url

string

CdnUrl provides the URL from the Storage CDN configuration. Omitted without a configured CDN or after file expiry.

expires_at

string

date-time

ExpiresAt specifies when a temporary output expires. Omitted for customer-owned output storage.

height

integer

Height specifies the measured video height in pixels. Omitted for audio-only files.

thumbnail_status

string

ThumbnailStatus reports the optional dashboard preview result. Failure does not affect the media file. Omitted for audio-only files.

Available options:

readyfailed

url

string

Url provides a signed download valid for at most ten minutes. Omitted when the file has expired or signing is unavailable.

video_bitrate

integer

VideoBitrate specifies measured video bits per second, or zero when unavailable. Omitted without video.

video_codec

string

VideoCodec specifies the measured video codec. Omitted for audio-only files.

video_framerate

number

VideoFramerate specifies measured video frames per second. Omitted without video.

width

integer

Width specifies the measured video width in pixels. Omitted for audio-only files.

format

object

required

Format contains the resolved encoding settings accepted at creation, including defaults, dimensions, frame rate and normalized seek and duration. Per-title rate control is resolved during processing. Measured media properties are available in Files.

duration

number

required

Duration specifies the accepted output duration in seconds, including normalized trims.

string

required

Id specifies the resolved container and codec selection.

Available options:

mp4_h264mp4_h265mp4_av1webm_vp9m4a_aac

seek

number

required

Seek specifies the accepted start position in source seconds, normalized to the output timeline.

Required range: x >= 0

audio_bitrate

integer

AudioBitrate specifies the resolved audio bitrate in bits per second. Omitted for video-only output.

Required range: 32000 <= x <= 512000

audio_samplerate

integer

AudioSamplerate specifies the resolved audio samples per second. Omitted for video-only output.

Required range: 8000 <= x <= 96000

bufsize

integer

Bufsize specifies the resolved video buffer size in bits, including codec-level defaults. Omitted when no buffer applies.

Required range: 1 <= x <= 5e+07

channels

integer

Channels specifies the resolved audio channel count: 1, 2, 6 or 8. Omitted for video-only output.

Required range: 1 <= x <= 8

cpu_used

string

CpuUsed specifies the accepted VP9 encoder speed setting from 0 through 8. Omitted for other codecs.

crf

integer

Crf specifies the accepted constant quality. Omitted for bitrate-controlled, per-title and audio-only encoding.

Required range: 0 <= x <= 63

disable_audio

boolean

DisableAudio is true for video-only output. Omitted when audio is selected.

framerate

number

Framerate specifies the resolved video frames per second. Omitted for audio-only output.

Required range: 0.001 <= x <= 240

gop

integer

Gop specifies the resolved maximum keyframe interval in frames. Omitted for audio-only output.

Required range: 1 <= x <= 960

height

integer

Height specifies the resolved video height in pixels. Omitted for audio-only output.

Required range: 2 <= x <= 7680

level

integer

Level specifies the accepted codec level when explicitly selected.

maxrate

integer

Maxrate specifies the resolved maximum video bitrate in bits per second, including codec-level defaults. Omitted when no maximum applies.

Required range: 1 <= x <= 1e+08

minrate

integer

Minrate specifies the accepted minimum video bitrate in bits per second, when configured.

Required range: 1 <= x <= 5e+07

movflags

string

Movflags specifies MP4 packaging. MP4 video exports use faststart.

per_title

boolean

PerTitle specifies whether video rate control is selected during content analysis. Omitted for audio-only output.

pixfmt

string

Pixfmt specifies the accepted video pixel format. Omitted for audio-only output.

preset

string

Preset specifies the accepted codec preset. Omitted when the codec does not use presets.

profilev

string

Profilev specifies the accepted codec profile when explicitly selected.

quality

string

Quality specifies the accepted VP9 deadline policy: good, best or realtime. Omitted for other codecs.

video_bitrate

integer

VideoBitrate specifies the accepted video bitrate in bits per second. Omitted for CRF and per-title encoding.

Required range: 1 <= x <= 1e+08

width

integer

Width specifies the resolved video width in pixels. Omitted for audio-only output.

Required range: 2 <= x <= 7680

string

required

Id uniquely identifies the Transcoding.

metadata

object

required

Metadata contains the string values attached to the Transcoding.

status

string

required

Status is ready only after the output is validated and published. Temporary output becomes expired when its files are no longer available.

Available options:

preparingreadyfailedcancelledexpired

storage

object

required

Storage contains the resolved output destination.

updated_at

string

date-time

required

UpdatedAt specifies when the request was last updated.

created_by_token_id

string

CreatedByTokenId specifies the Project token used to create the resource. It remains set after the token is revoked. Omitted for dashboard requests, MCP OAuth connections, Workflow actions, and unknown creators.

Examples:

tok_2G6MJiNz71bHQGNzGwKx5cJwPFS

created_by_user_id

string

CreatedByUserId specifies the team member who created the resource. Omitted for Workflow actions, unknown creators, and deleted accounts.

Examples:

u_2G6MJiNz71bHQGNzGwKx5cJwPFS

created_via

string

CreatedVia specifies how the resource was created: api for API requests, dashboard for the Chunkify dashboard, mcp for MCP clients, and workflow for Workflow actions. Omitted when the creator is unknown.

Available options:

apidashboardmcpworkflow

Examples:

api

delete_at

string

date-time

DeleteAt specifies when this record is deleted: three days after its temporary output expires, otherwise when the team's data retention period ends, counted from when the request was accepted, and no sooner than three days after it finished. It does not delete files in customer-owned Storage. Omitted while the Transcoding is preparing.

error

object

Error describes why processing failed. Omitted when no processing error exists.

expires_at

string

date-time

ExpiresAt specifies when temporary output files expire. Omitted for customer output Storage and before the Transcoding is ready.

processing_stage

string

ProcessingStage specifies the current preparation activity. queued means the request is waiting for processing capacity.

Available options:

queuedstartingencodingfinalizinguploading

progress

number

Progress specifies the video encoding percentage. Available once processing starts and after the output is ready. Omitted for audio-only output; 100 requires published output.

Required range: 0 <= x <= 100

ready_at

string

date-time

ReadyAt specifies when the output was published. Omitted before the Transcoding is ready.

source_id

string

SourceId identifies the original Source. Omitted after Source deletion.

status

"success"

string

required

Status is success for a successful request.

Get Transcoding

application/json

error

object

required

status

"error"

string

required

Status indicates the response status "error"

Validation error

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Authentication error

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Forbidden error

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

NotFound error

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

TooManyRequests error

application/json

error

object

required

status

"error"

string

required

Unexpected error

import Chunkify from '@chunkify/chunkify'; const client = new Chunkify({ projectAccessToken: 'My Project Access Token', }); const transcoding = await client.transcodings.retrieve('tcg_example'); console.log(transcoding);

package main import ( "context" "fmt" "github.com/chunkifydev/chunkify-go" "github.com/chunkifydev/chunkify-go/option" ) func main() { client := chunkify.NewClient( option.WithProjectAccessToken("My Project Access Token"), ) transcoding, err := client.Transcodings.Get( context.TODO(), "tcg_example", ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", transcoding) }

{ "data": { "created_at": "2026-10-16T10:00:00Z", "files": [ { "cdn_url": "https://cdn.example.com/exports/video.mp4", "created_at": "2026-10-16T10:01:00Z", "duration": 60.1, "height": 720, "id": "tcf_example", "mime_type": "video/mp4", "path": "exports/video.mp4", "size": 1234567, "storage_id": "stor_example", "thumbnail_status": "failed", "thumbnails": [], "transcoding_id": "tcg_example", "url": "https://storage.example.com/exports/video.mp4?signature=example", "video_bitrate": 1500000, "video_codec": "h264", "video_framerate": 30, "width": 1280 } ], "format": { "crf": 21, "disable_audio": true, "duration": 60.1, "framerate": 30, "gop": 120, "height": 720, "id": "mp4_h264", "movflags": "faststart", "per_title": false, "pixfmt": "yuv420p", "preset": "faster", "seek": 0, "width": 1280 }, "id": "tcg_example", "metadata": {}, "progress": 100, "ready_at": "2026-10-16T10:01:00Z", "source_id": "src_example", "status": "ready", "storage": { "id": "stor_example", "path": "exports/video.mp4" }, "updated_at": "2026-10-16T10:01:00Z" }, "status": "success" }