Get Batch Job Status
replicate_batch_statusCheck the status of an async batch prediction job. Get overall status (running, completed, partial) and optional per-item results to monitor progress.
Instructions
Poll the status of an async batch job started with replicate_batch_start.
Args:
job_id (string): Job ID returned by replicate_batch_start.
include_results (boolean, default true): Include full PredictionResult per item. Set false for a counts-only summary while the job is still running.
Returns structuredContent: { job_id, overall_status, total, succeeded, failed, running, pending, created_at, expires_at, items: [{ index, model, status, prediction_id, result?, error?, started_at, completed_at }] }
overall_status: "running" — predictions still in progress "completed" — all items succeeded "partial" — all done, at least one failed
Tip: Poll every 10–30 seconds until overall_status is "completed" or "partial".
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | Job ID returned by replicate_batch_start. | |
| include_results | No | Include full PredictionResult per completed item. Set false to get counts-only summary for large batches. Default: true. |