---
title: "Search Conversations"
method: GET
path: "/api/conversations"
---

# Search Conversations

`GET /api/conversations`

## Query parameters

- `page_id` string, nullable
- `limit` integer
- `selected_repository` string, nullable
- `conversation_trigger` 'resolver' | 'gui' | 'suggested_task' | 'openhands_api' | 'slack' | 'microagent_management' | 'jira' | 'jira_dc' | 'linear'

## Response `200`

Successful Response

- ConversationInfoResultSet
  - `results` ConversationInfo[]
    - `conversation_id` string, required
    - `title` string, required
    - `last_updated_at` string, date-time, nullable
    - `status` 'STARTING' | 'RUNNING' | 'STOPPED'
    - `runtime_status` 'STATUS$STOPPED' | 'STATUS$BUILDING_RUNTIME' | 'STATUS$STARTING_RUNTIME' | 'STATUS$RUNTIME_STARTED' | 'STATUS$SETTING_UP_WORKSPACE' | 'STATUS$SETTING_UP_GIT_HOOKS' | 'STATUS$READY' | 'STATUS$ERROR' | 'STATUS$ERROR_RUNTIME_DISCONNECTED' | 'STATUS$ERROR_LLM_AUTHENTICATION' | 'STATUS$ERROR_LLM_SERVICE_UNAVAILABLE' | 'STATUS$ERROR_LLM_INTERNAL_SERVER_ERROR' | 'STATUS$ERROR_LLM_OUT_OF_CREDITS' | 'STATUS$ERROR_LLM_CONTENT_POLICY_VIOLATION' | 'CHAT_INTERFACE$AGENT_RATE_LIMITED_STOPPED_MESSAGE' | 'STATUS$GIT_PROVIDER_AUTHENTICATION_ERROR' | 'STATUS$LLM_RETRY' | 'STATUS$ERROR_MEMORY'
    - `selected_repository` string, nullable
    - `selected_branch` string, nullable
    - `git_provider` 'github' | 'gitlab' | 'bitbucket' | 'enterprise_sso'
    - `trigger` 'resolver' | 'gui' | 'suggested_task' | 'openhands_api' | 'slack' | 'microagent_management' | 'jira' | 'jira_dc' | 'linear'
    - `num_connections` integer
    - `url` string, nullable
    - `session_api_key` string, nullable
    - `created_at` string, date-time
    - `pr_number` integer[]
  - `next_page_id` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/all-hands/apis/openhands.md) · [All operations](https://skmtc.dev/all-hands/apis/openhands/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/all-hands/openhands/revisions/4daa2bb4dbf1/schema)