---
title: "Search Memory"
method: GET
path: "/datamates/memory/search"
tags: ["MEMORY"]
---

# Search Memory

`GET /datamates/memory/search`

Search for memories in the system.

Filtering happens after the memory service has ranked and limited its
result, so a page can come back shorter than the requested limit — and for
search, trimming after ranking drops the next-best matches rather than
promoting them. A short page does not mean there are no more records.
Pushing the predicate into the service would fix both; it does not accept
one today.

## Query parameters

- `include_sources` string[] — Client sources to include that are hidden by default. Repeat the parameter or supply a comma-separated list. Currently only 'altimate-code' is hidden.

## Response `200`

Successful Response

- object[]

## Other responses

- `400` — Invalid request
- `403` — Forbidden
- `422` — Validation Error

## Changes

- **2026-08-25** `64fc5b1ea2a2` — 2 info
  - added the new optional `query` request parameter `include_sources`
  - added the non-success response with the status `422`

[Change history](https://skmtc.dev/myaltimate/apis/fastapi/changes/datamates/memory/search/get.md)

---

[API](https://skmtc.dev/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.dev/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/myaltimate/fastapi/revisions/82206441f16e/schema)