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

# List parsing jobs

`GET /v1/parsing/jobs`

List parsing jobs with pagination.

Args:
    limit: The number of items to return.
    offset: The number of items to skip.

Returns:
    List of parsing jobs with pagination.

## Query parameters

- `limit` integer — Maximum number of items to return per page (1-100)
- `after` string, nullable — Cursor for forward pagination - get items after this position. Use last_cursor from previous response.
- `before` string, nullable — Cursor for backward pagination - get items before this position. Use first_cursor from previous response.
- `include_total` boolean — Whether to include total count in response (expensive operation)
- `statuses` ParsingJobStatus[], nullable — Status to filter by
- `q` string, nullable — Search query to filter by

## Response `200`

List of parsing jobs with pagination

- ParsingJobListResponse — A list of parsing jobs with pagination.
  - `pagination` CursorPaginationResponse, required — Response model for cursor-based pagination.
    - `has_more` boolean, required — Contextual direction-aware flag: True if more items exist in the requested pagination direction. For 'after': more items after this page. For 'before': more items before this page.
    - `first_cursor` string, nullable, required — Cursor of the first item in this page. Use for backward pagination. None if page is empty.
    - `last_cursor` string, nullable, required — Cursor of the last item in this page. Use for forward pagination. None if page is empty.
    - `total` integer, nullable — Total number of items available across all pages. Only included when include_total=true was requested. Expensive operation - use sparingly.
  - `data` ParsingJobListItem[], required — The list of parsing jobs
    - `id` string, required — The ID of the job
    - `file_id` string, required — The ID of the file to parse
    - `filename` string, nullable — The name of the file
    - `status` 'pending' | 'in_progress' | 'cancelled' | 'completed' | 'failed', required
    - `error` object, nullable — The error of the job
    - `started_at` string, date-time, nullable — The started time of the job
    - `finished_at` string, date-time, nullable — The finished time of the job
    - `created_at` string, date-time — The creation time of the job
    - `updated_at` string, date-time, nullable — The updated time of the job
    - `object` 'parsing_job' — The type of the object
  - `object` 'list' — The object type of the response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.net/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixedbread/mxbai-omni/revisions/2eece97b5ae5/schema)