---
title: "List parsing batches"
method: GET
path: "/parser/jobs"
tags: ["Parsing API"]
---

# List parsing batches

`GET /parser/jobs`

## Request

- Base URL: `https://contracko.com/api/v1`
- URL: `https://contracko.com/api/v1/parser/jobs`
- Auth: one of:
  - API key in header `x-contracko-api-key`
  - HTTP bearer

List parser batches in reverse chronological order.

- Query example: `/parser/jobs?limit=10&offset=0`

## Query parameters

- `limit` integer: Page size (max 50)
- `offset` integer: Pagination offset

## Response `200`

Parser batches returned.

- object
  - `items` object[], required: Parser batches in the requested page
    - `id` string, uuid, required: Batch UUID
    - `status` string, required: Batch status
    - `outputFormat` string, required: Requested output format
    - `creditCost` integer, nullable, required: Parser credits billed to this Contracko Parser batch, when available
    - `totalFiles` integer, required: Total files in the batch
    - `completedFiles` integer, required: Files completed so far
    - `retentionExpiresAt` string, date-time, required: ISO-8601 artifact retention expiration timestamp
    - `createdAt` string, date-time, required: ISO-8601 creation timestamp
    - `metadata` unknown
  - `limit` integer, required: Page size used in this response
  - `offset` integer, required: Offset used in this response
  - `hasMore` boolean, required: Whether additional pages are available
  - `total` integer, required: Total parser batches available for the organisation
  - `page` integer, required: Current 1-based page index
  - `pageCount` integer, required: Total number of pages
  - `start` integer, required: 1-based inclusive index of first row in this page
  - `end` integer, required: 1-based inclusive index of last row in this page

## Other responses

- `400`: Request validation failed (payload, query, or path format is invalid).
- `401`: Authentication failed (missing, invalid, revoked, or expired API key).
- `403`: Access denied because this API key does not include parsing access or the Parsing API is not available for this workspace.
- `429`: Retry later because the request rate limit was reached or too many parser batches are already running for this workspace.
- `500`: The server could not complete the request.

---

[API](https://skmtc.dev/contracko/apis/contracko-parsing-api.md) · [All operations](https://skmtc.dev/contracko/apis/contracko-parsing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/contracko/apis/contracko-parsing-api/revisions/2f90b1d3cafd?raw)