---
title: "Search traces"
method: GET
path: "/api/v1/data/conversations"
---

# Search traces

`GET /api/v1/data/conversations`

## Request

- Base URL: `https://moda.dev`
- URL: `https://moda.dev/api/v1/data/conversations`
- Auth: API key in header `x-api-key`

Searches and filters traces by text, cluster, user, time range, environment, world-state keywords, and outcome.

## Query parameters

- `search` string
- `cluster_id` string
- `user_id` string
- `time_range` 'all' | '1h' | '24h' | '3d' | '7d' | '30d' | '90d'
- `since` string
- `until` string
- `environment` 'all' | 'development' | 'staging' | 'production'
- `world_state` string
- `outcome` 'any' | 'positive' | 'negative'
- `cohort` string
- `limit` integer
- `offset` integer

## Response `200`

Successful response.

- object: Trace search results, trace metadata, and pagination information. Each row carries the dashboard trace list's state: `processing_status` (`pending` until processed, then `complete`), `error_message`, `indexed_at`, and `membership_score` (use-case confidence for `cluster_id`); `trace_state: "unavailable"` when that state could not be read.

## Other responses

- `401`: The x-api-key header is missing, invalid, or revoked.
- `404`: The requested resource was not found.

---

[API](https://skmtc.dev/moda-dev/apis/moda-data-api.md) - [All operations](https://skmtc.dev/moda-dev/apis/moda-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/moda-dev/apis/moda-data-api/revisions/19a11ad88cf6?raw)