GET /jobs/{job_id}

Get the current status and metadata of a job.

Request

curl -H "X-API-Key: chu_live_xxxxxxxx" \
  https://your-domain.com/api/v1/jobs/job-abc123

Response

{
  "job_id": "job-abc123",
  "status": "done",
  "ocr_model": "premium",
  "ocr_engine": "easyocr",
  "file_type": "pdf",
  "filename": "document.pdf",
  "total_pages": 10,
  "done_pages": 10,
  "total_files": 1,
  "done_files": 1,
  "media_duration_seconds": 0,
  "cost_points": 50,
  "error_log": null,
  "created_at": "2026-07-15T12:00:00",
  "finished_at": "2026-07-15T12:01:30",
  "downloadable": true,
  "xlsx_basic_converted": false,
  "xlsx_advanced_converted": false,
  "xlsx_advanced_status": null,
  "xlsx_advanced_job_id": null,
  "xlsx_advanced_refundable": false,
  "xlsx_advanced_recovery_notes": null,
  "refundable": false,
  "retry_count": 0
}

Fields

Field	Type	Description
status	string	pending, queued, processing, done, error, cancelled
ocr_model	string	basic or premium
ocr_engine	string	tesseract, easyocr, or rapidocr
done_pages	int	Pages processed so far (for progress tracking)
cost_points	int	Credits actually deducted (milli-USD)
downloadable	bool	true when status is done
xlsx_basic_converted	bool	Whether XLSX Basic has been generated
xlsx_advanced_converted	bool	Whether XLSX Advanced has been generated
xlsx_advanced_status	string|null	Status of XLSX Advanced conversion if in progress
xlsx_advanced_job_id	string|null	Job ID for XLSX Advanced conversion tracking
xlsx_advanced_refundable	bool	Whether XLSX Advanced conversion is eligible for refund
xlsx_advanced_recovery_notes	string|null	Notes for XLSX Advanced recovery
refundable	bool	Whether the job is eligible for refund (parse failure)
retry_count	int	Number of retries attempted
error_log	string|null	Error details if status is error