---
title: "Retrieve batch results"
method: GET
path: "/api/v1/batches/{batchId}/results"
tags: ["batches"]
---

# Retrieve batch results

`GET /api/v1/batches/{batchId}/results`

Returns the execution results of all completed runs in a batch. Only finished runs (successful or failed) are included in the items array — runs that are still executing are omitted. Returns 404 if the batch doesn't exist.

## Response `200`

Successful request

- object
  - `id` string — The batch ID.
  - `items` object[] — Execution results for each run in the batch.
    - `ok` boolean, required — Whether this run completed successfully.
    - `id` string, required — The run ID.
    - `output` string — The serialized output as a string (present when ok is true). Use outputType to determine how to parse it — for "application/json" use JSON.parse().
    - `outputType` string — The content type of the serialized output, e.g. "application/json".
    - `error` object — Error details (present when ok is false).
    - `usage` object
      - `durationMs` number — Duration of the run in milliseconds.
    - `taskIdentifier` string — The task identifier.

## Other responses

- `401` — Unauthorized request
- `404` — Batch not found

---

[API](https://skmtc.net/winsenlabs/apis/trigger-dev-v3-rest-api.md) · [All operations](https://skmtc.net/winsenlabs/apis/trigger-dev-v3-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/winsenlabs/trigger-dev-v3-rest-api/revisions/5a645d85c8c4/schema)