---
title: "List the authenticated user's batch generations."
method: GET
path: "/api/v1/skybox/batch"
tags: ["Skybox Batch Generation"]
---

# List the authenticated user's batch generations.

`GET /api/v1/skybox/batch`

## Request

- Base URL: `https://backend.blockadelabs.com`
- URL: `https://backend.blockadelabs.com/api/v1/skybox/batch`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/blockadelabs/apis/blockade-labs-api-documentation/docs/api/v1/skybox/batch/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `status` string: Filter by batch status: pending, dispatched, processing, finalized, or error.
- `batch_id` integer: Filter by batch ID.
- `limit` integer: Results per page, up to 100.
- `offset` integer: Page offset.

## Headers

- `x-api-key` string

## Response `200`

- object
  - `data` object[]
    - `id` integer
    - `status` string
    - `quantity` integer
    - `successfully_submitted` integer
    - `completed` integer
    - `errored` integer
  - `totalCount` integer
  - `has_more` boolean

---

[API](https://skmtc.dev/blockadelabs/apis/blockade-labs-api-documentation.md) - [All operations](https://skmtc.dev/blockadelabs/apis/blockade-labs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/blockadelabs/apis/blockade-labs-api-documentation/revisions/7560ac18c09c?raw)