> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Searching

> Search persisted conversation records with the Conversation Histories API.

Run a semantic search across persisted conversation records with `GET /v2/ai/conversation_histories`. Your query text is embedded into a vector and matched against indexed transcript chunks, so each result is a single chunk with a relevance `score` and its parent record's metadata — ready to use as retrieval context for RAG.

```bash theme={null}
curl --globoff \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/ai/conversation_histories?q=flight+refund&record_type=voice&top_k=10"
```

Pass a query (`q`) and a `record_type` (use `voice` for SIP call history). Narrow results with the `region`, `min_score`, and `filter[field][operator]` parameters.

See the **Search conversation histories** API reference for the full set of parameters, filter operators, the response schema, and SDK code samples.