list_print_jobs
List past print jobs with pagination, filters, and sort. Compact mode (default) drops gcodeAnalysis, filament breakdowns, and panel-only flags.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Page number (1-based) | |
| limit | No | Cap on results per page (1-100). Alias for page_size. | |
| search | No | Filename / UID / custom-field substring search | |
| compact | No | Keep at default true. Returns minimal data tuned for AI context. Only set to false if you specifically need fields the compact view drops, and then pair with limit to keep the response small. | |
| sort_by | No | Sort by this field. Default: started date desc (newest first). | |
| sort_id | No | ||
| sources | No | ||
| end_date | No | Latest start (ISO-8601) | |
| sort_dir | No | Sort direction; default desc. | |
| spool_id | No | Only jobs that used this filament spool | |
| user_ids | No | Only jobs started by these users (requires VIEW_ALL_PRINT_HISTORY) | |
| page_size | Yes | Items per page (1-100) | |
| queue_job | No | ||
| start_date | No | Earliest start (ISO-8601) | |
| printer_ids | No | Only jobs from these printer ids | |
| machine_types | No | ||
| printer_types | No | ||
| printer_groups | No | Only jobs from printers in these groups | |
| archived_status | No | null (default): hide archived; archived: only archived; both: include archived | |
| accepted_statuses | No | Filter by job status. Multiple values OR-matched. |