Skip to main content
GET
/
parse
/
jobs
Parse List Jobs
curl --request GET \
  --url https://api.contextual.ai/v1/parse/jobs \
  --header 'Authorization: Bearer <token>'
{
  "total_jobs": 123,
  "jobs": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "file_name": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
limit
integer
default:1000

Maximum number of parse jobs to return

Required range: 1 <= x <= 1000
​
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.

Example:

"2026-05-10T00:00:00"

Response

Successful Response

/parse list jobs object.

​
total_jobs
integer
required

Total number of parse jobs

Example:

10

​
jobs
ParseListJobsItem · object[]
required

List of parse jobs

​
next_cursor
string

Next cursor to continue pagination. Omitted if there are no more parse jobs after these ones.