---
title: "Search or list attributed profile data"
method: GET
path: "/v1/profile/search"
tags: ["Profile"]
---

# Search or list attributed profile data

`GET /v1/profile/search`

## Request

- Base URL: `https://api.configure.dev`
- URL: `https://api.configure.dev/v1/profile/search`
- Auth: one of:
  - API key in header `X-API-Key` and HTTP bearer
  - API key in header `X-API-Key` and API key in header `X-User-Id`

Deterministic retrieval over permitted attributed profile data. Omit query or pass "*" to list bounded permitted compact results. Compact results omit raw CFS paths/provenance; full detail is opt-in.

## Query parameters

- `query` string
- `source` string
- `from` string, date
- `to` string, date
- `limit` integer
- `detail` 'compact' | 'full'

## Headers

- `X-Agent` string

## Response `200`

Attributed profile search results.

- ProfileSearchResult
  - `results` ProfileSearchHit[], required
    - union
      - object
        - `id` string, required
        - `title` string
        - `text` string, required
        - `snippet` string
        - `path` string: Present only when detail=full.
        - `source` string, required
        - `written_by` string
        - `created_at` string, date-time
        - `updated_at` string, date-time: Present only when detail=full.
        - `event_at` string
        - `markers` string[]: Present only when detail=full.
        - `provenance` object: Safe provenance metadata present only when detail=full.
        - `score` number
        - `type` 'memory' | 'preference' | 'identity' | 'document' | 'connector' | 'agent_note'
      - object
        - `id` string, required
        - `title` string
        - `text` string
        - `snippet` string, required
        - `path` string: Present only when detail=full.
        - `source` string, required
        - `written_by` string
        - `created_at` string, date-time
        - `updated_at` string, date-time: Present only when detail=full.
        - `event_at` string
        - `markers` string[]: Present only when detail=full.
        - `provenance` object: Safe provenance metadata present only when detail=full.
        - `score` number
        - `type` 'memory' | 'preference' | 'identity' | 'document' | 'connector' | 'agent_note'
  - `filtered` boolean, required
  - `hiddenSources` string[]

---

[API](https://skmtc.dev/configure/apis/configure-http-api.md) · [All operations](https://skmtc.dev/configure/apis/configure-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/configure/apis/configure-http-api/revisions/ec760a9533d2?raw)