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

# Get a batch by id

`GET /api/batches/{batchId}`

## Request

- Base URL: `https://api.imagelato.com`
- URL: `https://api.imagelato.com/api/batches/{batchId}`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

Fetches a single processed image batch by id, scoped to your organization. Requires the `batches:read` scope. Returns 404 when the batch belongs to another organization, so ids cannot be probed.

## Path parameters

- `batchId` string, required

## Response `200`

The batch

## Other responses

- `401`: Missing or invalid credentials
- `403`: API key is missing the `batches:read` scope
- `404`: Not found (or not owned by your organization)
- `429`: API key rate limit exceeded

---

[API](https://skmtc.dev/imagelato/apis/imagelato-api.md) · [All operations](https://skmtc.dev/imagelato/apis/imagelato-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imagelato/apis/imagelato-api/revisions/3e3c7553a1bb?raw)