---
title: "List Users"
method: GET
path: "/admin/users"
tags: ["internal", "Admin - Users"]
---

# List Users

`GET /admin/users`

## Request

- Base URL: `https://api.companydata.dk` (the document declares no server; this is the origin it was published from)
- URL: `https://api.companydata.dk/admin/users`
- Auth: none declared

List users with optional filters and pagination.

## Query parameters

- `include_deleted` boolean: Include deleted users in the list
- `tier` string, nullable: Filter by subscription tier: basic, pro, enterprise
- `has_api_calls` boolean: Only users with 1+ API calls this month
- `churn_risk` boolean: Only users whose org is canceling, past due or unpaid
- `page` integer: 1-based page number
- `page_size` integer: Page size (max 200)

## Response `200`

Successful Response

- UsersListResponse
  - `data` UserListItem[], required
    - `id` string, required
    - `email` string, required
    - `name` string, nullable, required
    - `is_admin` boolean, required
    - `subscription_tier` string, required
    - `api_keys_count` integer, required
    - `total_api_calls` integer
    - `created_at` string, date-time, required
    - `deleted_at` string, date-time, nullable
    - `usage_status` string
    - `billing_status` string
    - `billing_date` string, date-time, nullable
  - `total` integer, required
  - `page` integer
  - `page_size` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/companydata/apis/companydata-dk-api.md) · [All operations](https://skmtc.dev/companydata/apis/companydata-dk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/companydata/apis/companydata-dk-api/revisions/1cc6c361ae64?raw)