> ## 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. # Get Conversations > Get conversations with optional transcript inclusion. - **include_transcript**: If True, includes full transcript_segments in the response - **folder_id**: Filter by folder ID (must be a non-empty string if provided) - **starred**: Filter by starred status (true/false) ## OpenAPI ````yaml /api-reference/openapi.json get /v1/dev/user/conversations openapi: 3.1.0 info: contact: name: Omi url: https://omi.me/ description: >- Programmatic access to your Omi data - memories, conversations, action items, goals, folders, and API keys. Build custom integrations, analytics dashboards, and automation workflows. license: name: MIT url: https://github.com/BasedHardware/omi/blob/main/LICENSE title: Omi Developer API version: 1.0.0 servers: - description: Production url: https://api.omi.me security: [] tags: - description: Read and write user memories - timeless facts, preferences, and insights. name: Memories - description: Create and retrieve conversation transcripts with AI-generated summaries. name: Conversations - description: Retrieve user-defined folders for organizing conversations. name: Folders - description: Manage tasks and to-dos extracted from conversations or created manually. name: Action Items - description: Manage user goals and progress history. name: Goals - description: Create, list, and revoke developer API keys. name: API Keys paths: /v1/dev/user/conversations: get: tags: - Conversations summary: Get Conversations description: >- Get conversations with optional transcript inclusion. - **include_transcript**: If True, includes full transcript_segments in the response - **folder_id**: Filter by folder ID (must be a non-empty string if provided) - **starred**: Filter by starred status (true/false) operationId: listConversations parameters: - in: query name: start_date required: false schema: anyOf: - format: date-time type: string - type: 'null' title: Start Date - in: query name: end_date required: false schema: anyOf: - format: date-time type: string - type: 'null' title: End Date - in: query name: categories required: false schema: anyOf: - type: string - type: 'null' title: Categories - in: query name: limit required: false schema: default: 25 title: Limit type: integer - in: query name: offset required: false schema: default: 0 title: Offset type: integer - in: query name: include_transcript required: false schema: default: false title: Include Transcript type: boolean - in: query name: folder_id required: false schema: anyOf: - minLength: 1 type: string - type: 'null' title: Folder Id - in: query name: starred required: false schema: anyOf: - type: boolean - type: 'null' title: Starred responses: '200': content: application/json: schema: items: $ref: '#/components/schemas/DeveloperConversation' title: Response Listconversations type: array description: Successful Response '401': $ref: '#/components/responses/Error401' '403': $ref: '#/components/responses/Error403' '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - developerApiKey: [] components: schemas: DeveloperConversation: properties: created_at: format: date-time title: Created At type: string finished_at: anyOf: - format: date-time type: string - type: 'null' title: Finished At folder_id: anyOf: - type: string - type: 'null' title: Folder Id folder_name: anyOf: - type: string - type: 'null' title: Folder Name geolocation: anyOf: - $ref: '#/components/schemas/Geolocation' - type: 'null' id: title: Id type: string language: anyOf: - type: string - type: 'null' title: Language source: anyOf: - type: string - type: 'null' title: Source started_at: anyOf: - format: date-time type: string - type: 'null' title: Started At structured: $ref: '#/components/schemas/DeveloperConversationStructured' transcript_segments: anyOf: - items: $ref: '#/components/schemas/DeveloperTranscriptSegment' type: array - type: 'null' title: Transcript Segments required: - id - created_at - started_at - finished_at - structured title: DeveloperConversation type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object Geolocation: properties: address: anyOf: - type: string - type: 'null' title: Address google_place_id: anyOf: - type: string - type: 'null' title: Google Place Id latitude: title: Latitude type: number location_type: anyOf: - type: string - type: 'null' title: Location Type longitude: title: Longitude type: number required: - latitude - longitude title: Geolocation type: object DeveloperConversationStructured: properties: action_items: default: [] items: $ref: '#/components/schemas/DeveloperConversationActionItem' title: Action Items type: array category: $ref: '#/components/schemas/CategoryEnum' emoji: default: 🧠 title: Emoji type: string events: default: [] items: $ref: '#/components/schemas/DeveloperConversationEvent' title: Events type: array overview: title: Overview type: string title: title: Title type: string required: - title - overview - category title: DeveloperConversationStructured type: object DeveloperTranscriptSegment: properties: end: title: End type: number id: anyOf: - type: string - type: 'null' title: Id speaker_id: anyOf: - type: integer - type: 'null' title: Speaker Id speaker_name: anyOf: - type: string - type: 'null' title: Speaker Name start: title: Start type: number text: title: Text type: string required: - text - start - end title: DeveloperTranscriptSegment type: object ErrorResponse: properties: detail: anyOf: - type: string - type: array - type: object description: Error detail returned by the API. required: - detail title: ErrorResponse type: object ValidationError: properties: loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object DeveloperConversationActionItem: properties: completed: default: false title: Completed type: boolean completed_at: anyOf: - format: date-time type: string - type: 'null' title: Completed At conversation_id: anyOf: - type: string - type: 'null' title: Conversation Id created_at: anyOf: - format: date-time type: string - type: 'null' title: Created At description: title: Description type: string due_at: anyOf: - format: date-time type: string - type: 'null' title: Due At updated_at: anyOf: - format: date-time type: string - type: 'null' title: Updated At required: - description title: DeveloperConversationActionItem type: object CategoryEnum: enum: - personal - education - health - finance - legal - philosophy - spiritual - science - entrepreneurship - parenting - romantic - travel - inspiration - technology - business - social - work - sports - politics - literature - history - architecture - music - weather - news - entertainment - psychology - real - design - family - economics - environment - other title: CategoryEnum type: string DeveloperConversationEvent: properties: created: default: false title: Created type: boolean description: default: '' title: Description type: string duration: default: 30 title: Duration type: integer start: format: date-time title: Start type: string title: title: Title type: string required: - title - start title: DeveloperConversationEvent type: object responses: Error401: content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Missing or invalid authentication credentials. Error403: content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Authenticated, but the token does not grant the required scope. securitySchemes: developerApiKey: bearerFormat: Omi Developer API key description: 'Send `Authorization: Bearer `.' scheme: bearer type: http ````