---
title: "List engrams"
method: GET
path: "/v1/memories"
tags: ["Memories"]
---

# List engrams

`GET /v1/memories`

Returns a paginated list of engrams the authenticated user has
access to.

Results can be filtered by providing specific engram IDs or collection IDs.
Regular users will only see engrams they own or have access to through
collections. Superusers can see all engrams.

The engrams are returned in order of last modification, with most
recent first. The response includes the engram's text field if available.

## Query parameters

- `ids` string[] — A list of engram IDs to retrieve. If not provided, all engrams will be returned.
- `offset` integer — Specifies the number of objects to skip. Defaults to 0.
- `limit` integer — Specifies a limit on the number of objects to return, ranging between 1 and 100. Defaults to 100.
- `chunks_limit` integer, nullable — Maximum chunks to inline per engram. Defaults to all chunks for backwards compatibility; pass 0 to skip chunk hydration.
- `owner_only` boolean — If true, only returns engrams owned by the user, not all accessible engrams.
- `collection_ids` string[], nullable — Optional list of collection IDs to filter engrams by. If provided, exactly one collection ID must be specified.
- `metadata_filters` string, nullable — JSON string for metadata filtering. Example: '{"metadata.source": {"$eq": "playground"}}'

## Response `200`

Successful Response

- PaginatedNebulaResultListEngramResponse
  - `results` EngramResponse[], required
    - `chunks` unknown[], nullable
      - unknown
    - `collection_ids` string[], required
    - `created_at` string, date-time, nullable
    - `document_type` 'mp3' | 'csv' | 'eml' | 'msg' | 'p7s' | 'epub' | 'xls' | 'xlsx' | 'html' | 'htm' | 'bmp' | 'heic' | 'jpeg' | 'png' | 'tiff' | 'jpg' | 'svg' | 'md' | 'org' | 'odt' | 'pdf' | 'txt' | 'json' | 'ppt' | 'pptx' | 'rst' | 'rtf' | 'tsv' | 'gif' | 'doc' | 'docx' | 'py' | 'js' | 'ts' | 'css', required — Types of file formats that can be stored as engrams.
    - `engram_type` 'document' | 'conversation', required — Types of engrams - broader categories that include documents and conversations.
    - `extraction_status` 'pending' | 'processing' | 'success' | 'failed' — Status of graph creation per document.
    - `id` string, uuid, required
    - `ingestion_attempt_number` integer, nullable
    - `ingestion_status` 'pending' | 'parsing' | 'extracting' | 'chunking' | 'embedding' | 'augmenting' | 'storing' | 'failed' | 'success' — Status of document processing.
    - `merkle_root` string, nullable
    - `metadata` object, required
    - `owner_id` string, uuid, required
    - `search_ready_seq` integer, nullable
    - `size_in_bytes` integer, nullable
    - `text` string, nullable
    - `title` string, nullable
    - `total_tokens` integer, nullable
    - `updated_at` string, date-time, nullable
    - `version` string, nullable
    - `workflow_run_id` string, nullable
  - `total_entries` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/zeroset-inc/apis/nebula-api.md) · [All operations](https://skmtc.net/zeroset-inc/apis/nebula-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zeroset-inc/nebula-api/revisions/b1da2c0bb1ae/schema)