Skip to main content
GET
/
v1
/
jobs
/
{jobId}
Get Job Status
curl --request GET \
  --url https://api.muvi.video/v1/jobs/{jobId} \
  --header 'Authorization: Bearer <token>'
{
  "jobId": "<string>",
  "status": "<string>",
  "progress": 123,
  "output": {},
  "outputs": {},
  "error": {},
  "createdAt": "<string>",
  "completedAt": {}
}

​
Authentication

This endpoint requires an API key with the check_status scope. 
Authorization: Bearer YOUR_API_KEY

​
Path Parameters

​
jobId
string
required
The unique identifier of the job to retrieve.

​
Response

​
jobId
string
Unique identifier of the job.
​
status
string
Current status of the job. See status enum below.
​
progress
number
Job progress as a percentage: 0 (pending), 50 (processing), 100 (completed).
​
output
string | null
Direct URL string of the first output item. This is a convenience field for quick access. null if the job has not completed yet.
​
outputs
array | null
Full array of output items with detailed metadata. null if the job has not completed yet. Each item contains url, type, thumbnail, and posterImage fields.
​
error
object | null
Error details if the job failed. Contains code and message fields.
​
createdAt
string
ISO 8601 timestamp of when the job was created.
​
completedAt
string | null
ISO 8601 timestamp of when the job completed. null if still in progress.

​
Status Enum

StatusDescription
pendingJob has been submitted and is waiting in the queue.
processingA worker has picked up the job and generation is in progress.
completedJob has finished successfully. Output is available.
failedJob encountered an error. Credits are automatically refunded.
cancelledJob was cancelled by the user. Credits are refunded.

​
Output Type Enum

TypeDescription
videoGenerated video file.
imageGenerated image file.
audioGenerated audio file.
textGenerated text content.

​
Examples

curl -X GET https://api.muvi.video/v1/jobs/job_abc123def456 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Example Response (Completed)

{
  "jobId": "job_abc123def456",
  "status": "completed",
  "progress": 100,
  "output": "https://cdn.muvi.video/outputs/job_abc123def456/output_0.mp4",
  "outputs": [
    {
      "url": "https://cdn.muvi.video/outputs/job_abc123def456/output_0.mp4",
      "type": "video",
      "thumbnail": "https://cdn.muvi.video/outputs/job_abc123def456/thumb_0.jpg",
      "posterImage": "https://cdn.muvi.video/outputs/job_abc123def456/poster_0.jpg"
    }
  ],
  "error": null,
  "createdAt": "2026-02-18T15:00:00Z",
  "completedAt": "2026-02-18T15:02:30Z"
}

​
Example Response (Processing)

{
  "jobId": "job_abc123def456",
  "status": "processing",
  "progress": 50,
  "output": null,
  "outputs": null,
  "error": null,
  "createdAt": "2026-02-18T15:00:00Z",
  "completedAt": null
}

​
Example Response (Failed)

{
  "jobId": "job_abc123def456",
  "status": "failed",
  "progress": 0,
  "output": null,
  "outputs": null,
  "error": {
    "code": "GENERATION_FAILED",
    "message": "The model failed to generate the requested output. Credits have been refunded."
  },
  "createdAt": "2026-02-18T15:00:00Z",
  "completedAt": "2026-02-18T15:01:15Z"
}