---
title: "List async jobs"
method: GET
path: "/jobs"
---

# List async jobs

`GET /jobs`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/jobs`
- Auth: HTTP bearer

## Query parameters

- `creator_id` string
- `status` 'queued' | 'running' | 'succeeded' | 'completed' | 'failed' | 'cancelled' | 'canceled'
- `job_type` string
- `limit` integer

## Response `200`

Jobs

- ApiJobsResponse
  - `data` ApiJob[]
    - `id` string
    - `job_type` 'post.generate' | 'post.edit' | 'image.generate' | 'carousel.generate' | 'carousel.pdf' | 'brand_kit.generate' | 'research.run' | 'knowledge.process' | 'analytics.sync'
    - `status` 'queued' | 'running' | 'succeeded' | 'completed' | 'failed' | 'cancelled' | 'canceled'
    - `creator_id` string
    - `input` unknown
    - `output` unknown
    - `error` unknown
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable

---

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