List Parsing Jobs

GET/v1/parsing/jobs

Authorization

Authorizationstringrequired

Bearer token for API authentication. Format: `Bearer YOUR_API_KEY`

Query Parameters

limitintegerdefault: 20

Maximum number of items to return per page (1-100)

Constraints

•Minimum: 1•Maximum: 100

afterstring

Cursor for forward pagination - get items after this position. Use last_cursor from previous response.

beforestring

Cursor for backward pagination - get items before this position. Use first_cursor from previous response.

include_totalbooleandefault: false

Whether to include total count in response (expensive operation)

statusesstring

Status to filter by

qstring

Search query to filter by

Response Body

objectstringdefault: list

The object type of the response

Request

GET/v1/parsing/jobs

from mixedbread import Mixedbread

mxbai = Mixedbread(api_key="YOUR_API_KEY")

response = mxbai.parsing.jobs.list(limit=20, statuses=["completed", "in_progress"])

for job in response.data:
    print(job.id, job.status)

Response

JSON

{
  "object": "list",
  "data": [
    {
      "id": "job_xyz789",
      "file_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "filename": "document.pdf",
      "status": "completed",
      "started_at": "2025-01-15T17:00:30.000Z",
      "finished_at": "2025-01-15T17:01:00.000Z",
      "created_at": "2025-01-15T17:00:00.000Z",
      "updated_at": "2025-01-15T17:01:00.000Z",
      "object": "parsing_job"
    },
    {
      "id": "job_def456",
      "file_id": "file_ghi789",
      "filename": "report.docx",
      "status": "in_progress",
      "started_at": "2025-01-15T17:05:00.000Z",
      "finished_at": null,
      "created_at": "2025-01-15T17:04:30.000Z",
      "updated_at": "2025-01-15T17:05:00.000Z",
      "object": "parsing_job"
    }
  ],
  "pagination": {
    "has_more": false,
    "first_cursor": "eyJpZCI6ImpvYl94eXo3ODkifQ==",
    "last_cursor": "eyJpZCI6ImpvYl9kZWY0NTYifQ=="
  }
}