---
title: "GET /v1/jobs/{job_id}"
method: GET
path: "/v1/jobs/{job_id}"
tags: ["Conversion"]
---

# GET /v1/jobs/{job_id}

`GET /v1/jobs/{job_id}`

## Request

- Base URL: `https://markovo.net`
- URL: `https://markovo.net/v1/jobs/{job_id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-markovo-job-token`

## Response `200`

Owned job

- object
  - `job` Job
    - `id` string, required
    - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'timed_out', required
    - `capability_id` string
    - `credit_scale` unknown, required
    - `credit_model_version` string, required
    - `rate_card_version` string, required
    - `estimated_credit_units` integer
    - `actual_credit_units` integer, nullable
    - `estimated_credits` number
    - `actual_credits` number, nullable
    - `deliverable` union
      - integer
      - boolean
    - `billing_metrics` object, nullable
    - `error` string, nullable
    - `error_code` string, nullable
    - `resolution` JobResolution, required
      - `state` 'none' | 'credit_release_in_progress' | 'contact_support' | 'resolved', required
      - `charged` boolean
      - `action` 'wait' | 'email_support'
      - `support_reference` string
    - `progress` object: Present only while a PDF/image OCR-chain job is running. Count of completed page receipts; retries reuse idempotency keys so pages_done is monotonic.
      - `pages_done` integer
      - `pages_total` integer

## Other responses

- `404`: Machine-readable safe error

---

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