Monitoring Processing & Content Status

When to monitor content status

After you upload and ingest a video, it enters the processing pipeline. Before you attempt playback, you should confirm that processing has completed.
Use the GET /video/services/api/v1/contents/{CONTENT_ID} endpoint to check the current status.

To review upload steps, see Uploading Videos (Dashboard & API). To begin playback, see Playing Videos (Web & App Integration).

Key status values

When you create content, the API returns a content ID, a playback ID, and an initial status.

The main status values are

• Preparing: The content has been created and is still being processed.

• Ready: Processing has finished, and playback URLs are available.

Check status with the API

cURL example

Node example

import fetch from "node-fetch";

async function getStatus(contentId, apiToken) {
  const res = await fetch(
    `https://api.videograph.ai/video/services/api/v1/contents/${contentId}`,
    {
      method: "GET",
      headers: {
        accept: "application/json",
        authorization: `Basic ${apiToken}`
      }
    }
  );

  return res.json();
}

Example response fields

Poll until content is ready

Use a simple polling loop to wait until the content reaches status Ready.

// pseudo-code
while (true) {
  const res = await getStatus("CONTENT_ID", "APITOKEN");
  const status = res.data.status;

  if (status === "Ready") {
    break;
  }

  // wait a short interval before polling again
  await new Promise(r => setTimeout(r, 5000));
}