COcontextualai
/parse

Parse List Jobs

Changed on

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.

get/parse/jobs

Request

  • Base URL
    https://api.contextual.ai/v1
  • URL
    https://api.contextual.ai/v1/parse/jobs
  • Auth
    HTTP bearer

Query parameters

limitinteger

Maximum number of parse jobs to return

cursorstring

Cursor from the previous call to list parse jobs, used to retrieve the next set of results

uploaded_afterstring 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

total_jobsinteger required

Total number of parse jobs

next_cursorstring

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

Example response

{
  "total_jobs": 10
}

Changes

  • db7245c74772Revision changes
    • info

      added the new optional query request parameter cursor

    • info

      added the new optional query request parameter limit

    • info

      added the optional property to the response with the status

  • 17bdb8a33fb4Revision changes
    • info

      endpoint added