---
title: "Read the quote and saved conversion state."
method: GET
path: "/api/bases/{base_id}/conversions/{conversion_id}"
---

# Read the quote and saved conversion state.

`GET /api/bases/{base_id}/conversions/{conversion_id}`

## Request

- Base URL: `https://okfindex.com`
- URL: `https://okfindex.com/api/bases/{base_id}/conversions/{conversion_id}`
- Auth: none declared

Optional account document conversion. Check conversion_limits in get_base before upload. Raw HTTP accepts application/pdf, application/msword or application/vnd.openxmlformats-officedocument.wordprocessingml.document with URL-encoded X-Document-Name, up to 8 MiB. PDF permits 200 physical pages. DOC and DOCX contain continuous text, with pages=0 and no visual review; their quote charges once per file. The product publishes its rates in /api/pricing. JSON: filename and canonical file_base64; prefer raw HTTP for large files. The MCP transport permits 256 KiB per request. Upload only obtains a quote. Authorize with the exact quote and explicit user authority to spend credit. A repeated authorization reuses the account's right for this source hash. Processing continues without an open browser. Publication remains a separate action.
Returns: { conversion{id,base_id,filename,format,bytes,quote,status,document_id,error,progress,created_at,updated_at,expires_at,processing?} }

## Path parameters

- `base_id` string, required
- `conversion_id` string, required

## Response `200`

{ conversion{id,base_id,filename,format,bytes,quote,status,document_id,error,progress,created_at,updated_at,expires_at,processing?} }

- object
  - `conversion` BaseConversion, required
    - `id` string, required: The 64-character ID returned by the API.
    - `base_id` string, required: The 64-character ID returned by the API.
    - `filename` string, required: Original filename.
    - `format` string, required: Source format: pdf, docx or doc.
    - `bytes` integer, required: Original file size.
    - `quote` ConversionQuote, required
      - `id` string, required: The 64-character ID returned by the API.
      - `source_sha256` string, required: SHA-256 of the original document bytes.
      - `pages` integer, required: PDF physical page count (1–200). Zero for DOC and DOCX, whose text is not paginated.
      - `price_usd` string, required: Total price in USD, as a decimal string.
    - `status` string, required: quoted, queued, processing, ready or failed.
    - `document_id` string, nullable, required: Base document ID after successful import.
    - `error` string, nullable, required: Failure code, or null.
    - `progress` object, nullable, required: stage and page counts from the last core observation, or null.
    - `created_at` string, required: Creation time, ISO 8601.
    - `updated_at` string, required: Last update, ISO 8601.
    - `expires_at` string, nullable, required: Processing deadline after authorization; null before authorization.
    - `processing` object, nullable: Stored core job on detail reads. No generation occurs during the read.

## Other responses

- `400`: Invalid file, base64, or authorization.
- `401`: A personal session or API key is required.
- `402`: Credit or base capacity is required. Read the payment challenge or capacity field.
- `403`: An organization key cannot manage personal conversions.
- `404`: The conversion is unavailable to this account, or conversion is disabled.
- `409`: Quote changed, capacity is full, conversion is busy, or the job was already authorized.
- `413`: The upload or request body exceeds its limit.
- `415`: Use PDF, DOCX or DOC MIME type, or application/json.
- `503`: Storage or the document core is unavailable.

---

[API](https://skmtc.dev/okfindex/apis/okf-index.md) · [All operations](https://skmtc.dev/okfindex/apis/okf-index/llms.txt) · [OpenAPI document](https://skmtc.dev/okfindex/apis/okf-index/revisions/4b13ca3c739f?raw)