## Parse File
`client.Parsing.New(ctx, params) (*ParsingNewResponse, error)`
**post** `/api/v2/parse`
Parse a file by file ID or URL.
Provide either `file_id` (a previously uploaded file) or
`source_url` (a publicly accessible URL). Configure parsing
with options like `tier`, `target_pages`, and `lang`.
## Tiers
- `fast` — rule-based, cheapest, no AI
- `cost_effective` — balanced speed and quality
- `agentic` — full AI-powered parsing
- `agentic_plus` — premium AI with specialized features
The job runs asynchronously. Poll `GET /parse/{job_id}` with
`expand=text` or `expand=markdown` to retrieve results.
### Parameters
- `params ParsingNewParams`
- `Tier param.Field[ParsingNewParamsTier]`
Body param: Parsing tier: 'fast' (rule-based, cheapest), 'cost_effective' (balanced), 'agentic' (AI-powered with custom prompts), or 'agentic_plus' (premium AI with highest accuracy)
- `const ParsingNewParamsTierFast ParsingNewParamsTier = "fast"`
- `const ParsingNewParamsTierCostEffective ParsingNewParamsTier = "cost_effective"`
- `const ParsingNewParamsTierAgentic ParsingNewParamsTier = "agentic"`
- `const ParsingNewParamsTierAgenticPlus ParsingNewParamsTier = "agentic_plus"`
- `Version param.Field[ParsingNewParamsVersion]`
Body param: Tier version. Use 'latest' for the current stable version, or specify a specific version (e.g., '1.0', '2.0') for reproducible results
- `type ParsingNewParamsVersion string`
Tier version. Use 'latest' for the current stable version, or specify a specific version (e.g., '1.0', '2.0') for reproducible results
- `const ParsingNewParamsVersion2025_12_11 ParsingNewParamsVersion = "2025-12-11"`
- `const ParsingNewParamsVersion2025_12_18 ParsingNewParamsVersion = "2025-12-18"`
- `const ParsingNewParamsVersion2025_12_31 ParsingNewParamsVersion = "2025-12-31"`
- `const ParsingNewParamsVersion2026_01_08 ParsingNewParamsVersion = "2026-01-08"`
- `const ParsingNewParamsVersion2026_01_09 ParsingNewParamsVersion = "2026-01-09"`
- `const ParsingNewParamsVersion2026_01_16 ParsingNewParamsVersion = "2026-01-16"`
- `const ParsingNewParamsVersion2026_01_21 ParsingNewParamsVersion = "2026-01-21"`
- `const ParsingNewParamsVersion2026_01_22 ParsingNewParamsVersion = "2026-01-22"`
- `const ParsingNewParamsVersion2026_01_24 ParsingNewParamsVersion = "2026-01-24"`
- `const ParsingNewParamsVersion2026_01_29 ParsingNewParamsVersion = "2026-01-29"`
- `const ParsingNewParamsVersion2026_01_30 ParsingNewParamsVersion = "2026-01-30"`
- `const ParsingNewParamsVersion2026_02_03 ParsingNewParamsVersion = "2026-02-03"`
- `const ParsingNewParamsVersion2026_02_18 ParsingNewParamsVersion = "2026-02-18"`
- `const ParsingNewParamsVersion2026_02_20 ParsingNewParamsVersion = "2026-02-20"`
- `const ParsingNewParamsVersion2026_02_24 ParsingNewParamsVersion = "2026-02-24"`
- `const ParsingNewParamsVersion2026_02_26 ParsingNewParamsVersion = "2026-02-26"`
- `const ParsingNewParamsVersion2026_03_02 ParsingNewParamsVersion = "2026-03-02"`
- `const ParsingNewParamsVersion2026_03_03 ParsingNewParamsVersion = "2026-03-03"`
- `const ParsingNewParamsVersion2026_03_04 ParsingNewParamsVersion = "2026-03-04"`
- `const ParsingNewParamsVersion2026_03_05 ParsingNewParamsVersion = "2026-03-05"`
- `const ParsingNewParamsVersion2026_03_09 ParsingNewParamsVersion = "2026-03-09"`
- `const ParsingNewParamsVersion2026_03_10 ParsingNewParamsVersion = "2026-03-10"`
- `const ParsingNewParamsVersion2026_03_11 ParsingNewParamsVersion = "2026-03-11"`
- `const ParsingNewParamsVersion2026_03_12 ParsingNewParamsVersion = "2026-03-12"`
- `const ParsingNewParamsVersion2026_03_17 ParsingNewParamsVersion = "2026-03-17"`
- `const ParsingNewParamsVersion2026_03_19 ParsingNewParamsVersion = "2026-03-19"`
- `const ParsingNewParamsVersion2026_03_20 ParsingNewParamsVersion = "2026-03-20"`
- `const ParsingNewParamsVersion2026_03_22 ParsingNewParamsVersion = "2026-03-22"`
- `const ParsingNewParamsVersion2026_03_23 ParsingNewParamsVersion = "2026-03-23"`
- `const ParsingNewParamsVersion2026_03_24 ParsingNewParamsVersion = "2026-03-24"`
- `const ParsingNewParamsVersion2026_03_25 ParsingNewParamsVersion = "2026-03-25"`
- `const ParsingNewParamsVersion2026_03_26 ParsingNewParamsVersion = "2026-03-26"`
- `const ParsingNewParamsVersion2026_03_27 ParsingNewParamsVersion = "2026-03-27"`
- `const ParsingNewParamsVersion2026_03_30 ParsingNewParamsVersion = "2026-03-30"`
- `const ParsingNewParamsVersion2026_03_31 ParsingNewParamsVersion = "2026-03-31"`
- `const ParsingNewParamsVersion2026_04_02 ParsingNewParamsVersion = "2026-04-02"`
- `const ParsingNewParamsVersion2026_04_06 ParsingNewParamsVersion = "2026-04-06"`
- `const ParsingNewParamsVersion2026_04_09 ParsingNewParamsVersion = "2026-04-09"`
- `const ParsingNewParamsVersion2026_04_14 ParsingNewParamsVersion = "2026-04-14"`
- `const ParsingNewParamsVersion2026_04_19 ParsingNewParamsVersion = "2026-04-19"`
- `const ParsingNewParamsVersion2026_04_22 ParsingNewParamsVersion = "2026-04-22"`
- `const ParsingNewParamsVersion2026_04_27 ParsingNewParamsVersion = "2026-04-27"`
- `const ParsingNewParamsVersionLatest ParsingNewParamsVersion = "latest"`
- `string`
- `OrganizationID param.Field[string]`
Query param
- `ProjectID param.Field[string]`
Query param
- `AgenticOptions param.Field[ParsingNewParamsAgenticOptions]`
Body param: Options for AI-powered parsing tiers (cost_effective, agentic, agentic_plus).
These options customize how the AI processes and interprets document content.
Only applicable when using non-fast tiers.
- `CustomPrompt string`
Custom instructions for the AI parser. Use to guide extraction behavior, specify output formatting, or provide domain-specific context. Example: 'Extract financial tables with currency symbols. Format dates as YYYY-MM-DD.'
- `ClientName param.Field[string]`
Body param: Identifier for the client/application making the request. Used for analytics and debugging. Example: 'my-app-v2'
- `CropBox param.Field[ParsingNewParamsCropBox]`
Body param: Crop boundaries to process only a portion of each page. Values are ratios 0-1 from page edges
- `Bottom float64`
Bottom boundary as ratio (0-1). 0=top edge, 1=bottom edge. Content below this line is excluded
- `Left float64`
Left boundary as ratio (0-1). 0=left edge, 1=right edge. Content left of this line is excluded
- `Right float64`
Right boundary as ratio (0-1). 0=left edge, 1=right edge. Content right of this line is excluded
- `Top float64`
Top boundary as ratio (0-1). 0=top edge, 1=bottom edge. Content above this line is excluded
- `DisableCache param.Field[bool]`
Body param: Bypass result caching and force re-parsing. Use when document content may have changed or you need fresh results
- `FastOptions param.Field[any]`
Body param: Options for fast tier parsing (rule-based, no AI).
Fast tier uses deterministic algorithms for text extraction without AI enhancement.
It's the fastest and most cost-effective option, best suited for simple documents
with standard layouts. Currently has no configurable options but reserved for
future expansion.
- `FileID param.Field[string]`
Body param: ID of an existing file in the project to parse. Mutually exclusive with source_url
- `HTTPProxy param.Field[string]`
Body param: HTTP/HTTPS proxy for fetching source_url. Ignored if using file_id
- `InputOptions param.Field[ParsingNewParamsInputOptions]`
Body param: Format-specific options (HTML, PDF, spreadsheet, presentation). Applied based on detected input file type
- `HTML ParsingNewParamsInputOptionsHTML`
HTML/web page parsing options (applies to .html, .htm files)
- `MakeAllElementsVisible bool`
Force all HTML elements to be visible by overriding CSS display/visibility properties. Useful for parsing pages with hidden content or collapsed sections
- `RemoveFixedElements bool`
Remove fixed-position elements (headers, footers, floating buttons) that appear on every page render
- `RemoveNavigationElements bool`
Remove navigation elements (nav bars, sidebars, menus) to focus on main content
- `Pdf any`
PDF-specific parsing options (applies to .pdf files)
- `Presentation ParsingNewParamsInputOptionsPresentation`
Presentation parsing options (applies to .pptx, .ppt, .odp, .key files)
- `OutOfBoundsContent bool`
Extract content positioned outside the visible slide area. Some presentations have hidden notes or content that extends beyond slide boundaries
- `SkipEmbeddedData bool`
Skip extraction of embedded chart data tables. When true, only the visual representation of charts is captured, not the underlying data
- `Spreadsheet ParsingNewParamsInputOptionsSpreadsheet`
Spreadsheet parsing options (applies to .xlsx, .xls, .csv, .ods files)
- `DetectSubTablesInSheets bool`
Detect and extract multiple tables within a single sheet. Useful when spreadsheets contain several data regions separated by blank rows/columns
- `ForceFormulaComputationInSheets bool`
Compute formula results instead of extracting formula text. Use when you need calculated values rather than formula definitions
- `IncludeHiddenSheets bool`
Parse hidden sheets in addition to visible ones. By default, hidden sheets are skipped
- `OutputOptions param.Field[ParsingNewParamsOutputOptions]`
Body param: Output formatting options for markdown, text, and extracted images
- `ExtractPrintedPageNumber bool`
Extract the printed page number as it appears in the document (e.g., 'Page 5 of 10', 'v', 'A-3'). Useful for referencing original page numbers
- `ImagesToSave []string`
Image categories to extract and save. Options: 'screenshot' (full page renders useful for visual QA), 'embedded' (images found within the document), 'layout' (cropped regions from layout detection like figures and diagrams). Empty list saves no images
- `const ParsingNewParamsOutputOptionsImagesToSaveScreenshot ParsingNewParamsOutputOptionsImagesToSave = "screenshot"`
- `const ParsingNewParamsOutputOptionsImagesToSaveEmbedded ParsingNewParamsOutputOptionsImagesToSave = "embedded"`
- `const ParsingNewParamsOutputOptionsImagesToSaveLayout ParsingNewParamsOutputOptionsImagesToSave = "layout"`
- `Markdown ParsingNewParamsOutputOptionsMarkdown`
Markdown formatting options including table styles and link annotations
- `AnnotateLinks bool`
Add link annotations to markdown output in the format [text](url). When false, only the link text is included
- `InlineImages bool`
Embed images directly in markdown as base64 data URIs instead of extracting them as separate files. Useful for self-contained markdown output
- `Tables ParsingNewParamsOutputOptionsMarkdownTables`
Table formatting options including markdown vs HTML format and merging behavior
- `CompactMarkdownTables bool`
Remove extra whitespace padding in markdown table cells for more compact output
- `MarkdownTableMultilineSeparator string`
Separator string for multiline cell content in markdown tables. Example: '
' to preserve line breaks, ' ' to join with spaces
- `MergeContinuedTables bool`
Automatically merge tables that span multiple pages into a single table. The merged table appears on the first page with merged_from_pages metadata
- `OutputTablesAsMarkdown bool`
Output tables as markdown pipe tables instead of HTML tags. Markdown tables are simpler but cannot represent complex structures like merged cells
- `SpatialText ParsingNewParamsOutputOptionsSpatialText`
Spatial text output options for preserving document layout structure
- `DoNotUnrollColumns bool`
Keep multi-column layouts intact instead of linearizing columns into sequential text. Automatically enabled for non-fast tiers
- `PreserveLayoutAlignmentAcrossPages bool`
Maintain consistent text column alignment across page boundaries. Automatically enabled for document-level parsing modes
- `PreserveVerySmallText bool`
Include text below the normal size threshold. Useful for footnotes, watermarks, or fine print that might otherwise be filtered out
- `TablesAsSpreadsheet ParsingNewParamsOutputOptionsTablesAsSpreadsheet`
Options for exporting tables as XLSX spreadsheets
- `Enable bool`
Whether this option is enabled
- `GuessSheetName bool`
Automatically generate descriptive sheet names from table context (headers, surrounding text) instead of using generic names like 'Table_1'
- `PageRanges param.Field[ParsingNewParamsPageRanges]`
Body param: Page selection: limit total pages or specify exact pages to process
- `MaxPages int64`
Maximum number of pages to process. Pages are processed in order starting from page 1. If both max_pages and target_pages are set, target_pages takes precedence
- `TargetPages string`
Comma-separated list of specific pages to process using 1-based indexing. Supports individual pages and ranges. Examples: '1,3,5' (pages 1, 3, 5), '1-5' (pages 1 through 5 inclusive), '1,3,5-8,10' (pages 1, 3, 5-8, and 10). Pages are sorted and deduplicated automatically. Duplicate pages cause an error
- `ProcessingControl param.Field[ParsingNewParamsProcessingControl]`
Body param: Job execution controls including timeouts and failure thresholds
- `JobFailureConditions ParsingNewParamsProcessingControlJobFailureConditions`
Quality thresholds that determine when a job should fail vs complete with partial results
- `AllowedPageFailureRatio float64`
Maximum ratio of pages allowed to fail before the job fails (0-1). Example: 0.1 means job fails if more than 10% of pages fail. Default is 0.05 (5%)
- `FailOnBuggyFont bool`
Fail the job if a problematic font is detected that may cause incorrect text extraction. Buggy fonts can produce garbled or missing characters
- `FailOnImageExtractionError bool`
Fail the entire job if any embedded image cannot be extracted. By default, image extraction errors are logged but don't fail the job
- `FailOnImageOcrError bool`
Fail the entire job if OCR fails on any image. By default, OCR errors result in empty text for that image
- `FailOnMarkdownReconstructionError bool`
Fail the entire job if markdown cannot be reconstructed for any page. By default, failed pages use fallback text extraction
- `Timeouts ParsingNewParamsProcessingControlTimeouts`
Timeout settings for job execution. Increase for large or complex documents
- `BaseInSeconds int64`
Base timeout for the job in seconds (max 1800 = 30 minutes). This is the minimum time allowed regardless of document size
- `ExtraTimePerPageInSeconds int64`
Additional timeout per page in seconds (max 300 = 5 minutes). Total timeout = base + (this value × page count)
- `ProcessingOptions param.Field[ParsingNewParamsProcessingOptions]`
Body param: Document processing options including OCR, table extraction, and chart parsing
- `AggressiveTableExtraction bool`
Use aggressive heuristics to detect table boundaries, even without visible borders. Useful for documents with borderless or complex tables
- `AutoModeConfiguration []ParsingNewParamsProcessingOptionsAutoModeConfiguration`
Conditional processing rules that apply different parsing options based on page content, document structure, or filename patterns. Each entry defines trigger conditions and the parsing configuration to apply when triggered
- `ParsingConf ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConf`
Parsing configuration to apply when trigger conditions are met
- `AdaptiveLongTable bool`
Whether to use adaptive long table handling
- `AggressiveTableExtraction bool`
Whether to use aggressive table extraction
- `CropBox ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfCropBox`
Crop box options for auto mode parsing configuration.
- `Bottom float64`
Bottom boundary of crop box as ratio (0-1)
- `Left float64`
Left boundary of crop box as ratio (0-1)
- `Right float64`
Right boundary of crop box as ratio (0-1)
- `Top float64`
Top boundary of crop box as ratio (0-1)
- `CustomPrompt string`
Custom AI instructions for matched pages. Overrides the base custom_prompt
- `ExtractLayout bool`
Whether to extract layout information
- `HighResOcr bool`
Whether to use high resolution OCR
- `Ignore ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfIgnore`
Ignore options for auto mode parsing configuration.
- `IgnoreDiagonalText bool`
Whether to ignore diagonal text in the document
- `IgnoreHiddenText bool`
Whether to ignore hidden text in the document
- `Language string`
Primary language of the document
- `OutlinedTableExtraction bool`
Whether to use outlined table extraction
- `Presentation ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfPresentation`
Presentation-specific options for auto mode parsing configuration.
- `OutOfBoundsContent bool`
Extract out of bounds content in presentation slides
- `SkipEmbeddedData bool`
Skip extraction of embedded data for charts in presentation slides
- `SpatialText ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfSpatialText`
Spatial text options for auto mode parsing configuration.
- `DoNotUnrollColumns bool`
Keep column structure intact without unrolling
- `PreserveLayoutAlignmentAcrossPages bool`
Preserve text alignment across page boundaries
- `PreserveVerySmallText bool`
Include very small text in spatial output
- `SpecializedChartParsing string`
Enable specialized chart parsing with the specified mode
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfSpecializedChartParsingAgenticPlus ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfSpecializedChartParsing = "agentic_plus"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfSpecializedChartParsingAgentic ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfSpecializedChartParsing = "agentic"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfSpecializedChartParsingEfficient ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfSpecializedChartParsing = "efficient"`
- `Tier string`
Override the parsing tier for matched pages. Must be paired with version
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfTierFast ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfTier = "fast"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfTierCostEffective ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfTier = "cost_effective"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfTierAgentic ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfTier = "agentic"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfTierAgenticPlus ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfTier = "agentic_plus"`
- `Version string`
Tier version when overriding tier. Required when tier is specified
- `string`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2025_12_11 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2025-12-11"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2025_12_18 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2025-12-18"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2025_12_31 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2025-12-31"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_01_08 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-01-08"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_01_09 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-01-09"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_01_16 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-01-16"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_01_21 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-01-21"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_01_22 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-01-22"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_01_24 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-01-24"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_01_29 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-01-29"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_01_30 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-01-30"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_02_03 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-02-03"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_02_18 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-02-18"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_02_20 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-02-20"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_02_24 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-02-24"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_02_26 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-02-26"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_02 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-02"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_03 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-03"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_04 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-04"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_05 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-05"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_09 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-09"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_10 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-10"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_11 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-11"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_12 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-12"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_17 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-17"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_19 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-19"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_20 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-20"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_22 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-22"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_23 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-23"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_24 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-24"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_25 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-25"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_26 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-26"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_27 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-27"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_30 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-30"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_03_31 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-03-31"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_04_02 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-04-02"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_04_06 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-04-06"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_04_09 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-04-09"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_04_14 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-04-14"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_04_19 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-04-19"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_04_22 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-04-22"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion2026_04_27 ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "2026-04-27"`
- `const ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersionLatest ParsingNewParamsProcessingOptionsAutoModeConfigurationParsingConfVersion = "latest"`
- `string`
- `FilenameMatchGlob string`
Single glob pattern to match against filename
- `FilenameMatchGlobList []string`
List of glob patterns to match against filename
- `FilenameRegexp string`
Regex pattern to match against filename
- `FilenameRegexpMode string`
Regex mode flags (e.g., 'i' for case-insensitive)
- `FullPageImageInPage bool`
Trigger if page contains a full-page image (scanned page detection)
- `FullPageImageInPageThreshold ParsingNewParamsProcessingOptionsAutoModeConfigurationFullPageImageInPageThresholdUnion`
Threshold for full page image detection (0.0-1.0, default 0.8)
- `float64`
- `string`
- `ImageInPage bool`
Trigger if page contains non-screenshot images
- `LayoutElementInPage string`
Trigger if page contains this layout element type
- `LayoutElementInPageConfidenceThreshold ParsingNewParamsProcessingOptionsAutoModeConfigurationLayoutElementInPageConfidenceThresholdUnion`
Confidence threshold for layout element detection
- `float64`
- `string`
- `PageContainsAtLeastNCharts ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtLeastNChartsUnion`
Trigger if page has more than N charts
- `int64`
- `string`
- `PageContainsAtLeastNImages ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtLeastNImagesUnion`
Trigger if page has more than N images
- `int64`
- `string`
- `PageContainsAtLeastNLayoutElements ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtLeastNLayoutElementsUnion`
Trigger if page has more than N layout elements
- `int64`
- `string`
- `PageContainsAtLeastNLines ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtLeastNLinesUnion`
Trigger if page has more than N lines
- `int64`
- `string`
- `PageContainsAtLeastNLinks ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtLeastNLinksUnion`
Trigger if page has more than N links
- `int64`
- `string`
- `PageContainsAtLeastNNumbers ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtLeastNNumbersUnion`
Trigger if page has more than N numeric words
- `int64`
- `string`
- `PageContainsAtLeastNPercentNumbers ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtLeastNPercentNumbersUnion`
Trigger if page has more than N% numeric words
- `int64`
- `string`
- `PageContainsAtLeastNTables ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtLeastNTablesUnion`
Trigger if page has more than N tables
- `int64`
- `string`
- `PageContainsAtLeastNWords ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtLeastNWordsUnion`
Trigger if page has more than N words
- `int64`
- `string`
- `PageContainsAtMostNCharts ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtMostNChartsUnion`
Trigger if page has fewer than N charts
- `int64`
- `string`
- `PageContainsAtMostNImages ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtMostNImagesUnion`
Trigger if page has fewer than N images
- `int64`
- `string`
- `PageContainsAtMostNLayoutElements ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtMostNLayoutElementsUnion`
Trigger if page has fewer than N layout elements
- `int64`
- `string`
- `PageContainsAtMostNLines ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtMostNLinesUnion`
Trigger if page has fewer than N lines
- `int64`
- `string`
- `PageContainsAtMostNLinks ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtMostNLinksUnion`
Trigger if page has fewer than N links
- `int64`
- `string`
- `PageContainsAtMostNNumbers ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtMostNNumbersUnion`
Trigger if page has fewer than N numeric words
- `int64`
- `string`
- `PageContainsAtMostNPercentNumbers ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtMostNPercentNumbersUnion`
Trigger if page has fewer than N% numeric words
- `int64`
- `string`
- `PageContainsAtMostNTables ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtMostNTablesUnion`
Trigger if page has fewer than N tables
- `int64`
- `string`
- `PageContainsAtMostNWords ParsingNewParamsProcessingOptionsAutoModeConfigurationPageContainsAtMostNWordsUnion`
Trigger if page has fewer than N words
- `int64`
- `string`
- `PageLongerThanNChars ParsingNewParamsProcessingOptionsAutoModeConfigurationPageLongerThanNCharsUnion`
Trigger if page has more than N characters
- `int64`
- `string`
- `PageMdError bool`
Trigger on pages with markdown extraction errors
- `PageShorterThanNChars ParsingNewParamsProcessingOptionsAutoModeConfigurationPageShorterThanNCharsUnion`
Trigger if page has fewer than N characters
- `int64`
- `string`
- `RegexpInPage string`
Regex pattern to match in page content
- `RegexpInPageMode string`
Regex mode flags for regexp_in_page
- `TableInPage bool`
Trigger if page contains a table
- `TextInPage string`
Trigger if page text/markdown contains this string
- `TriggerMode string`
How to combine multiple trigger conditions: 'and' (all conditions must match, this is the default) or 'or' (any single condition can trigger)
- `CostOptimizer ParsingNewParamsProcessingOptionsCostOptimizer`
Cost optimizer configuration for reducing parsing costs on simpler pages.
When enabled, the parser analyzes each page and routes simpler pages to faster,
cheaper processing while preserving quality for complex pages. Only works with
'agentic' or 'agentic_plus' tiers.
- `Enable bool`
Enable cost-optimized parsing. Routes simpler pages to faster processing while complex pages use full AI analysis. May reduce speed on some documents. IMPORTANT: Only available with 'agentic' or 'agentic_plus' tiers
- `DisableHeuristics bool`
Disable automatic heuristics including outlined table extraction and adaptive long table handling. Use when heuristics produce incorrect results
- `Ignore ParsingNewParamsProcessingOptionsIgnore`
Options for ignoring specific text types (diagonal, hidden, text in images)
- `IgnoreDiagonalText bool`
Skip text rotated at an angle (not horizontal/vertical). Useful for ignoring watermarks or decorative angled text
- `IgnoreHiddenText bool`
Skip text marked as hidden in the document structure. Some PDFs contain invisible text layers used for accessibility or search indexing
- `IgnoreTextInImage bool`
Skip OCR text extraction from embedded images. Use when images contain irrelevant text (watermarks, logos) that shouldn't be in the output
- `OcrParameters ParsingNewParamsProcessingOptionsOcrParameters`
OCR configuration including language detection settings
- `Languages []ParsingLanguages`
Languages to use for OCR text recognition. Specify multiple languages if document contains mixed-language content. Order matters - put primary language first. Example: ['en', 'es'] for English with Spanish
- `const ParsingLanguagesAf ParsingLanguages = "af"`
- `const ParsingLanguagesAz ParsingLanguages = "az"`
- `const ParsingLanguagesBs ParsingLanguages = "bs"`
- `const ParsingLanguagesCs ParsingLanguages = "cs"`
- `const ParsingLanguagesCy ParsingLanguages = "cy"`
- `const ParsingLanguagesDa ParsingLanguages = "da"`
- `const ParsingLanguagesDe ParsingLanguages = "de"`
- `const ParsingLanguagesEn ParsingLanguages = "en"`
- `const ParsingLanguagesEs ParsingLanguages = "es"`
- `const ParsingLanguagesEt ParsingLanguages = "et"`
- `const ParsingLanguagesFr ParsingLanguages = "fr"`
- `const ParsingLanguagesGa ParsingLanguages = "ga"`
- `const ParsingLanguagesHr ParsingLanguages = "hr"`
- `const ParsingLanguagesHu ParsingLanguages = "hu"`
- `const ParsingLanguagesID ParsingLanguages = "id"`
- `const ParsingLanguagesIs ParsingLanguages = "is"`
- `const ParsingLanguagesIt ParsingLanguages = "it"`
- `const ParsingLanguagesKu ParsingLanguages = "ku"`
- `const ParsingLanguagesLa ParsingLanguages = "la"`
- `const ParsingLanguagesLt ParsingLanguages = "lt"`
- `const ParsingLanguagesLv ParsingLanguages = "lv"`
- `const ParsingLanguagesMi ParsingLanguages = "mi"`
- `const ParsingLanguagesMs ParsingLanguages = "ms"`
- `const ParsingLanguagesMt ParsingLanguages = "mt"`
- `const ParsingLanguagesNl ParsingLanguages = "nl"`
- `const ParsingLanguagesNo ParsingLanguages = "no"`
- `const ParsingLanguagesOc ParsingLanguages = "oc"`
- `const ParsingLanguagesPi ParsingLanguages = "pi"`
- `const ParsingLanguagesPl ParsingLanguages = "pl"`
- `const ParsingLanguagesPt ParsingLanguages = "pt"`
- `const ParsingLanguagesRo ParsingLanguages = "ro"`
- `const ParsingLanguagesRsLatin ParsingLanguages = "rs_latin"`
- `const ParsingLanguagesSk ParsingLanguages = "sk"`
- `const ParsingLanguagesSl ParsingLanguages = "sl"`
- `const ParsingLanguagesSq ParsingLanguages = "sq"`
- `const ParsingLanguagesSv ParsingLanguages = "sv"`
- `const ParsingLanguagesSw ParsingLanguages = "sw"`
- `const ParsingLanguagesTl ParsingLanguages = "tl"`
- `const ParsingLanguagesTr ParsingLanguages = "tr"`
- `const ParsingLanguagesUz ParsingLanguages = "uz"`
- `const ParsingLanguagesVi ParsingLanguages = "vi"`
- `const ParsingLanguagesAr ParsingLanguages = "ar"`
- `const ParsingLanguagesFa ParsingLanguages = "fa"`
- `const ParsingLanguagesUg ParsingLanguages = "ug"`
- `const ParsingLanguagesUr ParsingLanguages = "ur"`
- `const ParsingLanguagesBn ParsingLanguages = "bn"`
- `const ParsingLanguagesAs ParsingLanguages = "as"`
- `const ParsingLanguagesMni ParsingLanguages = "mni"`
- `const ParsingLanguagesRu ParsingLanguages = "ru"`
- `const ParsingLanguagesRsCyrillic ParsingLanguages = "rs_cyrillic"`
- `const ParsingLanguagesBe ParsingLanguages = "be"`
- `const ParsingLanguagesBg ParsingLanguages = "bg"`
- `const ParsingLanguagesUk ParsingLanguages = "uk"`
- `const ParsingLanguagesMn ParsingLanguages = "mn"`
- `const ParsingLanguagesAbq ParsingLanguages = "abq"`
- `const ParsingLanguagesAdy ParsingLanguages = "ady"`
- `const ParsingLanguagesKbd ParsingLanguages = "kbd"`
- `const ParsingLanguagesAva ParsingLanguages = "ava"`
- `const ParsingLanguagesDar ParsingLanguages = "dar"`
- `const ParsingLanguagesInh ParsingLanguages = "inh"`
- `const ParsingLanguagesChe ParsingLanguages = "che"`
- `const ParsingLanguagesLbe ParsingLanguages = "lbe"`
- `const ParsingLanguagesLez ParsingLanguages = "lez"`
- `const ParsingLanguagesTab ParsingLanguages = "tab"`
- `const ParsingLanguagesTjk ParsingLanguages = "tjk"`
- `const ParsingLanguagesHi ParsingLanguages = "hi"`
- `const ParsingLanguagesMr ParsingLanguages = "mr"`
- `const ParsingLanguagesNe ParsingLanguages = "ne"`
- `const ParsingLanguagesBh ParsingLanguages = "bh"`
- `const ParsingLanguagesMai ParsingLanguages = "mai"`
- `const ParsingLanguagesAng ParsingLanguages = "ang"`
- `const ParsingLanguagesBho ParsingLanguages = "bho"`
- `const ParsingLanguagesMah ParsingLanguages = "mah"`
- `const ParsingLanguagesSck ParsingLanguages = "sck"`
- `const ParsingLanguagesNew ParsingLanguages = "new"`
- `const ParsingLanguagesGom ParsingLanguages = "gom"`
- `const ParsingLanguagesSa ParsingLanguages = "sa"`
- `const ParsingLanguagesBgc ParsingLanguages = "bgc"`
- `const ParsingLanguagesTh ParsingLanguages = "th"`
- `const ParsingLanguagesChSim ParsingLanguages = "ch_sim"`
- `const ParsingLanguagesChTra ParsingLanguages = "ch_tra"`
- `const ParsingLanguagesJa ParsingLanguages = "ja"`
- `const ParsingLanguagesKo ParsingLanguages = "ko"`
- `const ParsingLanguagesTa ParsingLanguages = "ta"`
- `const ParsingLanguagesTe ParsingLanguages = "te"`
- `const ParsingLanguagesKn ParsingLanguages = "kn"`
- `SpecializedChartParsing string`
Enable AI-powered chart analysis. Modes: 'efficient' (fast, lower cost), 'agentic' (balanced), 'agentic_plus' (highest accuracy). Automatically enables extract_layout and precise_bounding_box when set
- `const ParsingNewParamsProcessingOptionsSpecializedChartParsingAgenticPlus ParsingNewParamsProcessingOptionsSpecializedChartParsing = "agentic_plus"`
- `const ParsingNewParamsProcessingOptionsSpecializedChartParsingAgentic ParsingNewParamsProcessingOptionsSpecializedChartParsing = "agentic"`
- `const ParsingNewParamsProcessingOptionsSpecializedChartParsingEfficient ParsingNewParamsProcessingOptionsSpecializedChartParsing = "efficient"`
- `SourceURL param.Field[string]`
Body param: Public URL of the document to parse. Mutually exclusive with file_id
- `WebhookConfigurations param.Field[[]ParsingNewParamsWebhookConfiguration]`
Body param: Webhook endpoints for job status notifications. Multiple webhooks can be configured for different events or services
- `WebhookEvents []string`
Events that trigger this webhook. Options: 'parse.success' (job completed), 'parse.failure' (job failed), 'parse.partial' (some pages failed). If not specified, webhook fires for all events
- `WebhookHeaders map[string, any]`
Custom HTTP headers to include in webhook requests. Use for authentication tokens or custom routing. Example: {'Authorization': 'Bearer xyz'}
- `WebhookURL string`
HTTPS URL to receive webhook POST requests. Must be publicly accessible
### Returns
- `type ParsingNewResponse struct{…}`
A parse job.
- `ID string`
Unique parse job identifier
- `ProjectID string`
Project this job belongs to
- `Status ParsingNewResponseStatus`
Current job status: PENDING, RUNNING, COMPLETED, FAILED, or CANCELLED
- `const ParsingNewResponseStatusPending ParsingNewResponseStatus = "PENDING"`
- `const ParsingNewResponseStatusRunning ParsingNewResponseStatus = "RUNNING"`
- `const ParsingNewResponseStatusCompleted ParsingNewResponseStatus = "COMPLETED"`
- `const ParsingNewResponseStatusFailed ParsingNewResponseStatus = "FAILED"`
- `const ParsingNewResponseStatusCancelled ParsingNewResponseStatus = "CANCELLED"`
- `CreatedAt Time`
Creation datetime
- `ErrorMessage string`
Error details when status is FAILED
- `Name string`
Optional display name for this parse job
- `Tier string`
Parsing tier used for this job
- `UpdatedAt Time`
Update datetime
### Example
```go
package main
import (
"context"
"fmt"
"github.com/stainless-sdks/llamacloud-prod-go"
"github.com/stainless-sdks/llamacloud-prod-go/option"
)
func main() {
client := llamacloudprod.NewClient(
option.WithAPIKey("My API Key"),
)
parsing, err := client.Parsing.New(context.TODO(), llamacloudprod.ParsingNewParams{
Tier: llamacloudprod.ParsingNewParamsTierFast,
Version: llamacloudprod.ParsingNewParamsVersion2025_12_11,
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", parsing.ID)
}
```
#### Response
```json
{
"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"
}
```