---
title: "Retrieve an engram"
method: GET
path: "/v1/memories/{id}"
tags: ["Memories"]
---

# Retrieve an engram

`GET /v1/memories/{id}`

Retrieves detailed information about a specific engram by its
ID.

This endpoint returns the engram's metadata, status, and system information. It does not
return the engram's content - use the `/engrams/{id}/download` endpoint for that.

Users can only retrieve engrams they own or have access to through collections.
Superusers can retrieve any engram.

## Path parameters

- `id` string, uuid, required — The ID of the engram to retrieve.

## Response `200`

Successful Response

- NebulaResultsEngramResponse
  - `results` EngramResponse, required — Base class for engram information handling.
    - `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

## 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)