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

# List the questions people ask most

> The questions asked most in a period, similar ones counted together: a wording, how often asked and answered, and where. Never who asked.

Each row is a question people asked your assistants, with questions that mean the same thing counted together. A row carries a representative wording, how many times it was asked, how many of those the assistant answered and how many it declined, and the kinds of caller it came from. See [Top questions](https://docs.mithunai.com/analyze/top-questions.md).

A row never says who asked, when, or in which conversation, and there is no parameter that narrows the list to a person. A question is listed only when at least `minimum_askers` different askers asked it. Everything else is counted in `other` and its wording is not returned.

Rows cover the most recent 2,000 questions of the window that were answered or declined. `total` counts every such question in the window; `analysed` says how many of them were looked at.

Every read is recorded in your organization's audit trail.

Because this returns wording other people used, it requires the owner or admin role. Editors, members and dataset operators receive `403`, even though editors can read [usage counts](https://docs.mithunai.com/administration/analytics.md).

**window** `string` (default: 30d)

Trailing window ending now: `7d`, `30d` or `90d`. Any other value returns `400`.

**assistant\_id** `string`

Limit the results to one assistant (UUID). A malformed ID returns `400`; an ID from another
organization matches nothing.

**limit** `integer` (default: 20)

Maximum questions to return, from 1 to 50. ASCII digits only. Questions past the limit are counted
in `other`.

## Response

**window** `object` *required*

The window searched. These are the only timestamps in the response.

**properties**

**start** `string` *required*

Inclusive start, ISO 8601 in UTC.

**end** `string` *required*

Exclusive end, ISO 8601 in UTC.

**total** `integer` *required*

Questions answered or declined in the window.

**analysed** `integer` *required*

How many of `total` were looked at, newest first. Less than `total` only when the window holds
more than 2,000 questions.

**grouping** `string` *required*

How similar questions were counted together. `meaning`: every wording was compared by meaning.
`partial`: the most asked wordings were compared by meaning and the rest by wording only.
`wording`: all were compared by wording only, so two questions that mean the same thing in
different words are separate rows. Treat a value you do not recognise as `partial`.

**minimum\_askers** `integer` *required*

The fewest different askers a question needed to be listed. Never less than 3.

**questions** `object[]` *required*

At most `limit` questions, most asked first.

**properties**

**question** `string` *required*

The wording most askers used, at most 200 characters. Email addresses, long numbers and
recognised credentials are replaced with `[email]`, `[number]` and `[REDACTED SECRET]`.

**count** `integer` *required*

Times asked. Equals `answered` plus `declined`.

**answered** `integer` *required*

Times the assistant answered.

**declined** `integer` *required*

Times the assistant said it could not answer from its sources.

**channels** `string[]` *required*

The kinds of caller that asked, sorted: `user` (the console), `service` (an API key, which is
also how MCP clients sign in) and `widget`. Names only: there is no count per kind.

**other** `integer` *required*

Analysed questions that are not listed: those fewer than `minimum_askers` askers asked, and those
past `limit`. `other` plus the listed counts equals `analysed`.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/analytics/top-questions?window=30d&limit=10" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY"
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import os, requests

response = requests.get(
    f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/analytics/top-questions",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    params={"window": "30d", "limit": 10},
    timeout=60,
)
response.raise_for_status()
print(response.json())
```

```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const params = new URLSearchParams({ window: '30d', limit: '10' })
const response = await fetch(
  `${process.env.MITHUNAI_URL}/mithunai/api/v1/analytics/top-questions?${params}`,
  {
    headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
  },
)
console.log(await response.json())
```

```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "window": {
    "start": "2026-08-25T10:00:03.214557+00:00",
    "end": "2026-09-24T10:00:03.214557+00:00"
  },
  "total": 1240,
  "analysed": 1240,
  "grouping": "meaning",
  "minimum_askers": 3,
  "questions": [
    {
      "question": "How do I reset my password?",
      "count": 42,
      "answered": 39,
      "declined": 3,
      "channels": ["user", "widget"]
    },
    {
      "question": "Does the SDK support retries with exponential backoff?",
      "count": 17,
      "answered": 0,
      "declined": 17,
      "channels": ["service", "widget"]
    }
  ],
  "other": 1181
}
```

```json 400 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{ "code": "validation_error", "message": "'window' must be one of 7d, 30d, 90d." }
```

```json 403 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.