Show a v3 job's progress and estimated completion time

curl https://api.hedra.com/v3/jobs/$JOB_ID/status -H "Authorization: Key $HEDRA_KEY"

{
  "job_id": "job_5e873d0f-...",
  "status": "IN_PROGRESS",
  "progress": 0.42,
  "estimated_completion_at": "2026-09-24T23:55:04.121Z"
}

import time
from datetime import datetime, timezone

import httpx


def parse_instant(value: str) -> datetime:
    return datetime.fromisoformat(value.replace("Z", "+00:00"))


def wait_with_progress(job_id: str, key: str) -> dict:
    headers = {"Authorization": f"Key {key}"}
    first_estimate = None
    while True:
        response = httpx.get(
            f"https://api.hedra.com/v3/jobs/{job_id}/status", headers=headers
        )
        response.raise_for_status()
        status = response.json()
        if status["status"] in ("COMPLETED", "FAILED"):
            return status
        eta = status["estimated_completion_at"]
        now = datetime.now(timezone.utc)
        if eta is None:
            print("Working…")
        else:
            finish = parse_instant(eta)
            first_estimate = first_estimate or finish
            if now > first_estimate:
                print("Taking longer than expected…")
            else:
                remaining = max(0, round((finish - now).total_seconds()))
                print(f"About {remaining} s left")
        time.sleep(5)