---
title: "Retrieve batch results"
method: GET
path: "/parser/jobs/{batchId}"
tags: ["Parsing API"]
---

# Retrieve batch results

`GET /parser/jobs/{batchId}`

## Request

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

Retrieve the current status, per-file extracted output preview, and download URL for a batch.

## Path parameters

- `batchId` string, uuid, required: Parser batch UUID

## Response `200`

Batch details returned.

- object
  - `batch` object, required
    - `id` string, uuid, required: Batch UUID
    - `status` string, required: Batch processing status
    - `outputFormat` string, required: Batch output format
    - `totalFiles` integer, required: Total files in the batch
    - `completedFiles` integer, required: Completed files in the batch
    - `creditCost` integer, nullable, required: Total Parser credits charged for this Contracko Parser batch
    - `retentionExpiresAt` string, date-time, required: ISO-8601 timestamp when artifacts expire
    - `createdAt` string, date-time, required: ISO-8601 creation timestamp
    - `metadata` unknown
    - `downloadUrl` string, nullable, required: Signed URL to download the extracted output when the batch is completed
  - `items` object[], required: Per-file parser item status and previews
    - `id` string, uuid, required: Parser item UUID
    - `fileName` string, required: Original file name
    - `mimeType` string, required: MIME type
    - `fileSize` integer, nullable, required: File size in bytes
    - `creditCost` integer, nullable, required: Parser credits charged for this Contracko Parser file
    - `status` string, required: Item processing status
    - `error` string, nullable, required: Error message when item processing fails
    - `outputPreview` unknown
    - `uploadRetentionExpiresAt` string, date-time, nullable: ISO-8601 timestamp when uploaded source retention expires

## 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.
- `404`: The requested parser batch was not found.
- `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)