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

# Conversations

> List routed conversations and inspect their model steps.

<ParamField header="Authorization" type="string" required>`Bearer` plus a Management API key.</ParamField>
<ParamField query="from" type="string" required>RFC 3339 range start, inclusive.</ParamField>
<ParamField query="to" type="string" required>RFC 3339 range end, exclusive.</ParamField>
<ParamField query="router_id" type="string">Limit to one router.</ParamField>
<ParamField query="api_key_id" type="array">API key ID filter. Repeatable.</ParamField>
<ParamField query="user_id" type="array">Attributed user ID filter. Repeatable.</ParamField>
<ParamField query="model" type="array">Model ID filter. Repeatable.</ParamField>
<ParamField query="provider" type="string">Provider filter.</ParamField>
<ParamField query="status" type="string">`completed`, `provider_error`, `selector_error`, or `aborted`.</ParamField>
<ParamField query="key_source" type="string">`user`, `managed`, or `subscription`.</ParamField>
<ParamField query="source_scope" type="string">`openai_chat`, `openai_responses`, `anthropic_messages`, comma-separated, `all`, or `none`.</ParamField>
<ParamField query="search" type="string">Search conversation identifiers and titles.</ParamField>
<ParamField query="sort_by" type="string" default="last_active">`last_active`, `messages`, `model_steps`, `model_switches`, `spend`, or `tokens`.</ParamField>
<ParamField query="sort_direction" type="string" default="desc">`asc` or `desc`.</ParamField>
<ParamField query="limit" type="integer" default="50">Maximum conversations.</ParamField>
<ParamField query="offset" type="integer" default="0">Conversations to skip.</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.dari.dev/v1/organizations/current/routing/activity/conversations?from=2026-07-01T00:00:00Z&to=2026-07-08T00:00:00Z&sort_by=model_switches" \
    -H "Authorization: Bearer $DARI_API_KEY"
  ```
</RequestExample>

The response contains `conversations`, `conversation_count`, switch totals, and pagination fields.

## Conversation Detail

```http theme={null}
GET /v1/organizations/{org}/routing/activity/conversations/{conversation_ref}
```

<ParamField path="conversation_ref" type="string" required>Conversation identity from the list response.</ParamField>
<ParamField query="limit" type="integer" default="100">Maximum model steps.</ParamField>
<ParamField query="offset" type="integer" default="0">Steps to skip from the newest end.</ParamField>

```bash theme={null}
dari activity conversations get <conversation_ref>
```