---
title: "Get job"
method: GET
path: "/jobs/{job_id}"
tags: ["Jobs"]
---

# Get job

`GET /jobs/{job_id}`

## Request

- Base URL: `https://api.pdfparse.net/v1`
- URL: `https://api.pdfparse.net/v1/jobs/{job_id}`
- Auth: HTTP bearer

Return a job with the documents linked to it through their processing runs and any provider batches.

## Path parameters

- `job_id` string, required

## Response `200`

Success

- object
  - `id` number, required
  - `status` string, required
  - `workflow_type` string, nullable
  - `table_id` string, required
  - `projects_id` number, required
  - `processing_mode` 'instant' | 'batch': Extraction path chosen for this job. Jobs at or below the project's instant-mode threshold run instantly; larger jobs use the provider batch API.
  - `document_count` integer
  - `created_at` string, nullable, required
  - `updated_at` string, nullable, required
  - `documents` object[]
    - `id` number, required: Numeric document ID.
    - `file_id` string, nullable, required
    - `status` string, required
    - `run_status` string, nullable
  - `batches` object[]

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Workflow error

---

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