---
title: "Get the caller's usage stats."
method: GET
path: "/v1/user/stats"
tags: ["Metering"]
---

# Get the caller's usage stats.

`GET /v1/user/stats`

## Request

- Base URL: `https://api.scalix.world`
- URL: `https://api.scalix.world/v1/user/stats`
- Auth: HTTP bearer

Returns a per-service usage breakdown (AI, storage, compute, bandwidth,
functions) for the current month.

## Response `200`

Per-service usage for the current month

- StatsResponse: Response for `GET /v1/user/stats`.
  - `user_id` string, required
  - `period` string, required
  - `services` StatsServices, required: Per-service usage breakdown.
    - `ai` AiStat, required
      - `tokens_used` number, double, required
    - `storage` StorageStat, required
      - `gb_used` number, double, required
    - `compute` ComputeStat, required
      - `hours_used` number, double, required
    - `bandwidth` BandwidthStat, required
      - `gb_used` number, double, required
    - `functions` FunctionsStat, required
      - `invocations` number, double, required

## Other responses

- `401`: Missing or invalid credentials
- `500`: Database error

---

[API](https://skmtc.dev/scalix/apis/scalix-cloud-api.md) · [All operations](https://skmtc.dev/scalix/apis/scalix-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scalix/apis/scalix-cloud-api/revisions/2c04ca0a90bb?raw)