> ## 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 recommended conversations > Lists the owner's conversations Extrovert recommends writing to now, newest recommendation first (recommendations without an appearance date last): why each one is recommended, which follow-up is due, the active reply ID and whether that reply is already written and ready for review. Reading never marks anything read and never generates a reply. ## OpenAPI ````yaml https://api.goextrovert.com/client/v2/docs-json get /client/v2/dm-conversations/recommended openapi: 3.1.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/recommended: get: tags: - Direct Messages summary: List recommended conversations description: >- Lists the owner's conversations Extrovert recommends writing to now, newest recommendation first (recommendations without an appearance date last): why each one is recommended, which follow-up is due, the active reply ID and whether that reply is already written and ready for review. Reading never marks anything read and never generates a reply. operationId: DmConversationsClientApiController_getRecommendedList parameters: - description: >- LinkedIn account owner whose conversations are addressed. Often a managed account rather than the authenticated user. required: true name: ownerId in: query schema: type: string format: uuid - description: >- Optional campaign filter. When omitted, the list covers all campaigns of the owner that the caller can access — never conversations outside those campaigns. 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: 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: 2147483647 default: 0 type: integer responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/GetRecommendedListResponseDto' '401': description: Invalid or missing API key. content: application/json: schema: $ref: '#/components/schemas/ClientApiErrorResponseDto' security: - api-key: [] components: schemas: GetRecommendedListResponseDto: type: object properties: status: type: string const: success description: Response status data: type: object properties: conversations: type: array items: type: object properties: connectionId: type: string format: uuid description: Stable conversation (connection) ID. examples: - 8d256aa6-9b12-49a7-93ee-bf41634b5b60 ownerId: type: string format: uuid description: >- LinkedIn account owner whose inbox contains this conversation. examples: - 8d256aa6-9b12-49a7-93ee-bf41634b5b60 campaign: anyOf: - type: object properties: id: type: string format: uuid description: Stable Extrovert entity ID. examples: - 8d256aa6-9b12-49a7-93ee-bf41634b5b60 name: type: string description: Customer-facing entity name. required: - id - name - type: 'null' description: >- Accessible campaign the prospect belongs to, or null when no workspace lead binding exists. prospect: type: object properties: id: anyOf: - type: string format: uuid - type: 'null' description: >- Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available. name: type: string description: Person's current LinkedIn display name. linkedInUrl: anyOf: - type: string format: uri - type: 'null' description: LinkedIn profile URL, or null when it is unavailable. headline: anyOf: - type: string - type: 'null' description: LinkedIn headline, or null when it is unavailable. avatarUrl: anyOf: - type: string format: uri - type: 'null' description: Profile image URL, or null when it is unavailable. required: - id - name - linkedInUrl - headline - avatarUrl description: LinkedIn conversation counterpart. reason: anyOf: - type: string enum: - Relevant post - Follow-up - First outreach - Manual - type: 'null' description: >- Why Extrovert recommends writing to this conversation, or null when unknown. followUpNumber: anyOf: - type: integer minimum: 1 maximum: 9007199254740991 - type: 'null' description: >- Which follow-up of the unanswered series is due, counting from 1. Null outside a follow-up series. examples: - 1 - 3 state: type: string enum: - No draft - Suggested - Draft ready - Generating - Sending - Sent - History changed - Error - Paused - Skipped dmId: anyOf: - type: string format: uuid description: Entity ID examples: - 8d256aa6-9b12-49a7-93ee-bf41634b5b60 - type: 'null' description: >- Exact ID of the conversation's active reply, or null when it has none. Never the conversation ID. isReplyReady: type: boolean description: >- True only when the active reply is written and ready for review; a recommendation without text yet is false. recommendedAt: anyOf: - type: string description: Date and time in ISO 8601 format examples: - '2025-06-30T14:02:07.456Z' - '2025-07-03T08:30:00.000Z' - type: 'null' description: >- When this recommendation appeared or returned (a snoozed one: when its snooze ends). Null for recommendations older than this field, which count as already known. lastMessageAt: anyOf: - type: string description: Date and time in ISO 8601 format examples: - '2025-06-30T14:02:07.456Z' - '2025-07-03T08:30:00.000Z' - type: 'null' description: >- Date of the latest delivered message, or null for an empty history. required: - connectionId - ownerId - campaign - prospect - reason - followUpNumber - state - dmId - isReplyReady - recommendedAt - lastMessageAt 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 required: - conversations - pagination message: type: string description: Success message examples: - 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 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.