---
title: "Get OCR job status"
method: GET
path: "/ocr/v1/{id}"
tags: ["OCR"]
---

# Get OCR job status

`GET /ocr/v1/{id}`

Retrieve the status and results of an OCR job. Returns job progress, extracted text, and metadata when processing is complete.

## Path parameters

- `id` string, required

## Query parameters

- `include_text` 'true' | 'false'

## Response `200`

OCR job status and results

- object
  - `id` string, required — OCR job ID
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required — Current job status
  - `page_count` integer — Number of pages processed
  - `text` string — Extracted text content (when completed)
  - `metadata` object — Additional processing metadata
  - `created_at` string, date-time, required — Job creation timestamp
  - `completed_at` string, date-time — Job completion timestamp

## Other responses

- `400` — Bad request - Invalid OCR ID format
- `401` — Unauthorized - Invalid or missing API key
- `404` — OCR job not found

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/revisions/5b7e64e6d6f9/schema)