---
title: "A List with the details and statistic of all registered users"
method: GET
path: "/v2/users"
tags: ["v2"]
---

# A List with the details and statistic of all registered users

`GET /v2/users`

## Query parameters

- `page` integer
- `sort` string

## Headers

- `Client-Agent` string
- `X-Fields` string, mask

## Response `200`

Users List

- UserDetails
  - `username` string — The user's unique Username. It is a combination of their chosen alias plus their ID.
  - `id` integer — The user unique ID. It is always an integer.
  - `kudos` number — The amount of Kudos this user has. The amount of Kudos determines the priority when requesting image generations.
  - `evaluating_kudos` number — (Privileged) The amount of Evaluating Kudos this untrusted user has from generations and uptime. When this number reaches a prespecified threshold, they automatically become trusted.
  - `concurrency` integer — How many concurrent generations this user may request.
  - `worker_invited` integer — Whether this user has been invited to join a worker to the AI Horde and how many of them. When 0, this user cannot add (new) workers to the horde.
  - `moderator` boolean — This user is a AI Horde moderator.
  - `kudos_details` UserKudosDetails
    - `accumulated` number — The ammount of Kudos accumulated or used for generating images.
    - `gifted` number — The amount of Kudos this user has given to other users.
    - `donated` number — The amount of Kudos this user has donated to public goods accounts like education.
    - `admin` number — The amount of Kudos this user has been given by the AI Horde admins.
    - `received` number — The amount of Kudos this user has been given by other users.
    - `recurring` number — The amount of Kudos this user has received from recurring rewards.
    - `awarded` number — The amount of Kudos this user has been awarded from things like rating images.
  - `worker_count` integer — How many workers this user has created (active or inactive).
  - `worker_ids` string[]
  - `sharedkey_ids` string[]
  - `monthly_kudos` MonthlyKudos
    - `amount` integer — How much recurring Kudos this user receives monthly.
    - `last_received` string, date-time — Last date this user received monthly Kudos.
  - `trusted` boolean — This user is a trusted member of the AI Horde.
  - `flagged` boolean — (Privileged) This user has been flagged for suspicious activity.
  - `vpn` boolean — (Privileged) This user has been given the VPN role.
  - `service` boolean — This is a service account used by a horde proxy.
  - `education` boolean — This is an education account used schools and universities.
  - `special` boolean — (Privileged) This user has been given the Special role.
  - `suspicious` integer — (Privileged) How much suspicion this user has accumulated.
  - `pseudonymous` boolean — If true, this user has not registered using an oauth service.
  - `contact` string — (Privileged) Contact details for the horde admins to reach the user in case of emergency.
  - `admin_comment` string — (Privileged) Information about this users by the admins
  - `account_age` integer — How many seconds since this account was created.
  - `usage` UsageDetails
    - `megapixelsteps` number — How many megapixelsteps this user has requested.
    - `requests` integer — How many images this user has requested.
  - `contributions` ContributionsDetails
    - `megapixelsteps` number — How many megapixelsteps this user has generated.
    - `fulfillments` integer — How many images this user has generated.
  - `records` UserRecords
    - `usage` UserThingRecords
      - `megapixelsteps` number — How many megapixelsteps this user has generated or requested.
      - `tokens` integer — How many token this user has generated or requested.
    - `contribution` UserThingRecords
      - `megapixelsteps` number — How many megapixelsteps this user has generated or requested.
      - `tokens` integer — How many token this user has generated or requested.
    - `fulfillment` UserAmountRecords
      - `image` integer — How many images this user has generated or requested.
      - `text` integer — How many texts this user has generated or requested.
      - `interrogation` integer — How many texts this user has generated or requested.
    - `request` UserAmountRecords
      - `image` integer — How many images this user has generated or requested.
      - `text` integer — How many texts this user has generated or requested.
      - `interrogation` integer — How many texts this user has generated or requested.

---

[API](https://skmtc.net/haidra-org/apis/ai-horde.md) · [All operations](https://skmtc.net/haidra-org/apis/ai-horde/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/haidra-org/ai-horde/versions/dfeb0bedd935/schema)