> ## Documentation Index > Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get conversations analytics > Retrieve row conversation analytics data with contact and campaign information. > **Required scope:** `ANALYTICS_READ` > > **Rate limit:** 10 requests per minute ## OpenAPI ````yaml https://openapi.enginy.ai/definitions.json get /v1/analytics/conversations openapi: 3.1.0 info: title: Enginy API version: 1.0.0 description: Public API for Enginy platform servers: - url: https://openapi.enginy.ai description: Configured server security: [] tags: - name: AI Variables description: >- Manage AI variables and discover the entity fields you can reference in prompts and entity requests. - name: Inbox description: >- Inbox endpoints for listing contact threads, reading thread messages, managing tags, and sending manual replies. - name: Workflows description: >- Build, validate, publish, run, and inspect advanced (graph) workflows, plus the block/condition catalog needed to author a workflow plan. paths: /v1/analytics/conversations: get: tags: - Campaigns summary: Get conversations analytics description: >- Retrieve row conversation analytics data with contact and campaign information. > **Required scope:** `ANALYTICS_READ` > > **Rate limit:** 10 requests per minute parameters: - schema: anyOf: - type: string - type: array items: type: string description: >- Filter by user IDs who created the campaigns (comma-separated or array). required: false description: >- Filter by user IDs who created the campaigns (comma-separated or array). name: createdByIds in: query - schema: anyOf: - type: string - type: array items: type: string description: Filter by sender identity IDs (comma-separated or array). required: false description: Filter by sender identity IDs (comma-separated or array). name: identityIds in: query - schema: anyOf: - type: string - type: array items: type: string description: Filter by campaign IDs (comma-separated or array). required: false description: Filter by campaign IDs (comma-separated or array). name: campaignIds in: query - schema: anyOf: - type: string - type: array items: type: string description: Filter by campaign tag IDs (comma-separated or array). required: false description: Filter by campaign tag IDs (comma-separated or array). name: campaignTags in: query - schema: anyOf: - type: string - type: array items: type: string description: Filter by conversation tag IDs (comma-separated or array). required: false description: Filter by conversation tag IDs (comma-separated or array). name: conversationTags in: query - schema: anyOf: - type: string - type: array items: type: string description: >- Date range filter as [startDate, endDate] in ISO format. Defaults to last 30 days. required: false description: >- Date range filter as [startDate, endDate] in ISO format. Defaults to last 30 days. name: dateRange in: query - schema: anyOf: - type: string - type: array items: type: string description: >- Specific contact fields to include in the response (comma-separated or array). Use `GET /v1/contacts/fields` (MCP tool `get_contact_field_metadata`) to discover valid contact field names. required: false description: >- Specific contact fields to include in the response (comma-separated or array). Use `GET /v1/contacts/fields` (MCP tool `get_contact_field_metadata`) to discover valid contact field names. name: fields in: query - schema: type: string enum: - CONTACT - USER description: >- Filter by who sent the last message: CONTACT (contact sent last message) or USER (sender sent last message). required: false description: >- Filter by who sent the last message: CONTACT (contact sent last message) or USER (sender sent last message). name: lastMessageSentBy in: query responses: '200': description: Successful response with row conversation analytics content: application/json: schema: type: array items: type: object properties: conversationId: type: number description: Unique identifier for the conversation firstMessageAt: type: string description: Timestamp when the first message was sent contactId: type: number description: Contact ID campaignId: type: number description: Campaign ID linkedinSent: type: number description: Number of LinkedIn messages sent linkedinReplied: type: number description: Number of LinkedIn replies received emailSent: type: number description: Number of emails sent emailOpened: type: number description: Number of email opens emailClicked: type: number description: Number of email clicks emailReplied: type: number description: Number of email replies received conversationTags: type: - string - 'null' description: Comma-separated list of conversation tags campaignName: type: string description: Name of the campaign campaignStatus: type: string description: Status of the campaign identityName: type: string description: >- Name of the sender identity that engaged this conversation (the campaign primary identity when the conversation is not pinned to a specific one) conversationIdentityId: type: - number - 'null' description: >- ID of the identity this conversation is pinned to in a multi-sender campaign, or null when it runs under the campaign primary identity companyId: type: - number - 'null' description: Company ID associated with the contact isArchived: type: boolean description: Whether the conversation contact has been archived lastMessageSentBy: type: - string - 'null' enum: - CONTACT - USER - null description: 'Who sent the last message: CONTACT or USER' required: - conversationId - firstMessageAt - contactId - campaignId - linkedinSent - linkedinReplied - emailSent - emailOpened - emailClicked - emailReplied - conversationTags - campaignName - campaignStatus - identityName - conversationIdentityId - companyId - isArchived - lastMessageSentBy security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key ````