List Jobs

View Markdown 
GET /jobs

Returns a paginated list of jobs. Use filters to find jobs by kind, status, or input URL. For the CLI equivalent, see ittybit jobs list.

Parameters

ParamTypeDescription
kindstringFilter: video · audio · image · animation · adaptive_video
statusstringFilter: queued · processing · succeeded · failed · cancelled
inputstringFilter by input URL (exact match)
limitinteger1–100 (default 20)
afterstringCursor — items after this ID
beforestringCursor — items before this ID
orderstringasc · desc (default desc)

Examples

List recent video jobs:

ittybit jobs \
  --kind video \
  --limit 10
const res = await fetch('https://api.ittybit.com/jobs?kind=video&limit=10', {
  headers: {
    Authorization: `Bearer ${process.env.ITTYBIT_API_KEY}`,
  },
});
const data = await res.json();
import requests

res = requests.get(
    "https://api.ittybit.com/jobs?kind=video&limit=10",
    headers={"Authorization": f"Bearer {api_key}"},
)
data = res.json()
curl "https://api.ittybit.com/jobs?kind=video&limit=10" \
  -H "Authorization: Bearer $ITTYBIT_API_KEY"

List failed jobs:

ittybit jobs \
  --status failed \
  --limit 20
const res = await fetch('https://api.ittybit.com/jobs?status=failed&limit=20', {
  headers: {
    Authorization: `Bearer ${process.env.ITTYBIT_API_KEY}`,
  },
});
const data = await res.json();
import requests

res = requests.get(
    "https://api.ittybit.com/jobs?status=failed&limit=20",
    headers={"Authorization": f"Bearer {api_key}"},
)
data = res.json()
curl "https://api.ittybit.com/jobs?status=failed&limit=20" \
  -H "Authorization: Bearer $ITTYBIT_API_KEY"

Response 200

[
  {
    "id": "job_abc123",
    "object": "job",
    "kind": "video",
    "input": "https://example.com/video.mp4",
    "output": "https://store.ittybit.net/org_123/video.mp4",
    "options": { "format": "mp4", "quality": "high" },
    "metadata": {},
    "status": "succeeded",
    "error": null,
    "created_at": 1711900000000,
    "started_at": 1711900001000,
    "finished_at": 1711900045000,
    "updated_at": 1711900045000
  }
]

See also

  • Create Job — start a new processing job
  • Get Job — get full details and task results for a single job
  • CLI jobs list — list jobs from the command line