---
title: "Get Users"
method: GET
path: "/user/list"
tags: ["Internal User management"]
---

# Get Users

`GET /user/list`

Get a paginated list of users with filtering and sorting options.

Parameters:
    role: Optional[str]
        Filter users by role. Can be one of:
        - proxy_admin
        - proxy_admin_viewer
        - internal_user
        - internal_user_viewer
    user_ids: Optional[str]
        Get list of users by user_ids. Comma separated list of user_ids.
    sso_ids: Optional[str]
        Get list of users by sso_ids. Comma separated list of sso_ids.
    user_email: Optional[str]
        Filter users by partial email match
    team: Optional[str]
        Filter users by team id. Will match if user has this team in their teams array.
    page: int
        The page number to return
    page_size: int
        The number of items per page
    sort_by: Optional[str]
        Column to sort by (e.g. 'user_id', 'user_email', 'created_at', 'spend')
    sort_order: Optional[str]
        Sort order ('asc' or 'desc')

## Query parameters

- `role` string, nullable — Filter users by role
- `user_ids` string, nullable — Get list of users by user_ids
- `sso_user_ids` string, nullable — Get list of users by sso_user_id
- `user_email` string, nullable — Filter users by partial email match
- `team` string, nullable — Filter users by team id
- `page` integer — Page number
- `page_size` integer — Number of items per page
- `sort_by` string, nullable — Column to sort by (e.g. 'user_id', 'user_email', 'created_at', 'spend')
- `sort_order` string — Sort order ('asc' or 'desc')
- `organization_ids` string, nullable — Filter users by organization membership. Comma-separated list of org IDs.

## Response `200`

Successful Response

- UserListResponse — Response model for the user list endpoint
  - `users` LiteLLMUserTableWithKeyCountOutput[], required
    - `user_id` string, required
    - `max_budget` number, nullable
    - `spend` number
    - `model_max_budget` object, nullable
    - `model_spend` object, nullable
    - `user_email` string, nullable
    - `user_alias` string, nullable
    - `models` unknown[]
      - unknown
    - `tpm_limit` integer, nullable
    - `rpm_limit` integer, nullable
    - `user_role` string, nullable
    - `organization_memberships` LiteLLMOrganizationMembershipTable[], nullable
      - `user_id` string, required
      - `organization_id` string, required
      - `user_role` string, nullable
      - `spend` number
      - `budget_id` string, nullable
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `user` unknown
      - `litellm_budget_table` LiteLLMBudgetTable — Represents user-controllable params for a LiteLLM_BudgetTable record
        - `budget_id` string, nullable
        - `soft_budget` number, nullable
        - `max_budget` number, nullable
        - `max_parallel_requests` integer, nullable
        - `tpm_limit` integer, nullable
        - `rpm_limit` integer, nullable
        - `model_max_budget` object, nullable
        - `budget_duration` string, nullable
      - `user_email` string, nullable
    - `teams` string[]
    - `sso_user_id` string, nullable
    - `budget_duration` string, nullable
    - `budget_reset_at` string, date-time, nullable
    - `metadata` object, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `object_permission` LiteLLMObjectPermissionTable — Represents a LiteLLM_ObjectPermissionTable record
      - `object_permission_id` string, required
      - `mcp_servers` string[], nullable
      - `mcp_access_groups` string[], nullable
      - `mcp_tool_permissions` object, nullable
      - `vector_stores` string[], nullable
      - `agents` string[], nullable
      - `agent_access_groups` string[], nullable
    - `key_count` integer
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.net/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sea-lion/litellm-api/revisions/79928a3d37d3/schema)