Neurophic
Memory

List memories

Learn about how to list every stored memory

List returns every stored record in pages, newest first, with no ranking and no search.

GET/v1/memorieshttps://api.neurophic.ai

Request

identifier
string in query required 1-500 characters
Your end-user id.
page
integer in query default 1at least 1
Page number, starting at 1.
perPage
integer in query default 201-50
Results per page. 1-50.

Note

Asking for a page past the end returns an empty memories array with the same total.

Response

200Success
memories
object[] required
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.
page
integer required
perPage
integer required
total
integer required
Total memories for this identifier, including decayed and superseded versions.

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

{
  "memories": [
    {
      "id": "9a8b7c6d-1e2f-4a3b-8c9d-0e1f2a3b4c5d",
      "content": "Asked about upgrading to business class on the next trip.",
      "phase": "short_term",
      "createdAt": "2026-08-19T08:15:00.000Z"
    },
    {
      "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"
    },
    {
      "id": "0c9b8a7d-6e5f-4d3c-b2a1-9f8e7d6c5b4a",
      "content": "Prefers aisle seats on long flights.",
      "phase": "long_term",
      "createdAt": "2026-06-02T17:45:00.000Z"
    }
  ],
  "page": 1,
  "perPage": 20,
  "total": 42
}

Ordering is by createdAt, newest first. For a promoted memory createdAt is the promotion time; for an observation it is the time the content was recorded.

The list is complete. It includes short_term observations (waiting for promotion, or promoted but not yet removed), long_term memories, decayed memories that search no longer surfaces, and older versions of facts that a newer memory has since superseded.

Tip

There is no totalPages or hasMore field. Stop paging when page * perPage >= total, or when memories comes back empty.

Note

  • The response does not say which long_term records are superseded or which memory superseded them. Use Retrieve to see only the current version of each fact.
  • Every id in the list can be passed to Get or Delete, including observation ids.

Retrieve

Learn about how to search memory and the two result shapes

Get

Learn about how to fetch a memory