---
title: "List your jobs"
method: GET
path: "/v1/jobs"
tags: ["jobs"]
---

# List your jobs

`GET /v1/jobs`

## Request

- Base URL: `https://api.slideforge.dev`
- URL: `https://api.slideforge.dev/v1/jobs`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

List your recent generation jobs with optional status filter. Paginated via `limit` and `offset` parameters. Returns newest first.

## Query parameters

- `status` string, nullable: Filter by status: queued, generating, executing, rendering, complete, failed
- `limit` integer: Max jobs to return (default 10)
- `offset` integer: Number of jobs to skip
- `detail` string: 'compact' (default: id, name, status, type, cost, date) or 'full' (adds brief, signed URLs, score)
- `include_children` boolean: Include deck child slides (each carries parent_deck_id). Default false shows parents only.

## Response `200`

Paginated list of jobs

- unknown

## Other responses

- `401`: Authentication required
- `422`: Validation Error

---

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