DocumentationGet Upload Status

Get Upload Status

Check the processing status of your remote URL upload job. Use the jobId from the create response as assetId.

Endpoints

GET/api/videos/:assetId/status

Get upload and processing status.

POST/api/videos/:assetId/status

Get upload and processing status.

Example 1: Processing State

When the video is still being processed

Request

curl -X GET "https://theamplium.com/api/videos/JOB_ID/status" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "Processing",
  "percent": 50,
  "created_at": "2026-06-04T12:00:00.000000+00:00",
  "url": null
}

Example 2: Complete State

When the video processing is complete

Request

curl -X GET "https://theamplium.com/api/videos/JOB_ID/status" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "Complete",
  "percent": 100,
  "created_at": "2026-06-04T12:00:00.000000+00:00",
  "url": "https://cdn.example.com/path/to/primary.m3u8"
}

Example 3: Error State

When video upload or processing failed

Request

curl -X GET "https://theamplium.com/api/videos/JOB_ID/status" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "Error",
  "percent": 0,
  "message": "Failed to encode video.",
  "created_at": "2026-06-04T12:00:00.000000+00:00",
  "url": null
}

Error Response

When an error occurs, the API returns a JSON response with this structure:

{
  "error": "BadRequest",
  "message": "isEncode must be true or false."
}

HTTP Error Codes

Code	Error Type
400	BadRequest
401	Unauthorized
403	Forbidden
404	NotFound
413	PayloadTooLarge
415	UnsupportedMediaType
500	InternalServerError