> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ringg.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Drill-Down Analytics

> Retrieves detailed analytics for a specific bulk list/campaign with drill-down capabilities.

Return detailed analytics for one campaign or bulk list. This is the endpoint to use when a dashboard user clicks from a summary metric into campaign performance.

## Required input

* `bulk_list_id`: the campaign/contact-list identifier returned by campaign upload and used when starting the campaign.

## Use this for

* Campaign performance views.
* Status and outcome breakdowns.
* Detailed campaign troubleshooting.

Pair it with [Get call history](/api-reference/endpoint/history/get-call-history) filtered by the same `bulk_list_id` when users need call-level rows.


## OpenAPI

````yaml get /analytics/drill-down-analytics
openapi: 3.0.0
info:
  title: Ringg AI API Documentation
  description: >-
    This is the documentation for the Ringg AI APIs. The Ringg AI API follows
    RESTful principles, making it intuitive and easy to integrate with your
    applications. All API requests should be made to the base URL. The API
    accepts and returns data in JSON format. Ensure your requests include the
    appropriate Content-Type header for POST and PATCH requests.
  version: 2.0.0
servers:
  - url: https://prod-api.ringg.ai/ca/api/v0
security: []
tags:
  - name: workspace
    description: Endpoints for managing your workspace.
  - name: agent
    description: Endpoints for managing assistants (agents).
  - name: calling
    description: Endpoints for making and managing calls.
  - name: campaign
    description: Endpoints for managing campaigns.
  - name: analytics
    description: Endpoints for accessing call analytics and performance metrics.
  - name: termination
    description: Endpoints for terminating active calls using different methods.
  - name: knowledgebase
    description: Endpoints for managing knowledge bases.
paths:
  /analytics/drill-down-analytics:
    get:
      tags:
        - analytics
      summary: Get Drill-Down Analytics
      description: >-
        Retrieves detailed analytics for a specific bulk list/campaign with
        drill-down capabilities.
      operationId: getDrillDownAnalytics
      parameters:
        - name: X-API-KEY
          in: header
          description: (Required) Your Ringg AI API key.
          required: true
          schema:
            type: string
            example: 7251cb4b-3373-43a4-844c-b27a1d45e0c9
        - name: bulk_list_id
          in: query
          description: (Required) Bulk list/campaign ID to get drill-down analytics for
          required: true
          schema:
            type: string
            example: 123e4567-e89b-12d3-a456-426614174000
        - name: start_date
          in: query
          description: Start date for analytics filter (YYYY-MM-DD format)
          required: false
          schema:
            type: string
            default: '2025-09-25'
            example: '2025-09-25'
        - name: end_date
          in: query
          description: End date for analytics filter (YYYY-MM-DD format)
          required: false
          schema:
            type: string
            default: '2025-09-25'
            example: '2025-09-25'
        - name: agent_id
          in: query
          description: Filter by specific agent ID
          required: false
          schema:
            type: string
            example: 123e4567-e89b-12d3-a456-426614174000
        - name: voicemail
          in: query
          description: Filter by voicemail status
          required: false
          schema:
            type: boolean
            example: false
      responses:
        '200':
          description: Drill-down analytics retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  performance_metrics:
                    type: object
                    description: Detailed performance metrics for the bulk list
                  cached:
                    type: boolean
                    description: Whether the response was served from cache
        '400':
          description: Bad Request - Missing required bulk_list_id parameter.
        '401':
          description: Unauthorized - Invalid or missing authentication.
        '500':
          description: Internal Server Error.

````