> ## Documentation Index > Fetch the complete documentation index at: https://docs.omi.me/llms.txt > Use this file to discover all available pages before exploring further. # List Conversations > Retrieve your conversation transcripts. Only returns completed, non-discarded conversations. ## OpenAPI ````yaml GET /v1/dev/user/conversations openapi: 3.1.0 info: title: Omi Developer API description: >- Programmatic access to your Omi data — memories, conversations, action items, and API keys. Build custom integrations, analytics dashboards, and automation workflows. version: 1.0.0 contact: name: Omi url: https://omi.me license: name: MIT url: https://github.com/BasedHardware/omi/blob/main/LICENSE servers: - url: https://api.omi.me description: Production security: - bearerAuth: [] tags: - name: Memories description: Read and write user memories — timeless facts, preferences, and insights. - name: Conversations description: Create and retrieve conversation transcripts with AI-generated summaries. - name: Folders description: Retrieve user-defined folders for organizing conversations. - name: Action Items description: Manage tasks and to-dos extracted from conversations or created manually. - name: API Keys description: Create, list, and revoke developer API keys. paths: /v1/dev/user/conversations: get: tags: - Conversations summary: List conversations description: >- Retrieve your conversation transcripts. Only returns completed, non-discarded conversations. operationId: listConversations parameters: - name: limit in: query description: Maximum number of conversations to return. schema: type: integer default: 25 - name: offset in: query description: Number of conversations to skip. schema: type: integer default: 0 - name: start_date in: query description: Filter by start date (inclusive). ISO 8601 format. schema: type: string format: date-time - name: end_date in: query description: Filter by end date (inclusive). ISO 8601 format. schema: type: string format: date-time - name: include_transcript in: query description: Include full transcript segments in the response. schema: type: boolean default: false - name: categories in: query description: >- Comma-separated list of conversation categories to filter by (e.g. `work,personal`). Matches conversations whose category is any of the listed values (OR semantics). schema: type: string - name: folder_id in: query description: >- Filter conversations by folder ID. Each conversation belongs to at most one folder, so this is a single-value filter. Must be a non-empty string. schema: type: string minLength: 1 - name: starred in: query description: >- Filter by starred status. Pass `true` for starred conversations only, `false` for non-starred. schema: type: boolean responses: '200': description: List of conversations. content: application/json: schema: type: array items: $ref: '#/components/schemas/Conversation' example: - id: conv_202 created_at: '2025-01-20T13:50:00Z' started_at: '2025-01-20T13:50:00Z' finished_at: '2025-01-20T14:10:00Z' language: en source: omi structured: title: Feature Discussion overview: Brainstorming session for new features emoji: 💼 category: business action_items: [] events: [] '400': description: >- Invalid `categories` value (must be a comma-separated list of valid `CategoryEnum` values). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: detail: Invalid category 'foo' is not a valid CategoryEnum '401': $ref: '#/components/responses/Unauthorized' '403': description: 'Insufficient permissions. Required scope: `conversations:read`.' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: detail: 'Insufficient permissions. Required scope: conversations:read' '422': $ref: '#/components/responses/ValidationError' components: schemas: Conversation: type: object properties: id: type: string description: Unique identifier. created_at: type: string format: date-time description: When the conversation record was created. started_at: type: string format: date-time description: When the conversation started. finished_at: type: string format: date-time description: When the conversation ended. language: type: string description: Language code (e.g. `en`). source: type: string description: Source device or app. structured: $ref: '#/components/schemas/StructuredData' transcript_segments: type: array items: $ref: '#/components/schemas/TranscriptSegment' description: Transcript segments (only present when `include_transcript=true`). geolocation: $ref: '#/components/schemas/Geolocation' folder_id: type: - string - 'null' description: >- ID of the folder this conversation belongs to, or null if not in any folder. folder_name: type: - string - 'null' description: Display name of the folder, or null if not in any folder. ErrorResponse: type: object properties: detail: type: string description: Error description. StructuredData: type: object properties: title: type: string description: AI-generated title. overview: type: string description: Summary of the conversation. emoji: type: string description: Representative emoji. category: type: string description: Category (work, personal, etc.). action_items: type: array items: $ref: '#/components/schemas/ActionItemSummary' events: type: array items: type: object TranscriptSegment: type: object properties: id: type: string description: Segment identifier. text: type: string description: The transcribed text. speaker_id: type: integer description: Numeric speaker identifier. speaker_name: type: string description: Human-readable speaker name. start: type: number description: Start timestamp in seconds. end: type: number description: End timestamp in seconds. Geolocation: type: object properties: latitude: type: number longitude: type: number address: type: string google_place_id: type: string location_type: type: string ActionItemSummary: type: object properties: description: type: string completed: type: boolean created_at: type: string format: date-time updated_at: type: string format: date-time due_at: type: - string - 'null' format: date-time completed_at: type: - string - 'null' format: date-time responses: Unauthorized: description: Invalid or missing API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: detail: Invalid API key ValidationError: description: Validation error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: detail: 'Validation error: content is required' securitySchemes: bearerAuth: type: http scheme: bearer description: >- Developer API key. Get one from **Settings → Developer → Create Key** in the Omi app. Keys are prefixed with `omi_dev_`. ````