---
title: "Get Batch Image"
method: GET
path: "/api/batch/image/{s3_key}"
tags: ["Batch Processing"]
---

# Get Batch Image

`GET /api/batch/image/{s3_key}`

Serve batch document images from S3 with authentication.
Accepts token via query parameter for img src compatibility.

Args:
    s3_key: S3 key for the image (path format: batches/{batch_id}/...)
    token: Optional auth token from query param
    s3_storage: S3 storage instance

Returns:
    Streaming response with image data

## Path parameters

- `s3_key` string, required

## Query parameters

- `token` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-26** `c5a6fbe2731c` — 1 warning, 3 info
  - deleted the `query` request parameter `token`
  - api operation id `get_batch_image_api_batch_image__s3_key__get` removed and replaced with `get_batch_image_api_batch_image__document_id__get`
  - the endpoint scheme security `HTTPBearer` was added to the API
  - added the new optional `query` request parameter `page`

[Change history](https://skmtc.dev/qomplement/apis/fastapi/changes/api/batch/image/:s3_key/get.md)

---

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