Parse Excel
Dedicated ingestion endpoint for Excel workbooks (.xls / .xlsx) with spreadsheet-specific configuration.
Overview
The Parse Excel endpoint processes Excel workbooks (.xls, .xlsx) using a dedicated spreadsheet pipeline. It shares auth, billing, quota, and rate-limit infrastructure with Parse Document, and is polled via the same GET /parse/{job_id}.
- POST to
/parse/excelwith your file (orurl) and any spreadsheet-specific configuration. - The job is automatically enqueued for processing.
- Poll
GET /parse/{job_id}to track progress and retrieve results.
mode, segment_analysis, etc.) do not apply here — they are silently ignored. Non-Excel uploads are rejected with 400; submit those to POST /parse instead.Request
file (multipart binary upload) or url (presigned/public URL). The file field is multipart-only; JSON callers must use url.file is not provided.Hidden content
false. The five sub-toggles below are only honored when this is true.true.true.true.Table extraction
true.split_large_tables is true. Defaults to 50.Lifecycle
POST /v2/parse/upload instead.Response
The endpoint returns HTTP 200 with the same envelope asPOST /parse:
"unknown" when no usable segment exists.false for Excel jobs — table merging is a PDF-only feature.Retrieving Results
UseGET /parse/{job_id} (the shared polling endpoint) to check status and retrieve results. The result envelope is the same as for PDF jobs — chunks containing segments — and Excel segments include a cell_references field linking each segment back to its source sheet, address, and range.
Error Handling
Authorizations
Body
Provide either file (binary .xls/.xlsx upload, multipart only) or url (presigned/public URL, both content types), not both. The file field is multipart-only. Excel parsing uses its own config — PDF parsing options do not apply.
Request body for POST /parse/excel (multipart/form-data).
Excel parsing has its own configuration — none of the PDF parsing options
(OCR, layout analysis, segment processing) apply. Provide either file
(binary .xls/.xlsx upload) or url, not both. Every config field is optional
and defaults to the Excel pipeline's own default.
Drop hidden sheets/rows/cols/styling from the output. Defaults to false.
When excluding hidden content, also drop hidden columns. Defaults to true.
When excluding hidden content, also drop hidden rows. Defaults to true.
When excluding hidden content, also drop hidden sheets. Defaults to true.
Response
Job created — poll with GET /parse/{job_id} to retrieve results.
Response body for a successful POST /parse call.

