Reference · Jobs

# GET/jobs

Lists your account’s async jobs, newest first. A job stays in the list until its directory is deleted.

## Parameters

Parameters

- `status` (string): Only jobs in these states, separated by commas: pending, processing, completed, failed, cancelled.
- `limit` (number): How many to return: 1 to 100. 20 when left out.
- `offset` (number): How many to skip. 0 when left out.
- `sort` (string): created_at_desc (the default) or created_at_asc.

## Request body

This request has no body.

## Example

Request

```bash
curl "https://media.logicboostkit.com/jobs?status=completed,failed&limit=2" \
  -H "Authorization: Basic $MEDIA_KEY"
```

Response

```http
HTTP/1.1 200 OK
X-Request-Id: job_0mv6iv6v5rmhf80bjaztl3yl

{
  "ok": true,
  "jobs": [
    {
      "id": "job_0mv6ihz6vfx5ua0h05x8bmql",
      "status": "completed",
      "webhook_url": null,
      "created_at": "2026-10-13T10:02:11.431Z",
      "updated_at": "2026-10-13T10:03:02.118Z",
      "completed_at": "2026-10-13T10:03:02.118Z",
      "input_count": 1,
      "output_count": 1,
      "has_error": false
    },
    {
      "id": "job_0mv6hcx5429ir9i0kjnput8u",
      "status": "failed",
      "webhook_url": null,
      "created_at": "2026-10-13T09:30:15.880Z",
      "updated_at": "2026-10-13T09:30:19.402Z",
      "completed_at": "2026-10-13T09:30:19.402Z",
      "input_count": 2,
      "output_count": 1,
      "has_error": true
    }
  ],
  "pagination": {
    "total": 14,
    "limit": 2,
    "offset": 0,
    "has_more": true
  }
}
```

## Response fields

Response fields

- `ok` (boolean): true.
- `jobs[]` (array): One entry per job. Empty when there are none.
- `jobs[].id` (string): The job’s id.
- `jobs[].status` (string): pending, processing, completed, failed or cancelled.
- `jobs[].webhook_url` (string | null): The job’s webhook URL while delivery is still due; null once it is delivered or given up, or when there was none.
- `jobs[].created_at` (string): When the job was submitted, in UTC.
- `jobs[].updated_at` (string): When its state last changed.
- `jobs[].completed_at` (string | null): When it ended; null while it is pending or processing.
- `jobs[].input_count` (number): How many inputs its task had.
- `jobs[].output_count` (number): How many outputs its task named.
- `jobs[].has_error` (boolean): true when the job failed.
- `pagination` (object): total, limit, offset and has_more.

## Status codes

Status codes

- **200**: The list. Not charged.
- **400**: status names a state that doesn’t exist, limit or offset is out of range, or sort is neither of its two values.
- **401**: The `Authorization` header is missing, or the key is invalid, revoked or expired.
- **403**: The account isn’t active. The error says what to do.
- **429**: More than 300 requests in a minute on this key. Wait for the number of seconds in `Retry-After`.

Every error has the shape `{"ok": false, "error": "…"}` and is never charged.