# Get assistant caller stats (/api/analytics/assistant-caller-stats)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1218 · updated: 2026-07-30 -->
Related: [Get feedback](/api/analytics/feedback.md), [Get feedback by page](/api/analytics/feedback-by-page.md), [Get assistant conversations](/api/analytics/assistant-conversations.md), [Get search queries](/api/analytics/searches.md), [Get page views](/api/analytics/views.md), [Get unique visitors](/api/analytics/visitors.md)

## Usage [#usage]

Use this endpoint to see how the system distributes assistant queries across different caller types. The response breaks down total queries into:

* `web`: Queries from the documentation site
* `api`: Queries from direct API calls
* `other`: Queries from other sources (for example, integrations, SDKs)
* **total**: Sum of all query types

## Filtering [#filtering]

Filter by date range using `dateFrom` and `dateTo` parameters.

## Rate limits [#rate-limits]

This endpoint allows 100 requests per organization per hour. All analytics endpoints share this limit.

`GET /v1/analytics/{projectId}/assistant/caller-stats`

Returns a breakdown of assistant query counts by caller type (web, API, and other) for the specified date range.

Authenticate with an admin API key.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "schema": {
        "type": "string",
        "description": "Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard."
      },
      "required": true,
      "name": "projectId",
      "in": "path"
    },
    {
      "schema": {
        "type": "string",
        "description": "Date in ISO 8601 or YYYY-MM-DD format",
        "example": "2024-01-01"
      },
      "required": false,
      "name": "dateFrom",
      "in": "query"
    },
    {
      "schema": {
        "type": "string",
        "description": "Date in ISO 8601 or YYYY-MM-DD format. `dateTo` is an exclusive upper limit. Results include dates before, but not on, the specified date.",
        "example": "2024-01-01"
      },
      "required": false,
      "name": "dateTo",
      "in": "query"
    }
  ],
  "responses": {
    "200": {
      "description": "Assistant query counts broken down by caller type",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "web": {
                "type": "number",
                "description": "Number of assistant queries originating from the web (documentation site)."
              },
              "api": {
                "type": "number",
                "description": "Number of assistant queries originating from API calls."
              },
              "other": {
                "type": "number",
                "description": "Number of assistant queries from other sources (e.g., integrations, SDKs)."
              },
              "total": {
                "type": "number",
                "description": "Total assistant queries across all caller types."
              }
            },
            "required": [
              "web",
              "api",
              "other",
              "total"
            ]
          }
        }
      }
    },
    "400": {
      "description": "Invalid query parameters",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Error message describing what went wrong."
              },
              "details": {
                "type": "array",
                "description": "Additional details about the error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Description of a specific validation or processing error."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    },
    "500": {
      "description": "Server error",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Error message describing what went wrong."
              },
              "details": {
                "type": "array",
                "description": "Additional details about the error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Description of a specific validation or processing error."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    }
  }
}
```