---
title: "List Site Users"
method: GET
path: "/{site_id}/users"
tags: ["users"]
---

# List Site Users

`GET /{site_id}/users`

DEPRECATED - Get a list of users on the site. Requires a user token with moderator privileges on the site.

## Path parameters

- `site_id` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- UserResultsV2 — A nested results object containing V2 Users, from the legacy V2 API
  - `result` UserResultsV2Result
    - `results` UserV2[]
      - `id` integer — Internal identifier for the user while accessing api.viafoura.co
      - `uuid` string, uuid — Internal identifier for the user while accessing all other APIs
      - `avatar_moderation_status` string — May be "pending_new", "pending_update", "rejected", "approved", or "none"
      - `badge_trusted` integer — If the user has been given the trusted badge. Boolean.
      - `ban_level` 'ghost' | 'hide' | 'posting' | 'login' | 'none' — Severity level of ban
      - `custom_badges` object — May contain custom badges
      - `date_created` integer — Unix timestamp of when the user was created (UTC timezone)
      - `email` string — The user's current email address, if the user has one
      - `email_notice_frequency` integer — The frequency of email notices, either never (0) or immediate (1)
      - `email_pending` string — The user's new email address, pending verification
      - `email_verification_status` string — The verification status of the user's current email address
      - `isNewUser` boolean — Usually false, except when a login call created a new user
      - `name` string — The user's name
      - `personalized_ads` integer — Whether the user has personalized ads enabled
      - `pic_large` string — A 120x120 avatar URL
      - `pic_small` string — A 60x60 avatar URL
      - `processing_status` string — Normally "completed", or "deleted" if GDPR deleted
      - `social_login_id` string — The user's identify provider's id for the user, if not empty
      - `social_login_provider` string — The user's identify provider, if not empty
      - `type` string — Always "user"
      - `user_privilege` 'none' | 'guest' | 'user' | 'moderator' | 'administrator' — Current user privilege
      - `username_pending` string — When user name moderation is enabled, the user's pending name
      - `username_moderation_status` string — One of "pending_new", "pending_update", "rejected", "approved", or "none"
      - `anonymous` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `bad_comments` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `badges` object — Deprecated object. Values of fields always 0.
      - `comments_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `comments_received` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `dislikes_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `dislikes_received` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `fingerprint` string — Deprecated. An unused random string of characters.
      - `last_ip` string — Deprecated. Unused.
      - `likes_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `likes_received` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `picture_comments_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `plain_comments_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `rank_comments_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `rank_comments_received` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `rank_likes_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `rank_likes_received` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `rank_overall` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `rank_subscriber_count` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `rating` number, float — Deprecated field kept for backwards compatibility. Always returns 0.
      - `shares` object — Deprecated object. Always empty.
      - `subscribed` boolean — Deprecated field kept for backwards compatibility.
      - `subscriber_count` integer — Deprecated field kept for backwards compatibility. Always returns 0.
      - `video_comments_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.

---

[API](https://skmtc.net/viafoura/apis/engagement-api.md) · [All operations](https://skmtc.net/viafoura/apis/engagement-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/viafoura/engagement-api/versions/ea12eb6ecdc1/schema)