List Jobs
curl --request GET \
--url https://api.muvi.video/v1/jobs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.muvi.video/v1/jobs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.muvi.video/v1/jobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"jobs": [
{}
],
"nextCursor": {},
"hasMore": true
}Task Management
List Jobs
List your jobs with pagination, status filtering, and model filtering.
GET
/
v1
/
jobs
List Jobs
curl --request GET \
--url https://api.muvi.video/v1/jobs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.muvi.video/v1/jobs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.muvi.video/v1/jobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"jobs": [
{}
],
"nextCursor": {},
"hasMore": true
}Authentication
This endpoint requires an API key with thecheck_status scope.
Authorization: Bearer YOUR_API_KEY
Query Parameters
number
default:"20"
Number of jobs to return per page. Maximum value is
100.string
Pagination cursor from a previous response’s
nextCursor field. Use this to fetch the next page of results.string
Filter jobs by status. Accepted values:
pending, processing, completed, failed, cancelled.string
Filter jobs by model slug. Example:
"google/veo-3.1-fast/text-to-video"Response
array
Array of job objects. Each job contains
jobId, status, progress, model, createdAt, and completedAt.string | null
Cursor to use for fetching the next page.
null if there are no more results.boolean
Whether there are more results available beyond this page.
Cursor-Based Pagination
This endpoint uses cursor-based pagination for efficient and consistent traversal of results. Unlike offset-based pagination, cursor-based pagination ensures you never miss or duplicate items even if new jobs are created between requests. How it works:- Make your first request without a
cursorparameter. - If
hasMoreistrue, use thenextCursorvalue from the response as thecursorparameter in your next request. - Repeat until
hasMoreisfalse.
Examples
# List first page
curl -X GET "https://api.muvi.video/v1/jobs?limit=10&status=completed" \
-H "Authorization: Bearer YOUR_API_KEY"
# Fetch next page using cursor
curl -X GET "https://api.muvi.video/v1/jobs?limit=10&cursor=eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTE4VDE1OjAwOjAwWiJ9" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
# Fetch all completed jobs with pagination
all_jobs = []
cursor = None
while True:
params = {"limit": 50, "status": "completed"}
if cursor:
params["cursor"] = cursor
response = requests.get(
"https://api.muvi.video/v1/jobs",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params=params
)
data = response.json()
all_jobs.extend(data["jobs"])
if not data["hasMore"]:
break
cursor = data["nextCursor"]
print(f"Total completed jobs: {len(all_jobs)}")
// Fetch all completed jobs with pagination
const allJobs = [];
let cursor = null;
do {
const params = new URLSearchParams({ limit: "50", status: "completed" });
if (cursor) params.set("cursor", cursor);
const response = await fetch(
`https://api.muvi.video/v1/jobs?${params}`,
{
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
}
);
const data = await response.json();
allJobs.push(...data.jobs);
cursor = data.hasMore ? data.nextCursor : null;
} while (cursor);
console.log(`Total completed jobs: ${allJobs.length}`);
Example Response
{
"jobs": [
{
"jobId": "job_abc123def456",
"status": "completed",
"progress": 100,
"model": "google/veo-3.1-fast/text-to-video",
"createdAt": "2026-02-18T15:00:00Z",
"completedAt": "2026-02-18T15:02:30Z"
},
{
"jobId": "job_xyz789ghi012",
"status": "completed",
"progress": 100,
"model": "stability/stable-diffusion-xl/text-to-image",
"createdAt": "2026-02-18T14:30:00Z",
"completedAt": "2026-02-18T14:30:15Z"
}
],
"nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTE4VDE0OjMwOjAwWiJ9",
"hasMore": true
}