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

# List conversations

> Your conversations, most recent activity first

Lists the API key owner's conversations, including those started on rhizomeai.com. Use it to find a conversation id you lost, or to check whether anything is still running before starting more.

## Query parameters

<ParamField query="status" type="string" default="all">
  `all`, or `running` for conversations with a message in progress. A run that
  was interrupted reads as `error` and is not listed as `running`. `total`
  counts the same conversations as the filter.
</ParamField>

<ParamField query="limit" type="integer" default={20}>
  Conversations per response, 1 to 100.
</ParamField>

<ParamField query="offset" type="integer" default={0}>
  Conversations to skip.
</ParamField>

## Response

<ResponseField name="conversations" type="array">
  Most recent activity first.

  <Expandable title="Conversation summary">
    <ResponseField name="conversation_id" type="string">
      The conversation's id.
    </ResponseField>

    <ResponseField name="title" type="string | null">
      The conversation's title, or its first message.
    </ResponseField>

    <ResponseField name="status" type="string">
      The latest turn's status. See
      [Statuses](/api-reference/v3/conversations/overview#statuses).
    </ResponseField>

    <ResponseField name="created_at" type="string">
      When the conversation started, ISO 8601.
    </ResponseField>

    <ResponseField name="last_activity_at" type="string">
      When the latest message was sent, ISO 8601.
    </ResponseField>

    <ResponseField name="turn_count" type="integer">
      Messages in the conversation.
    </ResponseField>

    <ResponseField name="url" type="string">
      The conversation on rhizomeai.com.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="integer">
  Conversations matching `status`.
</ResponseField>

<ResponseField name="limit" type="integer">
  The `limit` used.
</ResponseField>

<ResponseField name="offset" type="integer">
  The `offset` used.
</ResponseField>

## Errors

| Status | Code | Description |
| - | - | - |
| 400 | `invalid_request` | `status`, `limit` or `offset` is out of range |

Plus `401` and `429`, see [Errors](/api-reference/v3/conversations/overview#errors).

<RequestExample>
  ```bash cURL theme={null}
  curl "https://rhizomeai.com/api/v3/conversations?status=running" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://rhizomeai.com/api/v3/conversations",
      headers={"x-api-key": "YOUR_API_KEY"},
      params={"limit": 50},
  )
  response.raise_for_status()
  for conversation in response.json()["conversations"]:
      print(conversation["status"], conversation["title"])
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "conversations": [
      {
        "conversation_id": "3b1f8c6e-2a4d-4c1e-9f2a-7d5e6b8c9a01",
        "title": "What De Novo requests has the FDA granted this year?",
        "status": "completed",
        "created_at": "2026-10-09T14:02:11.000Z",
        "last_activity_at": "2026-10-09T14:09:40.000Z",
        "turn_count": 2,
        "url": "https://rhizomeai.com/ask/v3/3b1f8c6e-2a4d-4c1e-9f2a-7d5e6b8c9a01"
      }
    ],
    "total": 1,
    "limit": 20,
    "offset": 0
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.