> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moss.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# GetDocumentsOptions

[moss v1.0.1](../README)

[moss](../api) / GetDocumentsOptions

# Interface: GetDocumentsOptions

Options for `get_docs` — deterministic retrieval (no query vector, no ranking).
See [Exact / Graph Retrieval](../graph-retrieval).

## Properties

* **doc\_ids**: `Optional[List[str]]` - Fetch these exact ids, returned in this order. Missing ids are skipped.
* **filter**: `Optional[dict]` - Metadata predicate (same dict shape as [`QueryOptions.filter`](./QueryOptions) / [metadata filtering](../metadata-filtering)). *(moss 1.6.0+)*
* **sort\_by**: `Optional[str]` - Metadata field to order results by (numeric-aware). *(moss 1.6.0+)*
* **ascending**: `Optional[bool]` - Sort direction for `sort_by`; defaults to ascending. *(moss 1.6.0+)*
* **group\_by**: `Optional[ParentGrouping]` - Collapse sibling docs sharing a parent id into one result per unit. See [`ParentGrouping`](./ParentGrouping). *(moss 1.6.0+)*