openapi: 3.0.3
info:
title: Reducto Cancel Parse API
description: REST API for parsing, extracting, splitting, classifying, and editing complex documents. Supports PDFs, Word files, spreadsheets, presentations, and scanned images using layout-aware OCR and vision language models.
version: v1.11.80-78-gc5c4ff11c
contact:
url: https://reducto.ai/
email: support@reducto.ai
license:
name: Proprietary
servers:
- url: https://platform.reducto.ai
security:
- BearerAuth: []
tags:
- name: Parse
paths:
/parse:
post:
summary: Parse
operationId: parse_parse_post
requestBody:
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/SyncParseConfig'
- $ref: '#/components/schemas/AsyncParseConfig'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/ParseResponse'
- $ref: '#/components/schemas/AsyncParseResponse'
title: Response Parse Parse Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Parse
components:
schemas:
FullResult:
properties:
type:
type: string
title: Type
description: type = 'full'
enum:
- full
chunks:
items:
$ref: '#/components/schemas/ParseChunk'
type: array
title: Chunks
ocr:
$ref: '#/components/schemas/OCRResult'
nullable: true
custom:
nullable: true
title: Custom
type: object
required:
- type
- chunks
title: FullResult
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
Chunking:
properties:
chunk_mode:
type: string
enum:
- variable
- section
- page
- disabled
- block
- page_sections
title: Chunk Mode
description: Choose how to partition chunks. Variable mode chunks by character length and visual context. Section mode chunks by section headers. Page mode chunks according to pages. Page sections mode chunks first by page, then by sections within each page. Disabled returns one single chunk.
default: disabled
chunk_size:
type: integer
nullable: true
title: Chunk Size
description: The approximate size of chunks (in characters) that the document will be split into. Defaults to null, in which case the chunk size is variable between 250 - 1500 characters.
chunk_overlap:
type: integer
title: Chunk Overlap
description: Number of characters of overlap to include from adjacent chunks. Defaults to 0.
default: 0
type: object
title: Chunking
TenantThrottling:
properties:
tenant_id:
type: string
maxLength: 256
minLength: 1
title: Tenant Id
description: Your identifier for the tenant (customer, workspace, organization) this request belongs to. Used only for noisy-neighbor throttling inside your account.
max_share:
type: number
maximum: 1
title: Max Share
description: Maximum fraction of your account's concurrency ceiling this tenant may use, between 0 (exclusive) and 1. Defaults to 0.5.
default: 0.5
minimum: 0
exclusiveMinimum: true
type: object
required:
- tenant_id
title: TenantThrottling
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ParseUsage:
properties:
num_pages:
type: integer
title: Num Pages
credits:
type: number
nullable: true
title: Credits
credit_breakdown:
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
nullable: true
title: Credit Breakdown
page_billing_breakdown:
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
nullable: true
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:
type: integer
nullable: true
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
ParseBlock:
properties:
type:
type: string
enum:
- Header
- Footer
- Title
- Section Header
- Page Number
- List Item
- Figure
- Table
- Key Value
- Text
- Comment
- Signature
title: Type
description: The type of block extracted from the document.
bbox:
$ref: '#/components/schemas/BoundingBox'
description: The bounding box of the block extracted from the document.
content:
type: string
title: Content
description: The content of the block extracted from the document.
image_url:
type: string
nullable: true
title: Image Url
description: (Experimental) The URL of the image associated with the block.
chart_data:
items:
type: string
type: array
nullable: true
title: Chart Data
description: (Experimental) The URL/link to chart data JSON for figure blocks processed by chart agent.
confidence:
type: string
nullable: true
title: Confidence
description: The confidence for the block. It is either low or high and takes into account factors like OCR and table structure
default: low
granular_confidence:
$ref: '#/components/schemas/GranularConfidence'
nullable: true
description: Granular confidence scores for the block. It is a dictionary of confidence scores for the block. The confidence scores will not be None if the user has enabled numeric confidence scores.
extra:
additionalProperties: true
type: object
nullable: true
title: Extra
description: Extra metadata fields for the block. Fields like 'is_chart' will only appear when set to True.
type: object
required:
- type
- bbox
- content
title: ParseBlock
SyncParseConfig:
properties:
input:
anyOf:
- type: string
- items:
type: string
type: array
- $ref: '#/components/schemas/UploadResponse'
title: Input
description: "For parse/split/extract pipelines, the URL of the document to be processed. You can provide one of the following:\n 1. A publicly available URL\n 2. A presigned S3 URL\n 3. A reducto:// prefixed URL obtained from the /upload endpoint after directly uploading a document\n 4. A jobid:// prefixed URL obtained from a previous /parse invocation\n 5. A list of URLs (for multi-document pipelines, V3 API only)\n\n For edit pipelines, this should be a string containing the edit instructions "
enhance:
$ref: '#/components/schemas/Enhance'
default:
agentic: []
summarize_figures: true
intelligent_ordering: false
retrieval:
$ref: '#/components/schemas/Retrieval'
default:
chunking:
chunk_mode: disabled
chunk_overlap: 0
filter_blocks: []
embedding_optimized: false
formatting:
$ref: '#/components/schemas/Formatting'
default:
add_page_markers: false
table_output_format: dynamic
merge_tables: false
include: []
spreadsheet:
$ref: '#/components/schemas/Spreadsheet'
default:
split_large_tables:
enabled: true
size: 50
include: []
clustering: accurate
exclude: []
settings:
$ref: '#/components/schemas/Settings'
default:
ocr_system: standard
extraction_mode: hybrid
force_url_result: false
return_ocr_data: false
return_images: []
embed_pdf_metadata: false
embed_pdf_metadata_dpi: 100
persist_results: false
hybrid_vpc: {}
type: object
required:
- input
title: SyncParseConfig
AsyncParseResponse:
properties:
job_id:
type: string
title: Job Id
type: object
required:
- job_id
title: AsyncParseResponse
Formatting:
properties:
add_page_markers:
type: boolean
title: Add Page Markers
description: If True, add page markers to the output. Defaults to False. Useful for extracting data with page specific information.
default: false
table_output_format:
type: string
enum:
- html
- json
- md
- jsonbbox
- dynamic
- csv
title: Table Output Format
description: The mode to use for table output. Defaults to dynamic, which returns md for simpler tables and html for more complex tables.
default: dynamic
merge_tables:
type: boolean
title: Merge Tables
description: A flag to indicate if consecutive tables with the same number of columns should be merged. Defaults to False.
default: false
include:
items:
type: string
enum:
- change_tracking
- highlight
- comments
- hyperlinks
- signatures
- ignore_watermarks
type: array
title: Include
description: A list of formatting to include in the output.
default: []
type: object
title: Formatting
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
UrlResult:
properties:
type:
type: string
title: Type
description: type = 'url'
enum:
- url
url:
type: string
title: Url
result_id:
type: string
title: Result Id
type: object
required:
- type
- url
- result_id
title: UrlResult
UploadResponse:
properties:
file_id:
type: string
title: File Id
presigned_url:
type: string
nullable: true
title: Presigned Url
type: object
required:
- file_id
title: UploadResponse
ParseResponse:
properties:
response_type:
type: string
title: Response Type
default: parse
enum:
- parse
job_id:
type: string
title: Job Id
duration:
type: number
title: Duration
description: The duration of the parse request in seconds.
pdf_url:
type: string
nullable: true
title: Pdf Url
description: The storage URL of the converted PDF file.
studio_link:
type: string
nullable: true
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:
type: string
enum:
- base
- lite
nullable: true
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
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:
type: string
nullable: true
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
SplitLargeTables:
properties:
enabled:
type: boolean
title: Enabled
description: If True, split large tables into smaller tables. Defaults to True.
default: true
size:
anyOf:
- type: integer
- $ref: '#/components/schemas/SplitLargeTableSizes'
title: Size
description: The size of the tables to split into. Defaults to 50. Use 'row' and 'column' to independently specify the number of rows and columns to include when splitting. If you only want to split by rows or columns, set the other value to None.
default: 50
type: object
title: SplitLargeTables
Enhance:
properties:
agentic:
items:
anyOf:
- $ref: '#/components/schemas/TableAgentic'
- $ref: '#/components/schemas/FigureAgentic'
- $ref: '#/components/schemas/TextAgentic'
type: array
title: Agentic
description: Agentic uses vision language models to enhance the accuracy of the output of different types of extraction. This will incur a cost and latency increase.
default: []
summarize_figures:
type: boolean
title: Summarize Figures
description: If True, summarize figures using a small vision language model. Defaults to True.
default: true
intelligent_ordering:
type: boolean
title: Intelligent Ordering
description: If True, use an advanced vision language model to improve reading order accuracy, with a small increase in latency. Defaults to False.
default: false
type: object
title: Enhance
FigureAgentic:
properties:
scope:
type: string
title: Scope
enum:
- figure
prompt:
type: string
nullable: true
title: Prompt
description: Custom prompt for figure agentic.
advanced_chart_agent:
type: boolean
title: Advanced Chart Agent
description: If True, use the advanced chart agent. Defaults to False.
default: false
return_overlays:
type: boolean
title: Return Overlays
description: If True, return overlays for the figure. This is so you can use the overlays to double check the quality of the extraction
default: false
type: object
required:
- scope
title: FigureAgentic
HybridVpcSettings:
properties:
environment:
type: string
nullable: true
title: Environment
description: Named Hybrid VPC environment to use for this request. Only applies when your organization has Hybrid VPC environments configured.
type: object
title: HybridVpcSettings
SplitLargeTableSizes:
properties:
row:
type: integer
nullable: true
title: Row
description: The number of rows to include in each chunk when splitting large tables. Does not chunk rows if set to None.
column:
type: integer
nullable: true
title: Column
description: The number of columns to include in each chunk when splitting large tables. Does not chunk columns if set to None.
type: object
title: SplitLargeTableSizes
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
TextAgentic:
properties:
scope:
type: string
title: Scope
enum:
- text
prompt:
type: string
nullable: true
title: Prompt
description: 'Custom instructions for agentic text. Note: This only applies to form regions (key-value).'
type: object
required:
- scope
title: TextAgentic
AsyncParseConfig:
properties:
async:
$ref: '#/components/schemas/config__v3__AsyncConfig'
description: The configuration options for asynchronous processing (default synchronous).
default:
priority: false
input:
anyOf:
- type: string
- items:
type: string
type: array
- $ref: '#/components/schemas/UploadResponse'
title: Input
description: "For parse/split/extract pipelines, the URL of the document to be processed. You can provide one of the following:\n 1. A publicly available URL\n 2. A presigned S3 URL\n 3. A reducto:// prefixed URL obtained from the /upload endpoint after directly uploading a document\n 4. A jobid:// prefixed URL obtained from a previous /parse invocation\n 5. A list of URLs (for multi-document pipelines, V3 API only)\n\n For edit pipelines, this should be a string containing the edit instructions "
enhance:
$ref: '#/components/schemas/Enhance'
default:
agentic: []
summarize_figures: true
intelligent_ordering: false
retrieval:
$ref: '#/components/schemas/Retrieval'
default:
chunking:
chunk_mode: disabled
chunk_overlap: 0
filter_blocks: []
embedding_optimized: false
formatting:
$ref: '#/components/schemas/Formatting'
default:
add_page_markers: false
table_output_format: dynamic
merge_tables: false
include: []
spreadsheet:
$ref: '#/components/schemas/Spreadsheet'
default:
split_large_tables:
enabled: true
size: 50
include: []
clustering: accurate
exclude: []
settings:
$ref: '#/components/schemas/Settings'
default:
ocr_system: standard
extraction_mode: hybrid
force_url_result: false
return_ocr_data: false
return_images: []
embed_pdf_metadata: false
embed_pdf_metadata_dpi: 100
persist_results: false
hybrid_vpc: {}
queue_priority:
$ref: '#/components/schemas/QueuePriority'
description: 'Queue priority. ''batch'' for non-urgent work that processes when spare GPU capacity is available. ''auto'' (alias: ''standard'') uses the default queue.'
default: auto
type: object
required:
- input
title: AsyncParseConfig
OCRWord:
properties:
text:
type: string
title: Text
bbox:
$ref: '#/components/schemas/BoundingBox'
confidence:
type: number
nullable: true
title: Confidence
description: OCR confidence score between 0 and 1, where 1 indicates highest confidence
chunk_index:
type: integer
nullable: true
title: Chunk Index
description: The index of the chunk that the word belongs to.
rotation:
type: integer
nullable: true
title: Rotation
description: The rotation angle in degrees, from 0 to 360, counterclockwise.
type: object
required:
- text
- bbox
title: OCRWord
Retrieval:
properties:
chunking:
$ref: '#/components/schemas/Chunking'
default:
chunk_mode: disabled
chunk_overlap: 0
filter_blocks:
items:
type: string
enum:
- Header
- Footer
- Title
- Section Header
- Page Number
- List Item
- Figure
- Table
- Key Value
- Text
- Comment
- Signature
type: array
title: Filter Blocks
description: A list of block types to filter out from 'content' and 'embed' fields. By default, no blocks are filtered.
default: []
embedding_optimized:
type: boolean
title: Embedding Optimized
description: If True, use embedding optimized mode. Defaults to False.
default: false
type: object
title: Retrieval
PageRange:
properties:
start:
type: integer
nullable: true
title: Start
description: The page number to start processing from (1-indexed).
end:
type: integer
nullable: true
title: End
description: The page number to stop processing at (1-indexed).
type: object
title: PageRange
config__v3__AsyncConfig:
properties:
metadata:
title: Metadata
description: JSON metadata included in webhook request body. Defaults to None.
priority:
type: boolean
title: Priority
description: If True, attempts to process the job with priority if the user has priority processing budget available; by default, sync jobs are prioritized above async jobs.
default: false
webhook:
anyOf:
- $ref: '#/components/schemas/SvixWebhookConfig'
- $ref: '#/components/schemas/DirectWebhookConfig'
title: Webhook
description: The webhook configuration for the asynchronous processing.
nullable: true
type: object
title: AsyncConfig
Settings:
properties:
ocr_system:
type: string
enum:
- standard
- legacy
title: Ocr System
description: Standard is our best multilingual OCR system. Legacy only supports germanic languages and is available for backwards compatibility.
default: standard
extraction_mode:
type: string
enum:
- ocr
- hybrid
title: Extraction Mode
description: The mode to use for text extraction from PDFs. OCR mode uses optical character recognition only. Hybrid mode combines OCR with embedded PDF text for best accuracy (default).
default: hybrid
force_url_result:
type: boolean
title: Force Url Result
description: Force the result to be returned in URL form.
default: false
force_file_extension:
type: string
nullable: true
title: Force File Extension
description: Force the URL to be downloaded as a specific file extension (e.g. `.png`).
return_ocr_data:
type: boolean
title: Return Ocr Data
description: If True, return OCR data in the result. Defaults to False.
default: false
return_images:
items:
type: string
enum:
- figure
- table
- page
type: array
title: Return Images
description: Whether to return images for the specified block types. 'page' returns full page images. By default, no images are returned.
default: []
embed_pdf_metadata:
type: boolean
title: Embed Pdf Metadata
description: If True, embed OCR metadata into the returned PDF. Defaults to False.
default: false
embed_pdf_metadata_dpi:
type: integer
maximum: 250
minimum: 50
title: Embed Pdf Metadata Dpi
description: Render DPI used when rasterizing the source PDF before embedding the OCR text layer (only applies when ``embed_pdf_metadata`` is True). Lower values produce dramatically smaller output PDFs; higher values preserve more detail when zoomed past 200%. Defaults to 100 (good for on-screen viewing); raise toward the source scan DPI for crisper output. Min 50, max 250.
default: 100
persist_results:
type: boolean
title: Persist Results
description: If True, persist the results indefinitely. Defaults to False.
default: false
tenant_throttling:
$ref: '#/components/schemas/TenantThrottling'
nullable: true
description: Per-tenant throttling for multi-tenant applications. Tag each request with your tenant's id to bound how much of your account's concurrency a single tenant can consume. Account-level throttles still apply.
timeout:
type: number
nullable: true
title: Timeout
description: The timeout for the job in seconds.
page_range:
anyOf:
- $ref: '#/components/schemas/PageRange'
- items:
$ref: '#/components/schemas/PageRange'
type: array
- items:
type: integer
type: array
- items:
type: string
type: array
title: Page Range
description: The page range to process (1-indexed). By default, the entire document is processed. For spreadsheets, you can also provide a list of sheet names.
nullable: true
document_password:
type: string
nullable: true
title: Document Password
description: Password to decrypt password-protected documents.
hybrid_vpc:
$ref: '#/components/schemas/HybridVpcSettings'
description: Hybrid VPC request-scoped settings.
default: {}
type: object
title: Settings
DirectWebhookConfig:
properties:
mode:
type: string
title: Mode
default: direct
enum:
- direct
url:
type: string
title: Url
type: object
required:
- url
title: DirectWebhookConfig
GranularConfidence:
properties:
extract_confidence:
type: number
nullable: true
title: Extract Confidence
parse_confidence:
type: number
nullable: true
title: Parse Confidence
type: object
title: GranularConfidence
TableAgentic:
properties:
scope:
type: string
title: Scope
enum:
- table
prompt:
type: string
nullable: true
title: Prompt
description: Custom prompt for table agentic.
mode:
type: string
enum:
- default
- auto
- max
title: Mode
description: 'Mode for table agentic: ''default'' selectively applies enrichment only to tables likely to benefit, and ''max'' runs enrichment on all tables.'
default: default
type: object
required:
- scope
title: TableAgentic
Spreadsheet:
properties:
split_large_tables:
$ref: '#/components/schemas/SplitLargeTables'
default:
enabled: true
size: 50
include:
items:
type: string
enum:
- cell_colors
- formula
- dropdowns
type: array
title: Include
description: Whether to include cell color, formula, and dropdown information in the output.
default: []
clustering:
type: string
enum:
- accurate
- fast
- disabled
title: Clustering
description: In a spreadsheet with different tables inside, we enable splitting up the tables by default. Accurate mode applies more powerful models for superior accuracy, at 5× the default per-cell rate. Disabling will register as one large table.
default: accurate
exclude:
items:
type: string
enum:
- hidden_sheets
- hidden_rows
- hidden_cols
- styling
- spreadsh
# --- truncated at 32 KB (34 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/reducto/refs/heads/main/openapi/reducto-parse-api-openapi.yml