Get Job

GET /jobs/{id}

Returns a job with all its tasks. Use this to check progress, inspect probe results, or get the output URL after processing completes.

Example

ittybit jobs job_abc123

const res = await fetch('https://api.ittybit.com/jobs/job_abc123', {
  headers: {
    Authorization: `Bearer ${process.env.ITTYBIT_API_KEY}`,
  },
});
const data = await res.json();

import requests

res = requests.get(
    "https://api.ittybit.com/jobs/job_abc123",
    headers={"Authorization": f"Bearer {api_key}"},
)
data = res.json()

curl "https://api.ittybit.com/jobs/job_abc123" \
  -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,
  "tasks": [
    {
      "id": "task_001",
      "object": "task",
      "kind": "probe",
      "input": { "object": "external_file", "url": "https://example.com/video.mp4" },
      "options": {},
      "output": {
        "object": "file",
        "kind": "video",
        "url": "...",
        "format": "mp4",
        "width": 1920,
        "height": 1080,
        "duration": 62.5
      },
      "status": "succeeded",
      "progress": null,
      "error": null,
      "created_at": 1711900000000,
      "started_at": 1711900001000,
      "finished_at": 1711900005000,
      "updated_at": 1711900005000
    }
  ],
  "created_at": 1711900000000,
  "started_at": 1711900001000,
  "finished_at": 1711900045000,
  "updated_at": 1711900045000
}

Statuses

Errors

See also

• Create Job — start a new processing job
• List Jobs — list and filter jobs
• Create Task — run individual operations without a parent job