---
title: "GET /enterprise/license/user_counts/"
method: GET
path: "/enterprise/license/user_counts/"
tags: ["enterprise"]
---

# GET /enterprise/license/user_counts/

`GET /enterprise/license/user_counts/`

Get active user totals and counts for relative or absolute date ranges.

At least one positive relative count step or a complete absolute range is required.
Relative and absolute ranges may be combined. Range starts are inclusive and ends are
exclusive. Counts include currently active, non-anonymous accounts.

## Query parameters

- `count_steps` string[]
- `end` string, date-time
- `start` string, date-time

## Response `200`

- LicenseUserCounts — Current active user totals and counts for requested date ranges.
  - `active_internal_users` integer, required
  - `active_external_users` integer, required
  - `ranges` LicenseUserCountRange[], required
    - `start` string, date-time, required
    - `end` string, date-time, required
    - `interval` string, nullable, required
    - `internal_users_added` integer, required
    - `external_users_added` integer, required

## Other responses

- `400`
- `403`

## Changes

- **2026-09-29** `063b7e0f2ab0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/goauthentik/apis/authentik/changes/enterprise/license/user_counts/get.md)

---

[API](https://skmtc.dev/goauthentik/apis/authentik.md) · [All operations](https://skmtc.dev/goauthentik/apis/authentik/llms.txt) · [OpenAPI document](https://skmtc.dev/goauthentik/apis/authentik/revisions/063b7e0f2ab0?raw)
