## Get Parse Job `ParsingGetResponse parsing().get(ParsingGetParamsparams = ParsingGetParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` **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. ### Parameters - `ParsingGetParams params` - `Optional jobId` - `Optional> expand` 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. - `Optional imageFilenames` Filter to specific image filenames (optional). Example: image_0.png,image_1.jpg - `Optional organizationId` - `Optional projectId` ### Returns - `class ParsingGetResponse:` 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 job` Parse job status and metadata - `String id` Unique parse job identifier - `String projectId` Project this job belongs to - `Status status` Current job status: PENDING, RUNNING, COMPLETED, FAILED, or CANCELLED - `PENDING("PENDING")` - `RUNNING("RUNNING")` - `COMPLETED("COMPLETED")` - `FAILED("FAILED")` - `CANCELLED("CANCELLED")` - `Optional createdAt` Creation datetime - `Optional errorMessage` Error details when status is FAILED - `Optional name` Optional display name for this parse job - `Optional tier` Parsing tier used for this job - `Optional updatedAt` Update datetime - `Optional imagesContentMetadata` Metadata for all extracted images. - `List images` List of image metadata with presigned URLs - `String filename` Image filename (e.g., 'image_0.png') - `long index` Index of the image in the extraction order - `Optional bbox` Bounding box for an image on its page. - `long h` Height of the bounding box - `long w` Width of the bounding box - `long x` X coordinate of the bounding box - `long y` Y coordinate of the bounding box - `Optional category` Image category: 'screenshot' (full page), 'embedded' (images in document), or 'layout' (cropped from layout detection) - `SCREENSHOT("screenshot")` - `EMBEDDED("embedded")` - `LAYOUT("layout")` - `Optional contentType` MIME type of the image - `Optional presignedUrl` Presigned URL to download the image - `Optional sizeBytes` Deprecated: always returns None. Will be removed in a future release. - `long totalCount` Total number of extracted images - `Optional items` Structured JSON result (if requested) - `List pages` List of structured pages or failed page entries - `class StructuredResultPage:` - `List items` List of structured items on the page - `class TextItem:` - `String md` Markdown representation preserving formatting - `String value` Text content - `Optional> bbox` List of bounding boxes - `double h` Height of the bounding box - `double w` Width of the bounding box - `double x` X coordinate of the bounding box - `double y` Y coordinate of the bounding box - `Optional confidence` Confidence score - `Optional endIndex` End index in the text - `Optional label` Label for the bounding box - `Optional r` Optional visual text rotation angle in degrees. Omitted when unrotated. - `Optional startIndex` Start index in the text - `Optional type` Text item type - `TEXT("text")` - `class HeadingItem:` - `long level` Heading level (1-6) - `String md` Markdown representation preserving formatting - `String value` Heading text content - `Optional> bbox` List of bounding boxes - `double h` Height of the bounding box - `double w` Width of the bounding box - `double x` X coordinate of the bounding box - `double y` Y coordinate of the bounding box - `Optional confidence` Confidence score - `Optional endIndex` End index in the text - `Optional label` Label for the bounding box - `Optional r` Optional visual text rotation angle in degrees. Omitted when unrotated. - `Optional startIndex` Start index in the text - `Optional type` Heading item type - `HEADING("heading")` - `class ListItem:` - `List items` List of nested text or list items - `class TextItem:` - `class ListItem:` - `String md` Markdown representation preserving formatting - `boolean ordered` Whether the list is ordered or unordered - `Optional> bbox` List of bounding boxes - `double h` Height of the bounding box - `double w` Width of the bounding box - `double x` X coordinate of the bounding box - `double y` Y coordinate of the bounding box - `Optional confidence` Confidence score - `Optional endIndex` End index in the text - `Optional label` Label for the bounding box - `Optional r` Optional visual text rotation angle in degrees. Omitted when unrotated. - `Optional startIndex` Start index in the text - `Optional type` List item type - `LIST("list")` - `class CodeItem:` - `String md` Markdown representation preserving formatting - `String value` Code content - `Optional> bbox` List of bounding boxes - `double h` Height of the bounding box - `double w` Width of the bounding box - `double x` X coordinate of the bounding box - `double y` Y coordinate of the bounding box - `Optional confidence` Confidence score - `Optional endIndex` End index in the text - `Optional label` Label for the bounding box - `Optional r` Optional visual text rotation angle in degrees. Omitted when unrotated. - `Optional startIndex` Start index in the text - `Optional language` Programming language identifier - `Optional type` Code block item type - `CODE("code")` - `class TableItem:` - `String csv` CSV representation of the table - `String html` HTML representation of the table - `String md` Markdown representation preserving formatting - `List> rows` Table data as array of arrays (string, number, or null) - `String` - `double` - `Optional> bbox` List of bounding boxes - `double h` Height of the bounding box - `double w` Width of the bounding box - `double x` X coordinate of the bounding box - `double y` Y coordinate of the bounding box - `Optional confidence` Confidence score - `Optional endIndex` End index in the text - `Optional label` Label for the bounding box - `Optional r` Optional visual text rotation angle in degrees. Omitted when unrotated. - `Optional startIndex` Start index in the text - `Optional> mergedFromPages` List of page numbers with tables that were merged into this table (e.g., [1, 2, 3, 4]) - `Optional mergedIntoPage` Populated when merged into another table. Page number where the full merged table begins (used on empty tables). - `Optional> parseConcerns` Quality concerns detected during table extraction, indicating the table may have issues - `String details` Human-readable details about the concern - `String type` Type of parse concern (e.g. header_value_type_mismatch, inconsistent_row_cell_count) - `Optional type` Table item type - `TABLE("table")` - `class ImageItem:` - `String caption` Image caption - `String md` Markdown representation preserving formatting - `String url` URL to the image - `Optional> bbox` List of bounding boxes - `double h` Height of the bounding box - `double w` Width of the bounding box - `double x` X coordinate of the bounding box - `double y` Y coordinate of the bounding box - `Optional confidence` Confidence score - `Optional endIndex` End index in the text - `Optional label` Label for the bounding box - `Optional r` Optional visual text rotation angle in degrees. Omitted when unrotated. - `Optional startIndex` Start index in the text - `Optional type` Image item type - `IMAGE("image")` - `class LinkItem:` - `String md` Markdown representation preserving formatting - `String text` Display text of the link - `String url` URL of the link - `Optional> bbox` List of bounding boxes - `double h` Height of the bounding box - `double w` Width of the bounding box - `double x` X coordinate of the bounding box - `double y` Y coordinate of the bounding box - `Optional confidence` Confidence score - `Optional endIndex` End index in the text - `Optional label` Label for the bounding box - `Optional r` Optional visual text rotation angle in degrees. Omitted when unrotated. - `Optional startIndex` Start index in the text - `Optional type` Link item type - `LINK("link")` - `class HeaderItem:` - `List items` List of items within the header - `class TextItem:` - `class HeadingItem:` - `class ListItem:` - `class CodeItem:` - `class TableItem:` - `class ImageItem:` - `class LinkItem:` - `String md` Markdown representation preserving formatting - `Optional> bbox` List of bounding boxes - `double h` Height of the bounding box - `double w` Width of the bounding box - `double x` X coordinate of the bounding box - `double y` Y coordinate of the bounding box - `Optional confidence` Confidence score - `Optional endIndex` End index in the text - `Optional label` Label for the bounding box - `Optional r` Optional visual text rotation angle in degrees. Omitted when unrotated. - `Optional startIndex` Start index in the text - `Optional type` Page header container - `HEADER("header")` - `class FooterItem:` - `List items` List of items within the footer - `class TextItem:` - `class HeadingItem:` - `class ListItem:` - `class CodeItem:` - `class TableItem:` - `class ImageItem:` - `class LinkItem:` - `String md` Markdown representation preserving formatting - `Optional> bbox` List of bounding boxes - `double h` Height of the bounding box - `double w` Width of the bounding box - `double x` X coordinate of the bounding box - `double y` Y coordinate of the bounding box - `Optional confidence` Confidence score - `Optional endIndex` End index in the text - `Optional label` Label for the bounding box - `Optional r` Optional visual text rotation angle in degrees. Omitted when unrotated. - `Optional startIndex` Start index in the text - `Optional type` Page footer container - `FOOTER("footer")` - `double pageHeight` Height of the page in points - `long pageNumber` Page number of the document - `double pageWidth` Width of the page in points - `JsonValue; success trueconstant` Success indicator - `TRUE(true)` - `class FailedStructuredPage:` - `String error` Error message describing the failure - `long pageNumber` Page number of the document - `JsonValue; success falseconstant` Failure indicator - `FALSE(false)` - `Optional jobMetadata` Job execution metadata (if requested) - `Optional markdown` Markdown result (if requested) - `List pages` List of markdown pages or failed page entries - `class MarkdownResultPage:` - `String markdown` Markdown content of the page - `long pageNumber` Page number of the document - `JsonValue; success trueconstant` Success indicator - `TRUE(true)` - `Optional footer` Footer of the page in markdown - `Optional header` Header of the page in markdown - `class FailedMarkdownPage:` - `String error` Error message describing the failure - `long pageNumber` Page number of the document - `JsonValue; success falseconstant` Failure indicator - `FALSE(false)` - `Optional markdownFull` Full raw markdown content (if requested) - `Optional metadata` Result containing metadata (page level and general) for the parsed document. - `List pages` List of page metadata entries - `long pageNumber` Page number of the document - `Optional confidence` Confidence score for the page parsing (0-1) - `Optional costOptimized` Whether cost-optimized parsing was used for the page - `Optional originalOrientationAngle` Original orientation angle of the page in degrees - `Optional printedPageNumber` Printed page number as it appears in the document - `Optional slideSectionName` Section name from presentation slides - `Optional speakerNotes` Speaker notes from presentation slides - `Optional triggeredAutoMode` Whether auto mode was triggered for the page - `Optional rawParameters` - `Optional resultContentMetadata` Metadata including size, existence, and presigned URLs for result files - `long sizeBytes` Size of the result file in bytes - `Optional exists` Whether the result file exists in S3 - `Optional presignedUrl` Presigned URL to download the result file - `Optional text` Plain text result (if requested) - `List pages` List of text pages - `long pageNumber` Page number of the document - `String text` Plain text content of the page - `Optional textFull` Full raw text content (if requested) ### Example ```java package com.llamacloud_prod.api.example; import com.llamacloud_prod.api.client.LlamaCloudClient; import com.llamacloud_prod.api.client.okhttp.LlamaCloudOkHttpClient; import com.llamacloud_prod.api.models.parsing.ParsingGetParams; import com.llamacloud_prod.api.models.parsing.ParsingGetResponse; public final class Main { private Main() {} public static void main(String[] args) { LlamaCloudClient client = LlamaCloudOkHttpClient.fromEnv(); ParsingGetResponse parsing = client.parsing().get("job_id"); } } ``` #### Response ```json { "job": { "id": "pjb-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "project_id": "prj-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "status": "PENDING", "created_at": "2019-12-27T18:11:19.117Z", "error_message": "error_message", "name": "Q4 Financial Report", "tier": "fast", "updated_at": "2019-12-27T18:11:19.117Z" }, "images_content_metadata": { "images": [ { "filename": "filename", "index": 0, "bbox": { "h": 0, "w": 0, "x": 0, "y": 0 }, "category": "screenshot", "content_type": "content_type", "presigned_url": "presigned_url", "size_bytes": 0 } ], "total_count": 0 }, "items": { "pages": [ { "items": [ { "md": "md", "value": "value", "bbox": [ { "h": 0, "w": 0, "x": 0, "y": 0, "confidence": 0, "end_index": 0, "label": "label", "r": 0, "start_index": 0 } ], "type": "text" } ], "page_height": 0, "page_number": 0, "page_width": 0, "success": true } ] }, "job_metadata": { "foo": "bar" }, "markdown": { "pages": [ { "markdown": "markdown", "page_number": 0, "success": true, "footer": "footer", "header": "header" } ] }, "markdown_full": "markdown_full", "metadata": { "pages": [ { "page_number": 0, "confidence": 0, "cost_optimized": true, "original_orientation_angle": 0, "printed_page_number": "printed_page_number", "slide_section_name": "slide_section_name", "speaker_notes": "speaker_notes", "triggered_auto_mode": true } ] }, "raw_parameters": { "foo": "bar" }, "result_content_metadata": { "foo": { "size_bytes": 0, "exists": true, "presigned_url": "presigned_url" } }, "text": { "pages": [ { "page_number": 0, "text": "text" } ] }, "text_full": "text_full" } ```