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

# User Stats

> Generation statistics for the authenticated user

## Request

```bash theme={null}
curl https://elumenta.ru/api/v2/user/stats \
  -H "Authorization: Bearer nb_YOUR_API_KEY"
```

## Response

```json theme={null}
{
  "total_generations": 842,
  "tokens_spent_total": 4210,
  "breakdown": {
    "text": { "count": 510, "tokens": 1020 },
    "image": { "count": 211, "tokens": 2110 },
    "video": { "count": 48, "tokens": 864 },
    "audio": { "count": 53, "tokens": 159 },
    "tools": { "count": 20, "tokens": 22 }
  },
  "recent_30d": {
    "generations": 128,
    "tokens_spent": 640
  }
}
```

<ResponseField name="total_generations" type="integer">
  Total number of completed generations since account creation.
</ResponseField>

<ResponseField name="tokens_spent_total" type="integer">
  Total tokens spent across all time.
</ResponseField>

<ResponseField name="breakdown" type="object">
  Generation count and token spend split by category: `text`, `image`, `video`, `audio`, `tools`.
</ResponseField>

<ResponseField name="recent_30d" type="object">
  Stats for the last 30 days only.
</ResponseField>
