> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.goextrovert.com/llms.txt > Use this file to discover all available pages before exploring further. # List conversations > Lists an owner's LinkedIn conversations in the required unread or all view. It returns preview, unread count, active workflow state, and valid next actions without marking anything read. ## OpenAPI ````yaml https://api.goextrovert.com/client/v2/docs-json get /client/v2/dm-conversations openapi: 3.0.0 info: title: Extrovert Client API description: >- Public API for Extrovert platform integration. Use your API key for authentication. version: '1.0' contact: {} servers: - url: https://api.goextrovert.com/ description: API Server security: [] tags: [] paths: /client/v2/dm-conversations: get: tags: - Direct Messages summary: List conversations description: >- Lists an owner's LinkedIn conversations in the required unread or all view. It returns preview, unread count, active workflow state, and valid next actions without marking anything read. operationId: DmConversationsClientApiController_getList parameters: - description: >- LinkedIn account owner whose inbox is being read. Often a managed account rather than the authenticated user — call `user_list-shared` first and pick the owner whose LinkedIn profile holds the conversations. required: true name: ownerId in: query schema: type: string format: uuid - description: Required lowercase inbox view. Suggested is not accepted. required: true name: view in: query schema: enum: - unread - all type: string - description: Optional campaign filter. required: false name: campaignId in: query schema: type: string format: uuid - description: Optional Prospect List filter. required: false name: prospectListId in: query schema: type: string format: uuid - description: Optional case-insensitive prospect/conversation search text. required: false name: search in: query schema: type: string minLength: 1 - description: Number of records requested for this page. required: false name: limit in: query schema: minimum: 1 maximum: 50 default: 20 type: integer - description: Offset from the start of the filtered result set. required: false name: offset in: query schema: minimum: 0 maximum: 9007199254740991 default: 0 type: integer responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/GetListResponseDto4' '401': description: Invalid or missing API key. content: application/json: schema: $ref: '#/components/schemas/ClientApiErrorResponseDto' security: - api-key: [] components: schemas: GetListResponseDto4: type: object properties: status: type: string description: Response status enum: - success data: type: object properties: conversations: type: array items: type: object properties: connectionId: type: string format: uuid description: Stable conversation (connection) ID. example: 8d256aa6-9b12-49a7-93ee-bf41634b5b60 ownerId: type: string format: uuid description: >- LinkedIn account owner whose inbox contains this conversation. example: 8d256aa6-9b12-49a7-93ee-bf41634b5b60 prospect: type: object properties: id: type: string format: uuid description: >- Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available. nullable: true name: type: string description: Person's current LinkedIn display name. linkedInUrl: type: string format: uri description: LinkedIn profile URL, or null when it is unavailable. nullable: true headline: type: string description: LinkedIn headline, or null when it is unavailable. nullable: true avatarUrl: type: string format: uri description: Profile image URL, or null when it is unavailable. nullable: true required: - id - name - linkedInUrl - headline - avatarUrl description: LinkedIn conversation counterpart. context: type: object properties: campaign: type: object properties: id: type: string format: uuid description: Stable Extrovert entity ID. example: 8d256aa6-9b12-49a7-93ee-bf41634b5b60 name: type: string description: Customer-facing entity name. required: - id - name description: >- Selected accessible campaign context, or null when no workspace lead binding exists. nullable: true prospectList: type: object properties: id: type: string format: uuid description: Stable Extrovert entity ID. example: 8d256aa6-9b12-49a7-93ee-bf41634b5b60 name: type: string description: Customer-facing entity name. required: - id - name description: Selected Prospect List, or null when none applies. nullable: true required: - campaign - prospectList connectedAt: type: string description: Known LinkedIn connection date, or null when unavailable. nullable: true example: '2025-06-30T14:02:07.456Z' lastMessage: type: object properties: text: type: string description: Latest delivered message text. author: type: string enum: - Owner - Prospect description: >- Which side of the LinkedIn conversation sent the message. sentAt: type: string description: Delivery time of the latest delivered message. example: '2025-06-30T14:02:07.456Z' required: - text - author - sentAt description: >- Latest delivered message preview, or null for an empty history. nullable: true unreadCount: type: integer minimum: 0 maximum: 9007199254740991 description: Unread delivered messages in this conversation. state: type: string enum: - No draft - Suggested - Draft ready - Generating - Sending - Sent - History changed - Error - Paused - Skipped allowedActions: type: array items: type: string enum: - prepare-reply - improve-reply - edit-reply - send-reply - recover-draft description: Actions valid for the current state. required: - connectionId - ownerId - prospect - context - connectedAt - lastMessage - unreadCount - state - allowedActions pagination: description: Pagination information, if returned by the backend type: object properties: limit: type: integer minimum: 0 maximum: 9007199254740991 description: Number of records requested for this page. offset: type: integer minimum: 0 maximum: 9007199254740991 description: Offset from the start of the filtered result set. total: type: integer minimum: 0 maximum: 9007199254740991 description: Total records available for the same filters. required: - limit - offset - total message: type: string description: Success message example: Operation completed successfully required: - status - data - message ClientApiErrorResponseDto: type: object properties: status: type: string description: Response status example: error enum: - error data: type: object description: Response data example: null nullable: true message: type: string description: Error message example: An error occurred while processing the request required: - status - data securitySchemes: api-key: type: apiKey in: header name: X-API-Key description: API Key for authentication ````