Docs · GET /jobs
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
statusstringOnly jobs in these states, separated by commas: pending, processing, completed, failed, cancelled.
limitnumberHow many to return: 1 to 100. 20 when left out.
offsetnumberHow many to skip. 0 when left out.
sortstringcreated_at_desc (the default) or created_at_asc.

Request body

This request has no body.

Example

Request
curl "https://media.logicboostkit.com/jobs?status=completed,failed&limit=2" \
  -H "Authorization: Basic $MEDIA_KEY"
Response
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
okbooleantrue.
jobs[]arrayOne entry per job. Empty when there are none.
jobs[].idstringThe job’s id.
jobs[].statusstringpending, processing, completed, failed or cancelled.
jobs[].webhook_urlstring | nullThe job’s webhook URL while delivery is still due; null once it is delivered or given up, or when there was none.
jobs[].created_atstringWhen the job was submitted, in UTC.
jobs[].updated_atstringWhen its state last changed.
jobs[].completed_atstring | nullWhen it ended; null while it is pending or processing.
jobs[].input_countnumberHow many inputs its task had.
jobs[].output_countnumberHow many outputs its task named.
jobs[].has_errorbooleantrue when the job failed.
paginationobjecttotal, limit, offset and has_more.

Status codes

Status codes
200The list. Not charged.
400status names a state that doesn’t exist, limit or offset is out of range, or sort is neither of its two values.
401The Authorization header is missing, or the key is invalid, revoked or expired.
403The account isn’t active. The error says what to do.
429More 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.