List Parse Jobs
List Parse Jobs
Retrieve a list of all parse jobs that have been submitted. This endpoint allows you to see the status and metadata of each parse job.
The endpoint is paginated. A page has the following fields:
items
: An array of parse jobs, each containing the fields described below.has_more
: A boolean indicating whether there are more parse jobs available beyond the current page.next_cursor
: A base64-encoded cursor for the next page of results. Ifhas_more
isfalse
, this field will benull
.prev_cursor
: A base64-encoded cursor for the previous page of results. If this is the first page, this field will benull
.
The response will include a page of parse jobs, each containing the following fields:
parse_id
: The unique identifier for the parse job.status
: The current status of the parse job (e.g.,pending
,processing
,successful
,failure
).created_at
: The RFC 3339 timestamp when the parse job was created.finished_at
: The RFC 3339 timestamp when the parse job was completed or failed.options
: The configuration options used for the parse job, including the file ID, file URL, raw text, mime type, and structured extraction options, etc.
Filters
You can filter the list of parse jobs by providing query parameters:
cursor
: A base64-encoded cursor for pagination. If not provided, the first page will be returned.direction
: The direction of pagination. Can benext
orprev
. Defaults tonext
.limit
: The maximum number of parse jobs to return per page. Defaults to 100, with a maximum of 1000.filename
: Filter by the original filename of the file used for parsing. This is useful to find parse jobs related to a specific file.status
: Filter by the status of the parse job. Can bepending
,processing
,successful
, orfailure
.id
: Filter by the unique identifier of the parse job. This is useful to retrieve a specific parse job, but is preferable to use the Get Parse Result endpoint for that purpose.created_after
: Filter by the creation date of the parse job. Only parse jobs created after this date will be returned. The date should be in RFC 3339 format.created_before
: Filter by the creation date of the parse job. Only parse jobs created before this date will be returned. The date should be in RFC 3339 format.finished_after
: Filter by the completion date of the parse job. Only parse jobs completed after this date will be returned. The date should be in RFC 3339 format.finished_before
: Filter by the completion date of the parse job. Only parse jobs completed before this date will be returned. The date should be in RFC 3339 format.
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Optional cursor for pagination.
This is a base64-encoded string representing a timestamp. It is used to paginate through the results.
The direction of pagination.
This can be either next
or prev
.
The default is next
, which means the next page of results will be
next
, prev
The name of the dataset to filter the results by.
This is an optional parameter because not every parse operation is associated with a dataset.
The maximum number of results to return per page.
The default is 100.
x >= 0
The filename to filter the results by.
This is an optional parameter that can be used to filter the results by the filename of the parsed document.
The status of the parse operation to filter the results by.
This is an optional parameter that can be used to filter the results by the status of the parse operation.
The possible values are pending
, processing
, failure
, and
successful
.
pending
, processing
, successful
, failure
The ID of the parse operation to filter the results by.
The date and time after which the parse operation was created.
The date should be in RFC3339 format.
The date and time before which the parse operation was created.
The date should be in RFC3339 format.
The date and time after which the parse operation was finished.
The date should be in RFC3339 format.
The date and time before which the parse operation was finished.
The date should be in RFC3339 format.
Response
List of parse jobs
The response is of type object
.