---
title: "Parse List Jobs"
method: GET
path: "/parse/jobs"
tags: ["/parse"]
---

# Parse List Jobs

`GET /parse/jobs`

Get list of parse jobs, sorted from most recent to oldest.

Returns all jobs from the last 30 days, or since the optional `uploaded_after` timestamp.

## Query parameters

- `limit` integer — Maximum number of parse jobs to return
- `cursor` string — Cursor from the previous call to list parse jobs, used to retrieve the next set of results
- `uploaded_after` string, date-time — Filters to only documents uploaded to `/parse` at or after specified UTC timestamp. If not provided, or if the provided timestamp is before the maximum parse job retention period (30 days), the maximum retention period will be used instead.

## Response `200`

Successful Response

- ParseListJobsResponseV1 — /parse list jobs object.
  - `total_jobs` integer, required — Total number of parse jobs
  - `next_cursor` string — Next cursor to continue pagination. Omitted if there are no more parse jobs after these ones.
  - `jobs` ParseListJobsItem[], required — List of parse jobs
    - `id` string, uuid, required — Unique ID of the parse job
    - `status` 'pending' | 'processing' | 'retrying' | 'completed' | 'failed' | 'cancelled', required
    - `file_name` string, required — The name of the file that was uploaded for parsing

## Other responses

- `422` — Validation Error

## Changes

- **2025-08-26** `db7245c74772` — 3 info
  - added the new optional `query` request parameter `cursor`
  - added the new optional `query` request parameter `limit`
  - added the optional property `next_cursor` to the response with the `200` status
- **2025-05-08** `17bdb8a33fb4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/contextualai/apis/endpoints/changes/parse/jobs/get.md)

---

[API](https://skmtc.dev/contextualai/apis/endpoints.md) · [All operations](https://skmtc.dev/contextualai/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/contextualai/endpoints/revisions/ca7f807eec8b/schema)