---
title: "Get a batch job"
method: GET
path: "/batches/{id}"
tags: ["Batches"]
---

# Get a batch job

`GET /batches/{id}`

Get details of a batch job by ID

## Path parameters

- `id` string, required — The ID of the batch job to retrieve

## Response `200`

OK

- BatchJob
  - `id` string, uuid
  - `user_id` string
  - `input_file_id` string
  - `file_size_bytes` integer — Size of input file in bytes
  - `status` 'VALIDATING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'EXPIRED' | 'CANCELLED' — Current status of the batch job
  - `job_deadline` string, date-time
  - `created_at` string, date-time
  - `endpoint` string
  - `progress` number — Completion progress (0.0 to 100)
  - `model_id` string — Model used for processing requests
  - `output_file_id` string
  - `error_file_id` string
  - `error` string
  - `completed_at` string, date-time

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-07-26** `0c4fdad77435` — 2 breaking
  - the `file_size_bytes` response's property type/format changed from `integer`/`int64` to `integer`/`` for status `200`
  - the `progress` response's property type/format changed from `number`/`float64` to `number`/`` for status `200`

[Change history](https://skmtc.dev/together/apis/together-apis/changes/batches/:id/get.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) · [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/together/together-apis/revisions/d8f688ad4165/schema)