Skip to main content

GET /list_jobs

Lists all video analysis jobs for a given API key.

Endpoint​

GET https://api-eu.valossa.com/core/1.0/list_jobs

Query Parameters​

ParameterTypeRequiredDescription
api_keystringYesYour Valossa API key
show_statusbooleanNoSet to true to include job_status details in each listed job
show_media_infobooleanNoSet to true to include media details (for example title) in each listed job
n_jobsintegerNoNumber of jobs to return. Default: 200, maximum: 10000

Response​

A successful response returns HTTP 200 with a JSON object containing a jobs array.

Examples​

curl​

curl "https://api-eu.valossa.com/core/1.0/list_jobs?api_key=YOUR_API_KEY&show_status=true&show_media_info=true&n_jobs=500"

Python​

import requests

response = requests.get(
    "https://api-eu.valossa.com/core/1.0/list_jobs",
    params={"api_key": "YOUR_API_KEY"}
)

jobs = response.json().get("jobs", [])
for job in jobs:
    status = job.get("job_status", {}).get("status", "unknown")
    print(f"Job: {job['job_id']} - Status: {status}")

JavaScript​

const response = await fetch(
  "https://api-eu.valossa.com/core/1.0/list_jobs?api_key=YOUR_API_KEY&show_status=true"
);
const jobs = (await response.json()).jobs ?? [];

jobs.forEach(job => {
  console.log(`Job: ${job.job_id} - Status: ${job.job_status?.status ?? "unknown"}`);
});

Notes​

  • Results are scoped to the API key provided. You will only see jobs submitted with that specific key.
  • If you have multiple API keys (multiple subscriptions), call this endpoint separately for each key to see all jobs across subscriptions.