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".
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"job_id": "<job_id>"
},
"name": "replicate_batch_status"
}
}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. |