Item · twin memory

POST /v1/memory/itemAuth: read key

Returns one item as add was given it, by its id, with its whole text. This is Mem0's get. It returns the newest copy: one accepted and still waiting to land, with landed: false, if there is one; otherwise the landed item, with landed: true. An id memory does not hold, or one that was forgotten or has expired, answers found: false. Makes no model call. To see earlier versions of an item, use versions.

Headers

Authorizationstringrequired

Bearer tm_…. A read key is enough.

X-Twin-Accountstringrequired

The end user whose items to return. See End users.

X-Request-Idstring

Your id for this request, echoed on the response.

Body

idstringrequired

The item's id, as you gave it to add.

Response

foundboolean

Whether memory holds an item by this id.

itemobject

Each item as add was given it: id, kind, text, title, at, author, session, about, metadata and expires, with the event_id memory filed it under, and landed: false for a copy still waiting to land. Present when found is true.

idstring

The id you sent. Present when found is false.

Errors

400bad request

X-Twin-Account is missing or not a usable id.

401unauthorized

The bearer is not a key this service issued.

404not found

no memory for end user 'user_42' yet.

422invalid

A missing or empty id.

503unavailable

At capacity, or this end user is being rebuilt. Retry after Retry-After seconds.

Request

curl https://api.twinmemory.dev/v1/memory/item \
  -H "Authorization: Bearer $TWIN_MEMORY_API_KEY" \
  -H "X-Twin-Account: user_42" \
  -H "Content-Type: application/json" \
  -d '{ "id": "pref-diet" }'

200 OK

{
  "found": true,
  "item": {
    "id": "pref-diet",
    "kind": "note",
    "text": "Alice is vegan and allergic to peanuts.",
    "at": "2026-10-01T09:30:00+00:00",
    "author": { "id": "user_42", "name": "Alice Chen" },
    "session": "onboarding",
    "about": ["topic:diet"],
    "metadata": { "source": "signup_form" },
    "expires": null,
    "event_id": "ev_620270db0bff9328",
    "landed": true
  }
}

200 OK, unknown id

{ "id": "nope-404", "found": false }