Skip to main content
GET
/
videos
/
{video_id}
Get video status
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.phaseo.app/v1/videos/{video_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": "<string>",
  "polling_url": "<string>",
  "model": "<string>",
  "status": "pending",
  "output_access": "bytes",
  "generation_id": "<string>",
  "created_at": 123,
  "started_at": 123,
  "completed_at": 123,
  "object": "video",
  "poll_after_seconds": 20,
  "provider": "<string>",
  "seconds": 123,
  "size": "<string>",
  "audio": true,
  "content_url": "<string>",
  "download_url": "<string>",
  "expires_at": 123,
  "progress": 123,
  "progress_source": "<string>",
  "asset": {
    "id": "<string>",
    "mime_type": "<string>",
    "bytes": 123,
    "sha256": "<string>",
    "width": 123,
    "height": 123,
    "duration_seconds": 123
  },
  "outputs": [
    {
      "index": 123,
      "mime_type": "<string>",
      "bytes_available": true,
      "content_url": "<string>",
      "download_url": "<string>",
      "expires_at": 123
    }
  ],
  "billing": {},
  "usage": {
    "cost": 123,
    "is_byok": true
  },
  "error": null
}
Fetches the current state of a video generation job and returns the latest provider status payload. Use this endpoint for polling while the job is running.

Authorizations

Authorization
string
header
required

Bearer token authentication

Path Parameters

video_id
string
required

The ID of the video generation request.

Response

200 - application/json

Video status response

id
string
polling_url
string
model
string
status
enum<string>
Available options:
pending,
in_progress,
completed,
failed,
cancelled
output_access
enum<string>
Available options:
bytes,
signed_url,
both
generation_id
string | null
created_at
started_at
completed_at
object
string
Example:

"video"

poll_after_seconds
integer
Example:

20

provider
string
seconds
number
size
string
audio
boolean
content_url
string

Present when output_access includes bytes (authenticated endpoint).

download_url
string | null

Signed first-party URL for direct download when status is completed.

expires_at
integer | null

Unix timestamp (seconds) when the signed download_url expires.

progress
integer | null
progress_source
string
asset
object
outputs
object[]
billing
object
usage
object
error
unknown
Last modified on February 17, 2026