---
title: "List jobs"
method: GET
path: "/v1/jobs"
tags: ["Status and Authentication"]
---

# List jobs

`GET /v1/jobs`

## Request

- Base URL: `https://getsocialclaw.com`
- URL: `https://getsocialclaw.com/v1/jobs`
- Auth: HTTP bearer

Lists worker jobs for the workspace.

## Query parameters

- `status` string
- `provider` string
- `account` string
- `runId` string
- `limit` integer

## Response `200`

Successful response.

- JobsResponse: Job list response.
  - `ok` unknown, required
  - `jobs` object[]: Jobs.
  - `total` integer: Total matching jobs.

## Other responses

- `400`: Invalid request.
- `401`: Missing, invalid, or unauthorized credentials.
- `404`: Requested resource was not found.
- `422`: Request body or semantic validation failed.

---

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