> ## Documentation Index > Fetch the complete documentation index at: https://docs.dimedove.com/llms.txt > Use this file to discover all available pages before exploring further. # List user conversations > Returns a paginated list of conversations belonging to a specific external user. Uses the same cursor-based pagination as the list conversations endpoint. ## OpenAPI ````yaml /openapi/apps-api.json get /apps/{app_id}/users/{external_user_id}/conversations openapi: 3.1.0 info: title: Dimedove API version: 1.0.0 description: >- Programmatically manage conversations and interact with your AI agents through the Dimedove API. servers: - url: https://api.dimedove.com/v1 description: Production security: [] paths: /apps/{app_id}/users/{external_user_id}/conversations: get: tags: - Conversations summary: List user conversations description: >- Returns a paginated list of conversations belonging to a specific external user. Uses the same cursor-based pagination as the list conversations endpoint. operationId: apps_api_list_user_conversations parameters: - in: path name: app_id schema: description: The unique identifier of the app. title: App Id type: string required: true description: The unique identifier of the app. - in: path name: external_user_id schema: description: The external user identifier to filter conversations by. title: External User Id type: string required: true description: The external user identifier to filter conversations by. - in: query name: limit schema: default: 20 description: 'Maximum number of conversations to return. Range: 1-100.' title: Limit type: integer required: false description: 'Maximum number of conversations to return. Range: 1-100.' - in: query name: after schema: description: >- A cursor for forward pagination. Returns conversations created after the conversation with this ID. title: After type: string required: false description: >- A cursor for forward pagination. Returns conversations created after the conversation with this ID. - in: query name: before schema: description: >- A cursor for backward pagination. Returns conversations created before the conversation with this ID. title: Before type: string required: false description: >- A cursor for backward pagination. Returns conversations created before the conversation with this ID. - in: query name: order schema: default: desc description: Sort order by creation time. Either 'asc' or 'desc'. title: Order type: string required: false description: Sort order by creation time. Either 'asc' or 'desc'. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ConversationListSchema' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/OpenAIErrorSchema' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/OpenAIErrorSchema' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/OpenAIErrorSchema' security: - AppsApiKeyAuth: [] components: schemas: ConversationListSchema: properties: object: default: list description: The object type. Always 'list'. title: Object type: string data: description: The array of conversation objects for the current page. items: $ref: '#/components/schemas/ConversationSchema' title: Data type: array first_id: anyOf: - type: string - type: 'null' description: >- The ID of the first conversation in the returned page. Null if the list is empty. title: First Id last_id: anyOf: - type: string - type: 'null' description: >- The ID of the last conversation in the returned page. Null if the list is empty. title: Last Id has_more: default: false description: >- Whether there are additional conversations beyond this page. Use the 'after' or 'before' query parameters to paginate. title: Has More type: boolean required: - data title: ConversationListSchema type: object OpenAIErrorSchema: properties: error: $ref: '#/components/schemas/OpenAIErrorDetail' description: The error detail object. required: - error title: OpenAIErrorSchema type: object ConversationSchema: properties: id: description: Unique identifier for the conversation. title: Id type: string object: default: conversation description: The object type. Always 'conversation'. title: Object type: string created_at: description: Unix timestamp (in seconds) of when the conversation was created. title: Created At type: integer external_user_id: anyOf: - type: string - type: 'null' description: >- The external user identifier associated with this conversation, if one was provided at creation. title: External User Id title: anyOf: - type: string - type: 'null' description: The custom title set for this conversation, if any. title: Title generated_title: anyOf: - additionalProperties: type: string type: object - type: 'null' description: >- AI-generated conversation title in supported locales. Keys are locale codes (e.g. 'en-ca', 'fr-ca'). example: en-ca: fr-ca: title: Generated Title metadata: anyOf: - additionalProperties: true type: object - type: 'null' description: >- The latest metadata snapshot associated with this conversation, if any has been provided. title: Metadata required: - id - created_at title: ConversationSchema type: object OpenAIErrorDetail: properties: message: description: A human-readable description of the error. title: Message type: string type: description: >- The error type identifier (e.g. 'invalid_api_key', 'not_found', 'rate_limit_exceeded'). title: Type type: string param: anyOf: - type: string - type: 'null' description: The parameter that caused the error, if applicable. title: Param code: anyOf: - type: string - type: 'null' description: An error code providing additional detail, if applicable. title: Code required: - message - type title: OpenAIErrorDetail type: object securitySchemes: AppsApiKeyAuth: type: http scheme: bearer ````