---
title: "Get batch status"
method: GET
path: "/detect/batch/{uuid}"
tags: ["deepfakeDetection"]
---

# Get batch status

`GET /detect/batch/{uuid}`

Retrieve the latest aggregate status for a batch. The response shape mirrors
the create response — `status`, `completed_count`, and `failed_count` update
as child detects progress. Use the `detect_uuids` array to fetch per-file
results via `GET /detect/{uuid}`.

## Path parameters

- `uuid` string, required

## Headers

- `Authorization` string, required

## Response `200`

Batch status

- DeepfakeDetectionGetDetectBatchResponse200
  - `success` boolean
  - `item` DetectBatch — Aggregate state for a batch detection job. Returned by `POST /detect/batch` and `GET /detect/batch/{uuid}`.
    - `uuid` string — Batch UUID.
    - `status` 'processing' | 'completed' | 'partially_failed' | 'failed' — Aggregate status across all child detects. - `processing` — at least one child detect is still running. - `completed` — every child detect completed successfully. - `partially_failed` — at least one succeeded and at least one failed. - `failed` — every child detect failed.
    - `total_files` integer — Number of files in the batch (1–50).
    - `completed_count` integer — Number of child detects that have completed successfully.
    - `failed_count` integer — Number of child detects that have failed.
    - `created_at` string, date-time
    - `detect_uuids` string[] — UUIDs of the child detects. Use `GET /detect/{uuid}` to retrieve per-file results.

## Other responses

- `404` — Batch not found (or not accessible by the authenticated team).

---

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