Get Status of a Batch

Get batch status or results

get

Get batch status if in progress, or stream results if completed in JSONL format.

Path parameters

batch_idstringRequiredExample: batch_8c9c435a-835d-4fc9-b91f-1c655748a63b

Header parameters

AuthorizationstringRequiredExample: sk-Yf4DN

Responses

200Success

application/json

batch_idstringRequired

batch_statusstringRequired

completed_countintegerRequired

completion_tokensintegerRequired

coststringRequired

errorstringRequired

fail_reasonstringRequired

failed_countintegerRequired

finish_timeintegerRequired

modelstringRequired

progressstringRequired

prompt_tokensintegerRequired

result_urlstringRequired

start_timeintegerRequired

statusstringRequired

submit_timeintegerRequired

task_idintegerRequired

total_requestsintegerRequired

total_tokensintegerRequired

get

/v1/batches/{batch_id}

HTTPcURLJavaScriptPython

GET /v1/batches/{batch_id} HTTP/1.1
Host: llm.onerouter.pro
Authorization: text
Accept: */*

200Success

{
  "batch_id": "batch_8c9c435a-835d-4fc9-b91f-1c655748a63b",
  "batch_status": "validating",
  "completed_count": 0,
  "completion_tokens": 0,
  "cost": "0.000000000",
  "error": "",
  "fail_reason": "",
  "failed_count": 0,
  "finish_time": 0,
  "model": "openai/gpt-4o-mini-batch",
  "progress": "10%",
  "prompt_tokens": 0,
  "result_url": "",
  "start_time": 0,
  "status": "SUBMITTED",
  "submit_time": 1773733067,
  "task_id": 6554,
  "total_requests": 3,
  "total_tokens": 0
}