Neurophic
Memory

Get a memory

Learn about how to fetch a memory

Fetch a single memory. Use it to read a memory you found through List or Retrieve.

GET/v1/memories/{id}https://api.neurophic.ai

Request

id
string in path required
Memory id.
identifier
string in query required 1-500 characters
Your end-user id.

Note

Any stored record can be fetched: an observation, a promoted memory, a decayed memory or a superseded version. Patterns have no id and cannot be fetched (see API reference > Retrieve).

Response

200Success
id
string required
Memory id.
content
string required
The stored text.
phase
'short_term' | 'long_term' | 'decayed' required
Lifecycle phase: 'short_term' (observation awaiting promotion), 'long_term' (promoted), or 'decayed' (no longer surfaced by retrieval).
createdAt
string required ISO 8601
When this record was created. For promoted memories this is the promotion time.

Failures return one of the errors listed under API reference > Errors.

{
  "id": "5f1d2c3e-0c2a-4b7e-9a1b-2f3c4d5e6f70",
  "content": "Prefers window seats and vegetarian meals on long flights.",
  "phase": "long_term",
  "createdAt": "2026-08-12T09:30:00.000Z"
}

Tip

The body is the bare memory object. It is not wrapped in a result key the way Context and Retrieve responses are.

Note

The response does not say whether a long_term memory is the current version of a fact or a superseded one.

Example

import { Neurophic } from 'neurophic';

const client = new Neurophic({ apiKey: process.env.NEUROPHIC_API_KEY });

const memory = await client.memory.get('5f1d2c3e-0c2a-4b7e-9a1b-2f3c4d5e6f70', {
  identifier: 'user-123',
});