Skip to main content
GET
/
v1
/
state
/
{patient_id}
/
memories
import olira

olira.init(api_key="YOUR_API_KEY")
mem = olira.read_memories(patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82", query="appointment", limit=20)
print(mem.results)

MemoriesResult(
    patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    count=1,
    results=[
        MemoryEntry(
            memory_id="mem-001",
            content="Patient prefers morning appointments.",
            metadata={"source": "conversation"},
            created_at="2026-01-10T15:00:00Z",
            updated_at=None,
        ),
    ],
)

olira.read_memories(
    patient_id: str,
    query: str | None = None,
    limit: int = 100,
) -> MemoriesResult
Requires scope: sdk:state-read Omit query to list up to limit; pass query for text search.

​
Parameters

​
patient_id
str
required
Olira patient id.
​
query
str | None
Optional search string.
​
limit
int
default:"100"
Max memories.

​
Returns

MemoriesResult
​
patient_id
str
Patient id.
​
count
int
Returned count.
​
results
list[MemoryEntry]
Memory rows.
​
results[].memory_id
str
Memory id.
​
results[].content
str
Text content.
​
results[].metadata
dict | None
Optional metadata.
​
results[].created_at
str | None
Created at.
​
results[].updated_at
str | None
Updated at.

​
Raises

ExceptionWhen
AuthErrorHTTP 401 or 403 — invalid API key or insufficient OAuth scope for this endpoint.
ValidationErrorHTTP 400, 404, or 422 — malformed JSON, unknown patient, or validation failure (message includes response excerpt).
ServerErrorHTTP 409 (e.g. conflicting external identifier) or repeated 5xx after retries; includes status_code when applicable.
RateLimitErrorHTTP 429 — rate limited; check retry_after (seconds).
NetworkErrorConnection timeout, DNS failure, or read error after retries.
import olira

olira.init(api_key="YOUR_API_KEY")
mem = olira.read_memories(patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82", query="appointment", limit=20)
print(mem.results)

MemoriesResult(
    patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    count=1,
    results=[
        MemoryEntry(
            memory_id="mem-001",
            content="Patient prefers morning appointments.",
            metadata={"source": "conversation"},
            created_at="2026-01-10T15:00:00Z",
            updated_at=None,
        ),
    ],
)