---
title: "Summarize users"
method: GET
path: "/admin/billing/stats/users"
tags: ["Billing"]
---

# Summarize users

`GET /admin/billing/stats/users`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/admin/billing/stats/users`
- Auth: API key in header `x-api-key`

Admin-only endpoint that returns total/new/email-verified/banned user counts, product activation and 7-day retention, plus breakdowns by plan, provider, and signup locale. Product activation means at least one successful 2xx API request; 7-day retention means another successful request on or after day 7. Without an explicit time range the new-user window defaults to the last 30 days.

## Query parameters

- `from` string
- `to` string

## Headers

- `x-api-key` string, required

## Response `200`

User stats

- BillingAdminUserStatsResponseDoc
  - `code` integer
  - `data` BillingAdminUserStatsDoc
    - `activated_total` integer
    - `banned_total` integer
    - `by_browser_language` BillingAdminUserDimensionCountDoc[]
      - `count` integer
      - `key` string
    - `by_locale` BillingAdminUserDimensionCountDoc[]
      - `count` integer
      - `key` string
    - `by_plan` BillingAdminUserDimensionCountDoc[]
      - `count` integer
      - `key` string
    - `by_provider` BillingAdminUserDimensionCountDoc[]
      - `count` integer
      - `key` string
    - `email_verified_total` integer
    - `new_users` integer
    - `product_activated_total` integer
    - `retained_7d_total` integer
    - `total_users` integer
  - `msg` string

## Other responses

- `400`: Invalid query parameters
- `401`: Authentication required
- `403`: Admin plan required
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)