search_entries
Execute a raw Laserfiche search query to retrieve matching entries, specifying syntax with braces and operators for precise filtering.
Instructions
Run a raw Laserfiche search query and return matching entries.
Use when you already know how to express the search in Laserfiche query
syntax. If the user describes what they want in natural language and you
are unsure how to translate, prefer search_natural (which asks the
server for the available templates and field names first). For a simple
name-pattern lookup, search_by_name is the cheaper option.
Query syntax cheat sheet:
{LF:Name="Onboarding*"}— name pattern (*and?wildcards){[Loan Application]:[Last Name]="Smith"}— field on template{LF:LookIn="\Imports\2024"}— restrict to a folder subtreeCombine with
&(AND) /|(OR), e.g.{LF:Name="*.pdf"} & {[Application]:[Status]="Approved"}
Args:
query: A Laserfiche search expression. Quote string values with
double quotes; escape inner quotes by doubling them.
max_results: Page size (default 25, capped by LF_MAX_RESULTS_CEILING,
typically 200).
Returns: SearchResults with entries (id, name, entry_type,
full_path), total_count, and next_link. Drill in with
get_entry or get_field_values.
On failure: returns {"mode": "error", "error": <slug>, ...} instead
of raising. Slugs you might see here: server_error (most common, the
SimpleSearches endpoint is fragile on some self-hosted builds — see
search_natural for a more resilient path), auth_failed,
rate_limited. Full taxonomy in docs/error-contract.md.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Laserfiche search expression. Each clause wrapped in braces and combined with `&` (AND) or `|` (OR). Quote string values with double quotes; escape inner quotes with `\"`. | |
| max_results | No | Page size. Defaults to LF_MAX_RESULTS_DEFAULT (25). Capped at LF_MAX_RESULTS_CEILING (typically 200). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||