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

# Retrieve batch results

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

## Request

- Base URL: `https://api.trigger.dev`
- URL: `https://api.trigger.dev/api/v1/batches/{batchId}/results`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/docs/api/v1/batches/:batchId/results/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-02-24** `646fa10cb62e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/changes/api/v1/batches/:batchId/results/get.md)

---

[API](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api.md) - [All operations](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/revisions/441161111493?raw)