/v1/batch/status/{job_id}

Available at https://api.theproductllm.com/v1/batch/status/{job_id}

Retrieves the current status of a batch inference job.

Returns detailed information about job progress, including total rows, processed rows, progress percentage, and any errors that occurred.

Path Parameters

• job_id: The ID of the batch job to check (returned from batch submission endpoints)

Request

import requests


response = requests.get(
    "https://api.theproductllm.com/v1/batch/status/550e8400-e29b-41d4-a716-446655440000",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
print(response.json())

Response

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "active",
  "user_id": "user_2abc123def456",
  "total_rows": 100,
  "processed_rows": 45,
  "progress_percent": 45.0,
  "inference_type": "match",
  "original_filename": "product_pairs.jsonl",
  "error": null,
  "created_at": "2025-01-15T10:30:00Z"
}

Status Values

• queued: Job is waiting to be processed

• active: Job is currently being processed

• complete: Job has finished successfully

• failed: Job encountered an error and stopped