> ## Documentation Index > Fetch the complete documentation index at: https://doc.featherhq.com/llms.txt > Use this file to discover all available pages before exploring further. # List v2 conversations ## OpenAPI ````yaml /api-reference/openapi.json get /v1/v2/conversations openapi: 3.1.0 info: title: Feather API description: >- Unified customer experience platform API. Manages identity, conversations, memory, agents, procedures, policies, model routing, knowledge bases, integrations, and runtime execution. version: 1.21.0 servers: - url: https://api-sandbox.featherhq.com description: Sandbox - url: http://localhost:8000 description: Local dev security: [] paths: /v1/v2/conversations: get: tags: - runtime v2 summary: List v2 conversations operationId: listV2Conversations parameters: - name: status in: query required: false schema: anyOf: - type: string - type: 'null' title: Status - name: channel in: query required: false schema: anyOf: - type: string - type: 'null' title: Channel - name: end_user_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: End User Id - name: assigned_agent_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Assigned Agent Id - name: priority in: query required: false schema: anyOf: - type: string - type: 'null' title: Priority - name: started_after in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' description: Lower-bound (inclusive) on conversation ``started_at``. title: Started After description: Lower-bound (inclusive) on conversation ``started_at``. - name: started_before in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' description: Upper-bound (inclusive) on conversation ``started_at``. title: Started Before description: Upper-bound (inclusive) on conversation ``started_at``. - name: q in: query required: false schema: anyOf: - type: string - type: 'null' description: Case-insensitive substring match on subject/summary. title: Q description: Case-insensitive substring match on subject/summary. - name: eval_filter in: query required: false schema: anyOf: - enum: - has_evals - no_evals - all_passed - any_failed type: string - type: 'null' title: Eval Filter - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 default: 50 title: Limit - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' title: Cursor responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CursorPage_SessionResponse_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: CursorPage_SessionResponse_: properties: items: items: $ref: '#/components/schemas/src__conversation__schemas__SessionResponse' type: array title: Items next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor has_more: type: boolean title: Has More type: object required: - items - has_more title: CursorPage[SessionResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError src__conversation__schemas__SessionResponse: properties: id: type: string format: uuid title: Id organization_id: type: string format: uuid title: Organization Id end_user_id: type: string format: uuid title: End User Id channel: type: string title: Channel origin: anyOf: - type: string enum: - inbound - outbound - type: 'null' title: Origin external_session_id: anyOf: - type: string - type: 'null' title: External Session Id status: type: string enum: - queued - ringing - active - paused - waiting_for_human - transferred - awaiting_approval - closed - expired - error - superseded title: Status session_type: type: string enum: - live - test - simulation title: Session Type default: live priority: type: string enum: - low - normal - high - urgent title: Priority subject: anyOf: - type: string - type: 'null' title: Subject assigned_agent_id: anyOf: - type: string format: uuid - type: 'null' title: Assigned Agent Id retention_policy_id: anyOf: - type: string format: uuid - type: 'null' title: Retention Policy Id summary: anyOf: - type: string - type: 'null' title: Summary metadata: additionalProperties: true type: object title: Metadata context_variables: additionalProperties: true type: object title: Context Variables message_count: type: integer title: Message Count first_message_at: anyOf: - type: string format: date-time - type: 'null' title: First Message At last_message_at: anyOf: - type: string format: date-time - type: 'null' title: Last Message At started_at: type: string format: date-time title: Started At ended_at: anyOf: - type: string format: date-time - type: 'null' title: Ended At closed_at: anyOf: - type: string format: date-time - type: 'null' title: Closed At ttl_expires_at: anyOf: - type: string format: date-time - type: 'null' title: Ttl Expires At retention_expires_at: anyOf: - type: string format: date-time - type: 'null' title: Retention Expires At archived_at: anyOf: - type: string format: date-time - type: 'null' title: Archived At memory_synced: type: boolean title: Memory Synced default: false created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At duration_ms: anyOf: - type: integer - type: 'null' title: Duration Ms summary_preview: anyOf: - type: string - type: 'null' title: Summary Preview has_recording: type: boolean title: Has Recording default: false eval_summary: $ref: '#/components/schemas/SessionEvalSummary' type: object required: - id - organization_id - end_user_id - channel - status - priority - message_count - started_at - created_at - updated_at title: SessionResponse ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError SessionEvalSummary: properties: total: type: integer title: Total default: 0 succeeded: type: integer title: Succeeded default: 0 failed: type: integer title: Failed default: 0 pending: type: integer title: Pending default: 0 critical_total: type: integer title: Critical Total default: 0 critical_succeeded: type: integer title: Critical Succeeded default: 0 critical_failed: type: integer title: Critical Failed default: 0 critical_pending: type: integer title: Critical Pending default: 0 eval_status: type: string enum: - success - partial - failure - pending - none title: Eval Status default: none type: object title: SessionEvalSummary description: >- Rollup of eval runs that targeted a session. `succeeded` = runs where status='completed' AND every score has passed=true. `failed` = total - succeeded - pending (failed-status runs + completed-but-not-all-passed). `pending` = runs still queued or running. The `critical_*` counterparts restrict the same aggregation to runs whose binding was marked `is_critical=True` (snapshotted onto the run). They drive the session headline pill — non-critical evals still run and display but don't move the verdict. `eval_status` collapses the critical counts to a single headline label (`none` when no criticals are configured). securitySchemes: APIKeyHeader: type: apiKey in: header name: x-api-key ````