Actions18
Document → Get Many
AI-generatedSummary
Retrieve multiple documents from a specified namespace with optional filtering, ordering, pagination, and tenant context.
Inputs
- Namespace ID (required) — The ID of the namespace (prefixed with ns_) to fetch documents from.
- Return All — Whether to retrieve all documents matching the criteria or limit to a specified maximum.
- Limit — Maximum number of documents to return when not returning all (1-100).
- Page Size (when Return All Is Enabled) — Number of documents to fetch per page when returning all results (1-100).
- Options — Optional filters and parameters including Ingest Job ID to filter documents by ingest job, ordering of results by creation date, status filtering with multiple selectable statuses, and an optional Tenant ID header for multi-tenant support.
Output shape
a list of document records, each representing a document in the namespace matching the filter criteria
Supports cursor-based pagination when 'Return All' is enabled by iterating over pages using the cursor until no further pages exist. When 'Return All' is false, limits to the specified 'Limit' number of documents. Document data is returned as JSON objects in an array. Filtering by statuses accepts multiple status values joined by commas in the query. An optional Tenant ID header can be provided if required by the API.