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_a34c321b-ed4b-4e91-ae29-7f02939d8962

Header parameters

AuthorizationstringRequiredExample: sk-mx9BKfEmsSr

Responses

200Success

application/json

batch_idstringRequired

completed_countintegerRequired

completion_tokensintegerRequired

errorstringRequired

fail_reasonstringRequired

failed_countintegerRequired

feesstringRequired

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_a34c321b-ed4b-4e91-ae29-7f02939d8962",
  "completed_count": 3,
  "completion_tokens": 1644,
  "error": "",
  "fail_reason": "",
  "failed_count": 0,
  "fees": "0.000497000",
  "finish_time": 1765972493,
  "model": "gpt-4o-mini-batch",
  "progress": "100%",
  "prompt_tokens": 54,
  "result_url": "https://resource.onerouter.pro/batch-llm/azure-batch%2Fbatch_a34c321b-ed4b-4e91-ae29-7f02939d8962_6ab0397c.jsonl",
  "start_time": 0,
  "status": "SUCCESS",
  "submit_time": 1765972352,
  "task_id": 2,
  "total_requests": 3,
  "total_tokens": 1698
}