Get Task

GET /tasks/{id}

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

Example

curl "https://api.ittybit.com/tasks/task_abc123" \
  -H "Authorization: Bearer $ITTYBIT_API_KEY"

const res = await fetch("https://api.ittybit.com/tasks/task_abc123", {
  headers: {
    "Authorization": `Bearer ${process.env.ITTYBIT_API_KEY}`,
  },
});
const task = await res.json();

import requests

res = requests.get(
    "https://api.ittybit.com/tasks/task_abc123",
    headers={"Authorization": f"Bearer {api_key}"},
)
task = res.json()

Response 200

{
  "id": "task_abc123",
  "object": "task",
  "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,
  "steps": [
    {
      "id": "step_001",
      "object": "step",
      "kind": "probe",
      "input": {"object": "external_file", "url": "https://example.com/video.mp4"},
      "options": {},
      "output": {"object": "source", "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 Task — start a new processing task
• List Tasks — list and filter tasks
• Create Step — run individual operations without a parent task