List PDF tables
list_pdf_tablesRead-onlyIdempotent
Use this when the user wants to extract table from pdf, copy table from pdf, or inspect pdf to spreadsheet tables, before exporting: it shows each table's size, column types and first rows with no download. Does not make Excel or CSV files (use convert_pdf_tables for that), does not read scanned pages (no OCR), and handles up to 15 MB and 50 pages. Do not use for editing a PDF or for a PDF that is not a table.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | The text-based PDF that holds the tables, e.g. report.pdf. | |
| pages | No | Pages to read, e.g. 1-3,5. Default: every page (first 50). | |
| merge_tables | No | true (default): join the last table on a page to the first on the next page only when their column count and whitespace-normalized source headers match. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | ||
| note | No | ||
| status | No | ||
| tables | Yes | ||
| warnings | Yes | ||
| truncated | Yes | ||
| page_count | Yes | ||
| pages_read | Yes | ||
| scanned_pages | Yes | ||
| table_details | Yes | ||
| other_text_rows | Yes |