> ## Documentation Index > Fetch the complete documentation index at: https://docs.reducto.ai/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve Job ## OpenAPI ````yaml openapi.json get /job/{job_id} openapi: 3.1.0 info: title: Reducto API version: v1.11.81-297-g4204a908d servers: - url: https://platform.reducto.ai security: [] paths: /job/{job_id}: get: summary: Retrieve Parse operationId: retrieve_parse_job__job_id__get parameters: - name: job_id in: path required: true schema: type: string title: Job Id responses: '200': description: Successful Response content: application/json: schema: anyOf: - $ref: '#/components/schemas/AsyncJobResponse' - $ref: '#/components/schemas/EnhancedAsyncJobResponse' title: Response Retrieve Parse Job Job Id Get '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - SkippableHTTPBearer: [] components: schemas: AsyncJobResponse: properties: status: type: string enum: - Pending - Completed - Failed - Idle title: Status result: anyOf: - oneOf: - $ref: '#/components/schemas/ParseResponse' - $ref: '#/components/schemas/ExtractResponse' - $ref: '#/components/schemas/SplitResponse' - $ref: '#/components/schemas/EditResponse' - $ref: '#/components/schemas/PipelineResponse' - $ref: '#/components/schemas/V3ExtractResponse' - $ref: '#/components/schemas/ClassifyResponse' discriminator: propertyName: response_type mapping: classify: $ref: '#/components/schemas/ClassifyResponse' edit: $ref: '#/components/schemas/EditResponse' extract: $ref: '#/components/schemas/ExtractResponse' parse: $ref: '#/components/schemas/ParseResponse' pipeline: $ref: '#/components/schemas/PipelineResponse' split: $ref: '#/components/schemas/SplitResponse' v3_extract: $ref: '#/components/schemas/V3ExtractResponse' - type: 'null' title: Result progress: anyOf: - type: number - type: 'null' title: Progress reason: anyOf: - type: string - type: 'null' title: Reason type: object required: - status title: AsyncJobResponse EnhancedAsyncJobResponse: properties: status: type: string enum: - Pending - Completed - Failed - Idle title: Status result: anyOf: - oneOf: - $ref: '#/components/schemas/ParseResponse' - $ref: '#/components/schemas/ExtractResponse' - $ref: '#/components/schemas/SplitResponse' - $ref: '#/components/schemas/EditResponse' - $ref: '#/components/schemas/PipelineResponse' - $ref: '#/components/schemas/V3ExtractResponse' - $ref: '#/components/schemas/ClassifyResponse' discriminator: propertyName: response_type mapping: classify: $ref: '#/components/schemas/ClassifyResponse' edit: $ref: '#/components/schemas/EditResponse' extract: $ref: '#/components/schemas/ExtractResponse' parse: $ref: '#/components/schemas/ParseResponse' pipeline: $ref: '#/components/schemas/PipelineResponse' split: $ref: '#/components/schemas/SplitResponse' v3_extract: $ref: '#/components/schemas/V3ExtractResponse' - type: 'null' title: Result progress: anyOf: - type: number - type: 'null' title: Progress reason: anyOf: - type: string - type: 'null' title: Reason type: anyOf: - type: string enum: - Parse - Extract - Split - Edit - Pipeline - Classify - type: 'null' title: Type num_pages: anyOf: - type: integer - type: 'null' title: Num Pages total_pages: anyOf: - type: integer - type: 'null' title: Total Pages source: anyOf: - {} - type: 'null' title: Source duration: anyOf: - type: number - type: 'null' title: Duration created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At raw_config: anyOf: - type: string - type: 'null' title: Raw Config bucket: anyOf: - {} - type: 'null' title: Bucket type: object required: - status title: EnhancedAsyncJobResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ParseResponse: properties: response_type: type: string const: parse title: Response Type default: parse job_id: type: string title: Job Id duration: type: number title: Duration description: The duration of the parse request in seconds. pdf_url: anyOf: - type: string - type: 'null' title: Pdf Url description: The storage URL of the converted PDF file. studio_link: anyOf: - type: string - type: 'null' title: Studio Link description: The link to the studio pipeline for the document. usage: $ref: '#/components/schemas/ParseUsage' result: anyOf: - $ref: '#/components/schemas/FullResult' - $ref: '#/components/schemas/UrlResult' title: Result description: >- The response from the document processing service. Note that there can be two types of responses, Full Result and URL Result. This is due to limitations on the max return size on HTTPS. If the response is too large, it will be returned as a presigned URL in the URL response. You should handle this in your application. parse_mode: anyOf: - type: string enum: - base - lite - type: 'null' title: Parse Mode description: >- Which pipeline produced this response. ``lite`` means Reducto Flash Lite served the request; ``base`` is the standard pipeline. Optional / nullable for forward compatibility — older API instances or persisted responses written before this field existed will leave it ``None``; treat ``None`` as ``base``. type: object required: - job_id - duration - usage - result title: ParseResponse ExtractResponse: additionalProperties: true type: object SplitResponse: properties: response_type: type: string const: split title: Response Type default: split usage: $ref: '#/components/schemas/ParseUsage' result: anyOf: - $ref: '#/components/schemas/SplitResult' - $ref: '#/components/schemas/DeepSplitResult' title: Result description: The split result. type: object required: - usage - result title: SplitResponse EditResponse: properties: response_type: type: string const: edit title: Response Type default: edit document_url: type: string title: Document Url description: Presigned URL to download the edited document. form_schema: anyOf: - items: $ref: '#/components/schemas/EditWidget' type: array - type: 'null' title: Form Schema description: >- Form schema for PDF forms. List of widgets with their types, descriptions, and bounding boxes. usage: anyOf: - $ref: '#/components/schemas/ParseUsage' - type: 'null' description: >- Usage information for the edit operation, including number of pages and credits charged. type: object required: - document_url title: EditResponse PipelineResponse: properties: response_type: type: string const: pipeline title: Response Type default: pipeline job_id: type: string title: Job Id usage: $ref: '#/components/schemas/ParseUsage' result: $ref: '#/components/schemas/PipelineResult' type: object required: - job_id - usage - result title: PipelineResponse V3ExtractResponse: additionalProperties: true type: object ClassifyResponse: properties: response_type: type: string const: classify title: Response Type default: classify job_id: type: string title: Job Id result: $ref: '#/components/schemas/ClassifyResponseCategory' response_confidence: anyOf: - $ref: '#/components/schemas/ResponseConfidence' - type: 'null' usage: anyOf: - $ref: '#/components/schemas/ClassifyUsage' - type: 'null' duration: anyOf: - type: number - type: 'null' title: Duration description: The duration of the classify request in seconds. type: object required: - job_id - result title: ClassifyResponse description: Response from classify job - returned when polling /job/{job_id} ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ParseUsage: properties: num_pages: type: integer title: Num Pages credits: anyOf: - type: number - type: 'null' title: Credits credit_breakdown: anyOf: - additionalProperties: type: number propertyNames: enum: - page - html_page - docx_native_page - chart_agent - spreadsheet_cells - billable_spreadsheet_pages - agentic - complex - enrich_table - figure_summary - table_summary - key_value - agentic_text - promptable_agentic_text - reducto_lite_page type: object - type: 'null' title: Credit Breakdown page_billing_breakdown: anyOf: - additionalProperties: items: type: string enum: - page - html_page - docx_native_page - agentic - complex - chart_agent - spreadsheet_cells - billable_spreadsheet_pages - enrich_table - figure_summary - table_summary - key_value - agentic_text - promptable_agentic_text - reducto_lite_page type: array type: object - type: 'null' title: Page Billing Breakdown description: >- Per-page breakdown of features used. Maps 1-indexed page numbers (as strings) to the list of billing features applied on that page (e.g. 'page', 'complex', 'chart_agent'). non_empty_cell_count: anyOf: - type: integer - type: 'null' title: Non Empty Cell Count description: >- Total non-empty cells across all sheets. Only set for spreadsheet inputs. type: object required: - num_pages title: ParseUsage FullResult: properties: type: type: string const: full title: Type description: type = 'full' chunks: items: $ref: '#/components/schemas/ParseChunk' type: array title: Chunks ocr: anyOf: - $ref: '#/components/schemas/OCRResult' - type: 'null' custom: anyOf: - {} - type: 'null' title: Custom type: object required: - type - chunks title: FullResult UrlResult: properties: type: type: string const: url title: Type description: type = 'url' url: type: string title: Url result_id: type: string title: Result Id type: object required: - type - url - result_id title: UrlResult SplitResult: properties: section_mapping: anyOf: - additionalProperties: items: type: integer type: array type: object - type: 'null' title: Section Mapping splits: items: $ref: '#/components/schemas/Split' type: array title: Splits type: object required: - section_mapping - splits title: SplitResult DeepSplitResult: properties: splits: items: $ref: '#/components/schemas/DeepSplit' type: array title: Splits type: object required: - splits title: DeepSplitResult EditWidget: properties: bbox: $ref: '#/components/schemas/BoundingBox' description: Bounding box coordinates of the widget description: type: string title: Description description: Description of the widget extracted from the document type: type: string enum: - text - checkbox - radio - dropdown - barcode title: Type description: Type of the form widget fill: type: boolean title: Fill description: >- If True (default), the system will attempt to fill this widget. If False, the widget will be created but intentionally left unfilled. default: true value: anyOf: - type: string - type: 'null' title: Value description: >- If provided, this value will be used directly instead of attempting to intelligently determine the field value. font_size: anyOf: - type: number maximum: 72 minimum: 1 - type: 'null' title: Font Size description: >- Font size in points for this specific field. Takes priority over the global font_size in EditOptions. If not set, falls back to the global font_size, then to auto-calculated sizing. type: object required: - bbox - description - type title: EditWidget PipelineResult: properties: parse: anyOf: - $ref: '#/components/schemas/ParseResponse' - items: $ref: '#/components/schemas/ParseResponse' type: array - type: 'null' title: Parse extract: anyOf: - items: $ref: '#/components/schemas/ExtractSplitResponse' type: array - $ref: '#/components/schemas/ExtractResponse' - $ref: '#/components/schemas/V3ExtractResponse' - type: 'null' title: Extract split: anyOf: - $ref: '#/components/schemas/SplitResponse' - type: 'null' edit: anyOf: - $ref: '#/components/schemas/EditResponse' - type: 'null' type: object required: - parse - extract - split title: PipelineResult ClassifyResponseCategory: properties: category: type: string title: Category type: object required: - category title: ClassifyResponseCategory ResponseConfidence: properties: categories: items: $ref: '#/components/schemas/CategoryConfidence' type: array title: Categories type: object required: - categories title: ResponseConfidence description: Overall confidence breakdown for classification response. ClassifyUsage: properties: num_pages: type: integer title: Num Pages num_categories: type: integer title: Num Categories credits: anyOf: - type: number - type: 'null' title: Credits type: object required: - num_pages - num_categories title: ClassifyUsage ParseChunk: properties: content: type: string title: Content description: The content of the chunk extracted from the document. embed: type: string title: Embed description: Chunk content optimized for embedding and retrieval. enriched: anyOf: - type: string - type: 'null' title: Enriched description: The enriched content of the chunk extracted from the document. enrichment_success: type: boolean title: Enrichment Success description: Whether the enrichment was successful. default: false blocks: items: $ref: '#/components/schemas/ParseBlock' type: array title: Blocks type: object required: - content - embed - enriched - blocks title: ParseChunk OCRResult: properties: words: items: $ref: '#/components/schemas/OCRWord' type: array title: Words lines: items: $ref: '#/components/schemas/OCRLine' type: array title: Lines type: object required: - words - lines title: OCRResult Split: properties: name: type: string title: Name pages: items: type: integer type: array title: Pages conf: type: string enum: - high - low title: Conf default: low partitions: anyOf: - items: $ref: '#/components/schemas/SplitPartition' type: array - type: 'null' title: Partitions type: object required: - name - pages title: Split DeepSplit: properties: name: type: string title: Name pages: items: $ref: '#/components/schemas/DeepSplitPageEvidence' type: array title: Pages partitions: anyOf: - items: $ref: '#/components/schemas/DeepSplitPartition' type: array - type: 'null' title: Partitions type: object required: - name - pages title: DeepSplit BoundingBox: properties: left: type: number title: Left top: type: number title: Top width: type: number title: Width height: type: number title: Height page: type: integer title: Page description: The page number of the bounding box (1-indexed). original_page: type: integer title: Original Page description: >- The page number in the original document of the bounding box (1-indexed). type: object required: - left - top - width - height - page title: BoundingBox ExtractSplitResponse: properties: split_name: type: string title: Split Name page_range: items: type: integer type: array title: Page Range partition: anyOf: - type: string - type: 'null' title: Partition result: anyOf: - $ref: '#/components/schemas/ExtractResponse' - $ref: '#/components/schemas/V3ExtractResponse' title: Result type: object required: - split_name - page_range - result title: ExtractSplitResponse description: This is the response format for Extract -> Split Pipelines CategoryConfidence: properties: category: type: string title: Category confidence: type: number title: Confidence criteria_confidence: items: $ref: '#/components/schemas/CriteriaConfidence' type: array title: Criteria Confidence type: object required: - category - confidence - criteria_confidence title: CategoryConfidence description: Confidence result for a category. ParseBlock: additionalProperties: true type: object OCRWord: properties: text: type: string title: Text bbox: $ref: '#/components/schemas/BoundingBox' confidence: anyOf: - type: number - type: 'null' title: Confidence description: >- OCR confidence score between 0 and 1, where 1 indicates highest confidence chunk_index: anyOf: - type: integer - type: 'null' title: Chunk Index description: The index of the chunk that the word belongs to. rotation: anyOf: - type: integer - type: 'null' title: Rotation description: The rotation angle in degrees, from 0 to 360, counterclockwise. type: object required: - text - bbox title: OCRWord OCRLine: properties: text: type: string title: Text bbox: $ref: '#/components/schemas/BoundingBox' confidence: anyOf: - type: number - type: 'null' title: Confidence description: >- OCR confidence score between 0 and 1, where 1 indicates highest confidence chunk_index: anyOf: - type: integer - type: 'null' title: Chunk Index description: The index of the chunk that the line belongs to. rotation: anyOf: - type: integer - type: 'null' title: Rotation description: The rotation angle in degrees, from 0 to 360, counterclockwise. type: object required: - text - bbox title: OCRLine SplitPartition: properties: name: type: string title: Name pages: items: type: integer type: array title: Pages conf: type: string enum: - high - low title: Conf default: low type: object required: - name - pages title: SplitPartition DeepSplitPageEvidence: properties: page_number: type: integer title: Page Number evidence: type: string title: Evidence confidence: anyOf: - type: string enum: - high - medium - low - type: 'null' title: Confidence type: object required: - page_number - evidence title: DeepSplitPageEvidence DeepSplitPartition: properties: name: type: string title: Name pages: items: $ref: '#/components/schemas/DeepSplitPageEvidence' type: array title: Pages type: object required: - name - pages title: DeepSplitPartition CriteriaConfidence: properties: criterion: type: string title: Criterion confidence: type: string enum: - high - low title: Confidence type: object required: - criterion - confidence title: CriteriaConfidence description: Confidence result for a single criterion. securitySchemes: SkippableHTTPBearer: type: http scheme: bearer ````