--- title: "Get Parse Job" method: GET path: "/api/v2/parse/{job_id}" tags: ["V2", "Parse"] --- # Get Parse Job `GET /api/v2/parse/{job_id}` Retrieve a parse job with optional expanded content. By default returns job metadata only. Use `expand` to include parsed content: - `text` — plain text output - `markdown` — markdown output - `items` — structured page-by-page output - `job_metadata` — usage and processing details Content metadata fields (e.g. `text_content_metadata`) return presigned URLs for downloading large results. ## Path parameters - `job_id` string, required ## Query parameters - `expand` string[] — Fields to include: text, markdown, items, metadata, job_metadata, text_content_metadata, markdown_content_metadata, items_content_metadata, metadata_content_metadata, raw_words_content_metadata, xlsx_content_metadata, output_pdf_content_metadata, images_content_metadata. Metadata fields include presigned URLs. - `image_filenames` string, nullable — Filter to specific image filenames (optional). Example: image_0.png,image_1.jpg - `project_id` string, uuid, nullable - `organization_id` string, uuid, nullable ## Cookies - `session` string, nullable ## Response `200` Successful Response - ParseResultResponse — Parse result response with job status and optional content or metadata. The job field is always included. Other fields are included based on expand parameters. - `job` ParseJobResponse, required — A parse job. - `id` string, required — Unique parse job identifier - `created_at` string, date-time, nullable — Creation datetime - `updated_at` string, date-time, nullable — Update datetime - `project_id` string, required — Project this job belongs to - `status` 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required — Current job status: PENDING, RUNNING, COMPLETED, FAILED, or CANCELLED - `error_message` string, nullable — Error details when status is FAILED - `name` string, nullable — Optional display name for this parse job - `tier` string, nullable — Parsing tier used for this job - `result_content_metadata` object, nullable — Metadata including size, existence, and presigned URLs for result files - `text` TextResult - `pages` TextResultPage[], required — List of text pages - `page_number` integer, required — Page number of the document - `text` string, required — Plain text content of the page - `markdown` MarkdownResult - `pages` union[], required — List of markdown pages or failed page entries - union - MarkdownResultPage - `page_number` integer, required — Page number of the document - `markdown` string, required — Markdown content of the page - `header` string, nullable — Header of the page in markdown - `footer` string, nullable — Footer of the page in markdown - `success` true, required — Success indicator - FailedMarkdownPage - `page_number` integer, required — Page number of the document - `error` string, required — Error message describing the failure - `success` false, required — Failure indicator - `items` StructuredResult - `pages` union[], required — List of structured pages or failed page entries - union - StructuredResultPage - `page_number` integer, required — Page number of the document - `items` union[], required — List of structured items on the page - union - … - `page_width` number, required — Width of the page in points - `page_height` number, required — Height of the page in points - `success` true, required — Success indicator - FailedStructuredPage - `page_number` integer, required — Page number of the document - `error` string, required — Error message describing the failure - `success` false, required — Failure indicator - `metadata` MetadataResult — Result containing metadata (page level and general) for the parsed document. - `pages` MetadataResultPage[], required — List of page metadata entries - `page_number` integer, required — Page number of the document - `confidence` number, nullable — Confidence score for the page parsing (0-1) - `speaker_notes` string, nullable — Speaker notes from presentation slides - `slide_section_name` string, nullable — Section name from presentation slides - `printed_page_number` string, nullable — Printed page number as it appears in the document - `original_orientation_angle` integer, nullable — Original orientation angle of the page in degrees - `cost_optimized` boolean, nullable — Whether cost-optimized parsing was used for the page - `triggered_auto_mode` boolean, nullable — Whether auto mode was triggered for the page - `markdown_full` string, nullable — Full raw markdown content (if requested) - `text_full` string, nullable — Full raw text content (if requested) - `images_content_metadata` ImagesContentMetadata — Metadata for all extracted images. - `total_count` integer, required — Total number of extracted images - `images` ImageMetadata[], required — List of image metadata with presigned URLs - `index` integer, required — Index of the image in the extraction order - `filename` string, required — Image filename (e.g., 'image_0.png') - `content_type` string, nullable — MIME type of the image - `size_bytes` integer, nullable — Deprecated: always returns None. Will be removed in a future release. - `presigned_url` string, nullable — Presigned URL to download the image - `category` 'screenshot' | 'embedded' | 'layout', nullable — Image category: 'screenshot' (full page), 'embedded' (images in document), or 'layout' (cropped from layout detection) - `bbox` ImageMetadataBBox — Bounding box for an image on its page. - `x` integer, required — X coordinate of the bounding box - `y` integer, required — Y coordinate of the bounding box - `w` integer, required — Width of the bounding box - `h` integer, required — Height of the bounding box - `job_metadata` object, nullable — Job execution metadata (if requested) - `raw_parameters` object, nullable ## Other responses - `422` — Validation Error --- [API](https://skmtc.net/run-llama/apis/llama-platform.md) · [All operations](https://skmtc.net/run-llama/apis/llama-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/run-llama/llama-platform/versions/b17341164de9/schema)